File path variables

This variable defines your personal Maya application directory. This directory contains your projects and other important items:

• the prefs directory
• the projects directory
• mayaRenderLog.txt
• mayaLog
• mayaJournal
• the scripts directory
• Maya.env, if you choose to create it, can also reside in this directory

You can only set MAYA_APP_DIR from the operating system; you cannot use Maya.env. If you set this variable in the Mac OS X operating system, you must launch Maya from the Terminal window. Otherwise, Maya will not use the set value.

If you do not set the MAYA_APP_DIR variable, the default values are:

• Windows Vista, Windows 7, and Windows 8

  \Users\<username>\Documents\Maya

• Mac OS X

  ~<username>/Library/Preferences/Autodesk/Maya

• Linux (64-bit)

  ~<username>/Maya

This variable enables the cmdFileOutput command during startup so the content in the script editor automatically outputs to a designated file. If no file name is specified, then errors are sent to the standard error output, for example the Terminal window. This feature is useful for tracking down error messages when Maya crashes upon startup.

This variable obtains the paths to the content directories with which you can populate the Examples tab in the Content Browser. Plug-ins can add to this path with their own content directories by adding to the environment variable in their module template files, or by using the assetBrowser -addContentPath flag.

When used with the Attribute Editor: this variable is used to override the directory where custom Attribute Editor templates are found. The default is the scripts\AETemplates folder of the Maya install directory.

When used with the Node Editor: you can customize the list of attributes displayed for each node by creating a custom attribute list template. The next time that you create the same node, Maya searches for an existing template, and if one is found, then your node is displayed with the custom attribute list that you created. You can share these templates with other users on the network by setting this environment variable to the network location at which the custom templates are found. See Customizing the list of node attributes for more information. This environment variable supports multiple paths that can be separated with ; on Windows and : on Mac OS X/Linux.

For use with the Node Editor. You can customize the list of attributes displayed for each node by creating a custom attribute list template. By default, your templates are saved to $MAYA_APP_DIR/<app_ver>/[localized]/prefs/viewTemplates/, but you can override the default location by setting this environment variable to the location that you desire. See Customizing the list of node attributes for more information.

This variable has become obsolete since Maya 3.0. See XBMLANGPATH as this variable should be used instead.

Defines the search paths for Maya module files. A module file describes the install location of a plugin which has been distributed as a module. Maya will append subdirectories of this install location to the following path variables: MAYA_PLUG_IN_PATH, MAYA_PRESET_PATH, MAYA_SCRIPT_PATH, PYTHONPATH and XBMLANGPATH. See the individual descriptions of these variables below and Distributing Maya Plug-ins in the Maya Developer Help for more information.

The following tables list the default paths, which will always follow any path that you specify.

This variable is used to override the directory where movie files are found. The default is $MAYA_LOCATION/movies.

The path for the Maya installation directory. If it is not set, it defaults to /usr/autodesk/MayaVersionNumber (Linux) or C:\Program Files\Autodesk \MayaVersionNumber (Windows).

On Mac OS X, Maya is installed as /Applications/Maya <version>/Maya.app. Since Mac OS X architecture makes it difficult to access the contents of the Maya application package, we strongly discourage the use of MAYA_LOCATION on Mac OS X. Instead, use the following alternate locations:

Search path for plug-ins. When a plug-in is specified by relative path name, the directories in this path are searched for the given plug-in name. This path also determines which directories are listed in the Plug-in Manager. In addition, for each module file found by Maya on startup, the plug-ins subdirectory of the module's root directory will be added to MAYA_PLUG_IN_PATH. See the description of the MAYA_MODULE_PATH variable above and Distributing Multi-File Modules in the Maya Developer Help for more information.

Defines the location for Maya presets. Each entry in the path points to the directory above the attrPresets directory. In addition, for each module file found by Maya on startup, the 'presets' subdirectory of the module's root directory will be added to MAYA_PRESET_PATH. See the description of the MAYA_MODULE_PATH variable above and Distributing Multi-File Modules in the Maya Developer Help for more information.

