File path variables
 
 
 
MAYA_APP_DIR (Windows and Linux)

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

You can only set MAYA_APP_DIR from the operating system; you cannot use Maya.env. If you do not set it, the default values are: ~username/maya (Linux) or drive:\Documents and Settings\username\My Documents\maya (Windows).

For Mac OS X, you cannot set environment variables from the operating system.

MAYA_CMD_FILE_OUTPUT

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.

NoteThe content in the Script Editor displays in both the Script Editor and the designated output location.
MAYA_FILE_ICON_PATH

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

MAYA_MODULE_PATH

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-insfor more information.

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

Default for Windows Default for Mac OS X, Linux
<user’s directory>/My Documents/maya/2010/modules<user’s directory>/My Documents/maya/modulesC:/Program Files/Common Files/Autodesk Shared/Modules/maya/2010

C:/Program Files/Common Files/Autodesk Shared/Modules/maya

<maya_directory>/modules/

$MAYA_APP_DIR/maya/2010/modules $MAYA_APP_DIR/maya/modules /usr/autodesk/modules/maya/2010 /usr/autodesk/modules/maya

NoteIf you use spaces in a file path that you create, you may have problems accessing icon image files stored within that directory, because the file path does not appear in Maya. You can avoid this problem by only specifying file paths that do not include spaces.
MAYA_MOVIE_DIR

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

MAYA_LOCATION

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 2010/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:

MAYA_PLUG_IN_PATH

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.

Default for Windows Default for Linux Default for Mac OS X

<user’s directory>/My Documents/maya/2010/plug-ins

<user’s directory>/My Documents/maya/plug-ins

<maya_directory>/bin/plug-ins

$MAYA_APP_DIR/maya/2010/plug-ins

$MAYA_APP_DIR/maya/plug-ins

/usr/autodesk/userconfig/maya/2010/plug-ins

/usr/autodesk/userconfig/maya/plug-ins

$MAYA_LOCATION/bin/plug-ins

In your Home folder, under Library/Preferences/Autodesk/maya/2010

In your Home folder, under Library/Preferences/Autodesk/maya

/Users/Shared/Autodesk/maya/2010

/Users/Shared/Autodesk/maya

Inside the Maya package in /Applications/Maya 2010/Maya.app

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 Modulesfor more information.

NoteWhen you are adding multiple paths to the MAYA_PLUG_IN_PATH environment variable, the paths must be separated by : (colon) on Mac OS X and ; (semi-colon) on Windows and Linux.
MAYA_PRESET_PATH

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 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 for more information.

MAYA_PROJECT

Defines the default location of your project. You can change the location with the commands in the File > Project.submenu. This variable simply defines the default.

MAYA_SHELF_PATH

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).

MAYA_SCRIPT_PATH

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. The following table lists the default paths, which will always follow any path that you specify.

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

PYTHONPATH

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.

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.

In addition, for each module file found by Maya on startup, 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 Modulesfor more information.

Default for Windows Default for Linux Default for Mac OS X

<user’s directory>/My Documents/maya/projects/default/mel

<user’s directory>/My Documents/maya/2010/scripts

<user’s directory>/My Documents/maya/scripts

<user’s directory>/My Documents/maya/2010/presets

<user’s directory>/My Documents/maya/2010/prefs/shelves

<user’s directory>/My Documents/maya/2010/prefs/markingMenus

<maya_directory>/scripts/startup

<maya_directory>/scripts/others

<maya_directory>/scripts/AETemplates

<maya_directory>/scripts/paintEffects

<maya_directory>/scripts/fluidEffects

<maya_directory>/scripts/hair

<maya_directory>/scripts/cloth

<maya_directory>/scripts/fur

$MAYA_APP_DIR/maya/2010/scripts

$MAYA_APP_DIR/maya/scripts

/usr/autodesk/userconfig/maya/2010/scripts

/usr/autodesk/userconfig/maya/scripts

$MAYA_APP_DIR/maya/2010/prefs/shelves

$MAYA_LOCATION/scripts/startup

$MAYA_LOCATION/scripts/others

$MAYA_LOCATION/scripts/AETemplates

$MAYA_LOCATION/scripts/paintEffects

$MAYA_LOCATION/scripts/cloth

$MAYA_LOCATION/scripts/fur

In your Home folder, under Library/Preferences/Autodesk/maya/2010

In your Home folder, under Library/Preferences/Autodesk/maya

/Users/Shared/Autodesk/maya/2010

/Users/Shared/Autodesk/maya

Inside the Maya package in /Applications/Autodesk/Maya 2010/Maya.app

TEMP or TMPDIR

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 Linux, set TMPDIR only. On Windows, set both TEMP and TMPDIR. If not set, the temporary directory is /tmp (Linux), or C:/temp (Windows), or under your Home folder in Documents/temp.

XBMLANGPATH

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 Linus) will be added to XBMLANGPATH. See the description of the MAYA_MODULE_PATH variable above and Distributing Multi-File Modulesfor more information.

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

Default for Windows Default for Linux Default for Mac OS X

%MAYA_APP_DIR%\maya\2010\prefs\icons%MAYA_APP_DIR%\maya\prefs\icons

%MAYA_LOCATION%\icons

%MAYA_LOCATION%\icons \paintEffects

%MAYA_LOCATION%\icons \cloth

%MAYA_LOCATION%\icons \fur

$MAYA_APP_DIR/maya/2010/prefs/icons/%B

$MAYA_APP_DIR/maya/prefs/icons/%B

/usr/autodesk/userconfig/maya/2010/icons/%B

/usr/autodesk/userconfig/maya/icons/%B

$MAYA_LOCATION/icons/%B

$MAYA_LOCATION/icons/paintEffects/%B

$MAYA_LOCATION/icons/cloth/%B

$MAYA_LOCATION/icons/fur/%B

In your Home folder, in Library/Preferences/Autodesk/maya/2010/prefs/icons

In your Home folder, in Library/Preferences/Autodesk/maya/prefs/icons

/Users/Shared/Autodesk/maya/2010/icons

/Users/Shared/Autodesk/maya/icons

Inside the Maya package in /Applications/Autodesk/Maya 2010/Maya.app

MAYA_MR_STARTUP_DIR

This variable can be used to specify the location of the maya.rayrc file.