﻿---
title: License and preferences
description: The Deformable Preferences window in Maya, the license status, Free and its limit, signing in with a Standalone subscription, activating and deactivating a license key, the mesh check and frame cache settings, the help items, and updating the plugin.
url: https://help.tangerina.io/deformable/v0.8.0/user-guides/maya/license-and-preferences/
---

# License and preferences – Maya Plugin – Deformable v0.8.0

The plugin keeps its settings in the **Deformable Preferences** window. There you see your license, sign in with a
subscription or activate a license key, turn the mesh check on or off, set how much memory the frame cache takes, open
this guide, and copy what a support email needs.

To open it, choose **Deformable Scene > Preferences…** or **Deformable Help > License…**.

## License status

The window's **License** section starts with the status, beside an icon:

| Status | What it means |
|---|---|
| **Free: up to 2,500 tetrahedrons per scene** | No subscription or license key is active. Every feature works, and a Deformable Scene simulates up to 2,500 tetrahedrons. |
| **Standalone subscription** | This device is signed in and uses your Standalone subscription. There is no limit. |
| **Standalone subscription — Connect to the internet within 5 hours** | The subscription works, but the device has not checked in for more than 18 hours. Connect to the internet. |
| **Connect to the internet to check your Standalone subscription** | The device went a day without a check-in, or the clock was set back. Connect to the internet and click **Check Now**. |
| **Your subscription is in use on** a device's name, or **Every seat of your subscription is in use** | Another device uses the subscription's seat. See [Use it here instead](#use-it-here-instead). |
| **Your subscription is now in use on** a device's name | Another device took the seat with **Use It Here Instead**. Click **Use It Here Instead** to take it back. |
| **This device was removed from your subscription** | This device was removed on the subscription's page. Click **Check Now** or **Use It Here Instead** to use the seat again. |
| **This account has no active Standalone subscription — Subscribe** | The account you signed in with has no subscription to Deformable, or it ended. Click **Subscribe**, or, when its payment failed, **Manage Subscription** to change its card; then click **Check Now**. |
| **Your sign-in ended: sign in again to use your Standalone subscription** | The sign-in went 7 days without a check-in, or it was ended on the platform. Click **Sign In**. |
| **Standalone license** | A Standalone license key is active on this device. There is no limit. |
| **Connect to the internet to renew your Standalone license** | The license went 7 days without a renewal, or the clock was set back. Connect to the internet and click **Check Now**. |

Below the status, the section shows:

- **Meanwhile, Deformable runs as Free: up to 2,500 tetrahedrons per scene** while the status asks you to do
  something, as in the statuses after **Standalone subscription** above: the subscription or the license does not
  apply until you do it.
- **Signed in as** and your account's email while a subscription is signed in.
- The code and **Open Browser**, **Copy Code** and **Cancel** while you sign in. See
  [Sign in with a subscription](#sign-in-with-a-subscription). In Free, they show under **Subscription**, below the
  greyed-out **Sign In**.
- **Contacting the licensing service…** while the plugin checks in, signs in or out, activates or deactivates. When
  that fails, the section shows why, such as **This license key does not exist**.
  [Status messages](https://help.tangerina.io/deformable/v0.8.0/licensing/#status-messages) lists every message and what to do.
- A divider, then the buttons of the status:

| Status | Buttons |
|---|---|
| Free | Two groups, with a divider between them. **Subscription**: **Sign In**; **Subscribe** and **Manage Subscription**. **License Key**: the license key field and **Activate**; **Buy License** and **Manage Licenses**. While the sign-in code shows, **License Key** is hidden. |
| Standalone subscription | **Sign Out**; **Manage Subscription** |
| Connect to the internet to check your Standalone subscription | **Check Now** and **Sign Out**; **Manage Subscription** |
| In use on another device, or removed from your subscription | **Use It Here Instead**, **Check Now** and **Sign Out**; **Manage Subscription** |
| No active Standalone subscription | **Check Now** and **Sign Out**; **Subscribe** and **Manage Subscription** |
| Your sign-in ended | **Sign In** and **Sign Out**; **Manage Subscription** |
| Standalone license | **Deactivate**; **Manage Licenses** |
| Connect to the internet to renew your Standalone license | **Deactivate** and **Check Now**; **Manage Licenses** |

**Check Now** contacts our licensing service right away and checks in the subscription or renews the license.
**Subscribe** opens the [subscribe page](https://platform.tangerina.io/subscriptions/subscribe?product=1), where you
choose monthly or yearly and pay; an account that already subscribes is sent to its subscription.
**Manage Subscription** opens the [Subscriptions page](https://platform.tangerina.io/subscriptions), where you open your
subscription to see its devices, cancel it or change its card. **Buy License** opens **Buy Standalone license** on the
Licenses page. **Manage Licenses** opens the [Licenses page](https://platform.tangerina.io/licenses), where you open a
license to copy its key and see the devices that use its seats. Under a Standalone license, the section also shows
**Sign Out** when a subscription is signed in on the same device: the license applies, and **Sign Out** frees the
subscription.

The Maya plugin is always allowed online. Maya has no setting that keeps a plugin offline, so the plugin has none
either: with a subscription or a license key, it contacts our licensing service when it loads in Maya's window and
whenever the subscription or the license needs it, and only then. On Free it contacts nothing.

The subscription and the license belong to the device, not to the plugin: one Standalone subscription or license
covers the Blender plugin and the Maya plugin, and the C, Rust and Python SDKs, on the same device. A subscription
signed in or a license activated in the Blender plugin or from an SDK shows here too. An Application license key does
not work in the plugin: **Activate** refuses it with **Application licenses work in the SDKs only: the plugins need a
Standalone license**. The subscription, the licenses, their prices and the buying steps are on
[Licensing](https://help.tangerina.io/deformable/v0.8.0/licensing/).

## Free

Without a subscription or a license key, the plugin runs as Free, forever: every feature works, and a Deformable Scene
simulates up to 2,500 tetrahedrons. It needs no account and no internet, and the plugin sends nothing.

Every object in the scene counts, floors included, but an object that is disabled: it takes no part in the
simulation. Each create action names its object with its count and the scene's total, disabled objects included, such
as **Deformable: Created pPlane1: 6 tetrahedrons; scene total 198**.

A bigger Deformable Scene says so, as a warning, when a create action makes it too big, at the start frame and when
you play, such as **Deformable: Created pSphere2: 836 tetrahedrons; scene total 3,120. Free: the scene would simulate
3,120 tetrahedrons; the limit is 2,500 per scene**. When you play it, the plugin stops the playback and shows the limit
in a dialog, with **Subscribe**, **Buy License**, **Preferences** and **Close**. The objects that do not fit stay still,
and the rest of the scene runs. To simulate the whole scene, use fewer tetrahedrons, for example with a lower
**Target Face Count** on the object's Deformable Autocage or a simpler cage, split the objects between two Deformable
Scenes, or subscribe or buy a license. See
[Use fewer tetrahedrons](https://help.tangerina.io/deformable/v0.8.0/user-guides/engine/preparing-meshes/#use-fewer-tetrahedrons).

## Sign in with a subscription

The Standalone subscription is $14 per month or $79 per year, on 1 device, with no limit, and includes email support
at [support@tangerina.io](mailto:support@tangerina.io). Click **Subscribe** to open the
[subscribe page](https://platform.tangerina.io/subscriptions/subscribe?product=1), sign in or create an account, choose
monthly or yearly, and pay. It has no key: you sign in from the plugin.

1. Choose **Deformable Help > License…**.
2. Click **Sign In** in the **License** section. The section shows a code, such as **Your code: ABCD-EFGH**, with
   **Approve it in your browser within 10 minutes**, and your browser opens the platform's sign-in page with the code
   filled in. If it does not, click **Open Browser**. To approve in another browser, click **Copy Code**, open
   [platform.tangerina.io/device](https://platform.tangerina.io/device) there and paste the code.
3. In the browser, sign in to your account if it asks, check that the page shows the same code, type your password
   (and a code from your authenticator app when two-factor authentication is on), and click **Approve**.
4. The section shows **Standalone subscription** and **Signed in as** your email, and the tetrahedron limit is gone.

Click **Cancel** to stop waiting. If you click **Deny** in the browser, the section says **The sign-in was denied:
check your account on the platform, then sign in again**. Signing in needs the internet. While a Standalone license
is active, **Sign In** is hidden: deactivate it first to sign in instead.

The objects that the limit held still simulate again by themselves.

After that, the plugin checks in with our licensing service when Maya loads it and every hour while it is loaded, and
the engine checks in every few hours while you use it. Each check-in lets the subscription run 1 day offline. From 6
hours before that day runs out, the status counts down, such as **Standalone subscription — Connect to the internet
within 5 hours**. After a day offline, it shows **Connect to the internet to check your Standalone subscription** and
the plugin runs as Free, with its limit, until you connect and click **Check Now**. After 7 days without a check-in,
the sign-in ends: click **Sign In** again.

## Use it here instead

A Standalone subscription works on 1 device at a time. When another device uses it, the status shows **Your
subscription is in use on** followed by that device's name, and the plugin runs as Free. To use the subscription on
this device:

- Click **Use It Here Instead**. The seat moves to this device at once, and the section shows **Standalone
  subscription**. The other device learns it at its next check-in, within an hour while its plugin is loaded and
  within a day if it is offline, and shows **Your subscription is now in use on** followed by this device's name.
- Or click **Sign Out** on the other device first, then **Check Now** here. That takes the free seat without taking it
  from anyone.

A lost or dead device frees its seat by itself after a day without a check-in. To free it at once, click **Manage
Subscription**, open your subscription, and click **Remove** beside the device.

## Sign out

Click **Sign Out**. The plugin forgets the sign-in at once, even offline, and runs as Free. When the device is online,
it also frees the seat. Offline, the seat frees itself within a day, and the section shows **Signed out on this
device, but its seat could not be freed: it frees itself within a day**. Signing out here also signs out the Blender
plugin and the SDKs on this device.

To stop paying, click **Manage Subscription**, open your subscription, and cancel it there. Cancelling and refunds are
on [Licensing](https://help.tangerina.io/deformable/v0.8.0/licensing/#cancel-and-refunds).

## Buy a license

Click **Buy License** in the Deformable Preferences window. Your browser opens **Buy Standalone license** on the
[Licenses page](https://platform.tangerina.io/licenses): sign in, or create an account first. Choose the number of
seats, one per device, and pay. The license page then shows your key: copy it.

The Standalone license is $99 per seat, one time: you pay once. It is perpetual, covers all future versions
(every update is included), covers the Blender and Maya plugins and the C, Rust and Python SDKs, and includes email
support at [support@tangerina.io](mailto:support@tangerina.io).

## Activate a license

1. Choose **Deformable Help > License…**.
2. Paste your license key into the key field of the **License** section.
3. Make sure the device is online, and click **Activate**.

The section shows **Contacting the licensing service…**, then **Standalone license**, and the tetrahedron limit is gone.
The plugin clears the field: the engine keeps the key. Activation needs internet one time. If it fails, the section
shows why, such as **Every seat of this license is in use: remove a device on the Licenses page, or buy another
license**. With an empty field, **Activate** says **Paste the license key from the Licenses page first**. While a
subscription is signed in, the field is hidden: sign out first to use a key instead.

The objects that the limit held still simulate again by themselves.

After that, the plugin works offline between renewals. While you use it on a device that is online, it renews the
license quietly, a few times a day at most, and checks each time Maya loads it. Each renewal lets it run 7 days
offline. After 7 days offline, it shows **Connect to the internet to renew your Standalone license** and the plugin
runs as Free, with its limit, until you connect and click **Check Now**.

## Deactivate a license

A Standalone license runs on 1 device per seat. To move a seat to another device, deactivate it on this one first:

1. Choose **Deformable Help > License…**.
2. Click **Deactivate**.
3. On the new device, install the plugin, then
   [activate](https://help.tangerina.io/deformable/v0.8.0/user-guides/maya/license-and-preferences/#activate-a-license) the same key.

![The same license key moving from the old device, where it is deactivated first, to the new device, where it is activated.](../../images/license-move-to-new-device.svg "Deactivate the license on the old device first, then activate the same key on the new device.")

Deactivating here also deactivates the Blender plugin and the SDKs on this device. The plugin forgets the license at
once, even offline, and the plugin runs as Free. Offline, the seat stays taken, and the section shows **Deactivated on
this device, but its seat could not be freed: remove this device on the Licenses page**.

If you no longer have the old device, click **Manage Licenses**, open the license, click **Remove** beside the old
device, then **Remove device**. Lost keys and refunds are on [Licensing](https://help.tangerina.io/deformable/v0.8.0/licensing/).

## Preferences

The **Settings** section of the window holds:

| Preference | Default | What it does |
|---|---|---|
| Verify Meshes Before Creating Objects | On | Refuse a mesh that is not clean and closed when you create a deformable object. |
| Frame Cache Limit | 2 GB per scene | The memory each Deformable Scene keeps its simulated frames in. Past it, new frames are not kept. See [Frame Cache Limit](https://help.tangerina.io/deformable/v0.8.0/user-guides/maya/playback-and-baking/#frame-cache-limit). |

Maya keeps them in your preferences, between sessions.

With **Verify Meshes Before Creating Objects** on, every create action checks each mesh first, and so does **Add
Surface Mesh to Object** with **Breakable** on. A mesh with problems is refused, and the warning names them, such as
**Not verified: pSphere1: non closed boundary (84), co located vertices (2), non planar (104)**.

Turn it off to create objects from meshes with small problems that do not matter for your shot, such as a model with
separate eyes. The tools may then still fail on the mesh, and the node shows why. To find and fix the problems
instead, see [Verify Mesh](https://help.tangerina.io/deformable/v0.8.0/user-guides/maya/creating-objects/#verify-mesh).

With the preference off, the create actions still refuse an object with a mirrored or flat transform, such as a
negative scale. See
[Mesh checks before creating](https://help.tangerina.io/deformable/v0.8.0/user-guides/maya/creating-objects/#mesh-checks-before-creating).

## Help

The bottom of the window has two buttons:

- **Documentation** opens this user guide in your browser.
- **Copy Support Info** copies the Maya version, the operating system, the plugin and library versions and the
  license status. Paste it into your email to [support@tangerina.io](mailto:support@tangerina.io). The plugin then
  says **Copied the support info: paste it into your email**.

The **Deformable Help** menu has the same and more:

| Item | What it does |
|---|---|
| User Guide | Opens this user guide. |
| Scripting Reference | Opens [Command line and scripting](https://help.tangerina.io/deformable/v0.8.0/user-guides/maya/command-line-and-scripting/). |
| Copy Support Info | As the button above. In `mayapy`, it prints the lines instead. |
| About Deformable | Shows the plugin, library and Maya versions and the system. |
| License… | Opens the Deformable Preferences window. |

The pages of this guide also open from the plugin's windows: an option window's **Help** menu opens the page of its
action, and the Attribute Editor's **Help** menu, on a Deformable node, opens the page of its node type.

## Update the plugin

To install a new version:

1. Download the `.zip` file for your system from [tangerina.io/deformable](https://tangerina.io/deformable#download-maya).
2. Quit Maya.
3. In your modules folder, delete `deformable.mod` and the `deformable` folder, and unzip the new version in their
   place, as in [Install the plugin](https://help.tangerina.io/deformable/v0.8.0/user-guides/maya/getting-started/#install-the-plugin). On a Mac, clear
   the download's mark again.
4. Start Maya. The plugin loads by itself while **Auto load** is on.

A running Maya keeps the version it loaded, so always quit Maya first. The plugin rebuilds its shelf each time it
loads, so the shelf always matches the version.

To remove the plugin, choose **File > New Scene**, turn off **Loaded** and **Auto load** in **Windows >
Settings/Preferences > Plug-in Manager**, quit Maya, and delete `deformable.mod` and the `deformable` folder. Your
sign-in or license stays on the device.