Specifies the location of your project folder on startup.

In the Preferences window, under File/Projects > Project Settings, the folder location is displayed as Always start in this project. After setting the variable, you cannot change the location of the project folder from the Preferences window. You must either change or remove the variable.

Specifies the location of your project folder.

In the Preferences window, under File/Projects > Project Settings, the folder location is displayed as Default projects directory. After setting the variable, you cannot change the location of the project folder from the Preferences window. You must either change or remove the variable.

Specifies the directories that Maya searches to access the shelves. You can store shelves in a location accessible by different groups who then set the MAYA_SHELF_PATH variable for their workstation.

You can specify more than one directory using MAYA_SHELF_PATH, separated by colons; for example, Production/shelf:Shot/shelf:MyDir/shelf specifies three different shelf directories. At startup, Maya searches each directory in the order specified to instantiate shelves. After searching the directories specified in MAYA_SHELF_PATH, Maya continues to add shelves from the default shelf directory. Once a shelf exists, a shelf with the same name in the subsequent searched directories is ignored.

When a new shelf is created, it is always saved in the default shelf directory. To share it, move it to the desired directory (that is, one of the ones specified by MAYA_SHELF_PATH).

To restrict access to a shelf directory, disable the write permission of that directory. A warning appears when a user attempts to write into a restricted shelf directory (while exiting or saving all shelves).

Colon-separated search path for MEL scripts. If an unresolved MEL procedure is called, then this path will be searched for a script that implements it. Also, if a MEL file is sourced without giving the full path, then this path will be searched.

In addition, for each module file found by Maya on startup, the scripts subdirectory of the module's root directory is added to MAYA_SCRIPT_PATH. See the description of the MAYA_MODULE_PATH variable above and Distributing Multi-File Modules in the Maya Developer Help for more information.

Specifies the directories that Maya searches for ToolClip content.

You can specify more than one directory using MAYA_TOOLCLIPS_PATH, separated by colons; for example, <drive:>\<path>;<drive2:>\<path2> specifies two different ToolClip directories. At startup, Maya searches each directory in the order specified. After searching the directories specified in MAYA_TOOLCLIPS_PATH, Maya continues to search the default user.toolclips directory and then the builtin.toolclips directory.

If a key name exists in two ToolClip.xml files within the ToolClip search path, Maya uses the key name that is encountered first.

Location for your Python module files when you import them in a program. Set this variable to the list of directory names for your module directories. Separate this list by colons for UNIX and semicolons for Windows.

In addition, for each module file found by Maya on startup, the the scripts subdirectory of the module's root directory will be added to PYTHONPATH. See the description of the MAYA_MODULE_PATH variable above and Distributing Multi-File Modules in the Maya Developer Help for more information.

Use of this variable is not mandatory. Because Python always searches the home directory of the program’s top level file, you only need to set this environment variable if one of your modules needs to import another module that resides in a different directory.

This variable specifies the directory location Maya uses for various temporary files, such as:

• temporary render cache files during a render
• crash files if Maya crashes

On Mac OS X and Linux, set TMPDIR only. On Windows, set both TEMP and TMPDIR.

If not set, the temporary directory is:

• /tmp (Linux)
• C:/temp (Windows), or under your Home folder in Documents/temp
• /var/folders/xx/xxx/T, where xx and xxx can be any combination of characters. (Mac OS X)

  Alternatively, you can run the env command in your terminal window to return a list of all environment variables set and their corresponding values.

This variable specifies the location of icon files, such as icons used for Shelf buttons. On Linux, the syntax is slightly different then other paths. For example:

XBMLANGPATH = "./icons/%B:$HOME/dev/icons/%B"

In this example, %B is acts as a placeholder that will be replaced by Maya with the bitmap filename.

In addition, for each module file found by Maya on startup, the icons subdirectory of the module's root directory ('icons/%B on Linux) will be added to XBMLANGPATH. See the description of the MAYA_MODULE_PATH variable above and Distributing Multi-File Modules in the Maya Developer Help for more information.

The following table lists the default paths, which will always follow any path that you specify.