KE_MayaFileBrowser 1.4.0

Maya's Linux file browser has always been rather limited. It has no bookmarks, it can't autocomplete, and (my personal favourite) it doesn't display image previews when you're loading in textures. Loading or saving MEL scripts from the script editor has been known to reduce grown men to tears. So, using the magic of MEL, I replaced it with something a bit more capable :)

REQUIREMENTS

- kdialog or zenity must be installed
- Maya 8.5 or higher; whilst earlier versions might work, they are untested.
- bash and netcat (or "nc"); these are standard utilities present on Linux since, like, forever... :)

HOW TO INSTALL THIS SET OF SCRIPTS; PLEASE READ CAREFULLY!

1) Using your favourite Linux package manager, make sure that you have "kdialog" installed if you want to use the KDE file browser, or "zenity" installed if you want to use the Gnome file browser. To check if you have kdialog installed, run "which kdialog" from the shell, or "which zenity" for zenity - if it prints a path to your screen, then it's already installed on your system. If it doesn't print anything out, then get installing...

2) Download the zip file. Extract all .mel and .sh files from this zip file to your scripts folder ($HOME/maya/(maya version)/scripts/).

3) Create the file $HOME/maya/(maya version)/scripts/userSetup.mel if it doesn't already exist, and then using a text editor, paste the following two lines into it and save it:

KE_ScriptEditor();
KE_FileBrowser();

4) Restart Maya; check the script editor for errors. If nothing went wrong and no errors appeared, a new toggle item should appear in your File menu named "External File Browser", which is on by default. Switching it off will make Maya use the old MEL-based dialog, keeping it on will make Maya use kdialog if you're using KDE, and zenity if you're using Gnome. The option box next to it will open a dialog to let you configure whether you use kdialog or zenity, or just whatever's default on your desktop. This new improved file browser will also be used automatically by the script editor, the attribute editor, the render view, and pretty much anywhere else in Maya that uses the file browser.

HOT TIPS

- When using the KDE file dialog, press F10 to open an image preview window
- Right click on the side-bar on the left hand side of the file browser window to add/remove bookmarks

A NOTE FOR SYSADMINS AND TDS

I realise that installing a copy of these shell scripts and MEL scripts in the local scripts folder for every user in a company is impractical. The MEL scripts can in fact be put anywhere in the MAYA_SCRIPT_PATH (like any MEL script really), just make sure that you modify your userSetup.mel to include the required lines mentioned above. The shell script "KE_FileBrowserWrapper.sh" normally has to go in the "$HOME/maya/(maya version)/scripts/" folder; however you can put it anywhere you like as long as you set the environment variable KE_FILEBROWSER_WRAPPER to point to its new location - the file browser code will try to use that instead.

An example .cshrc line would be:
setenv KE_FILEBROWSER_WRAPPER "/usr/scripts/KE_FileBrowserWrapper.sh"

And an example .bashrc line:
export KE_FILEBROWSER_WRAPPER="/usr/scripts/KE_FileBrowserWrapper.sh"

VERSION HISTORY

- 1.4; Additional bugfix for Ubuntu. Removed error suppression from the shell script to help users with installation issues. Bugfixes for KDE4; KDE4 is now supported. 64-bit Linux distros are also now supported.

- 1.3; Fix for incompatibility with menus in Maya 2009; Maya 2009 is now supported.

- 1.2; Bugfix for distros with Qt libraries in non-standard locations, and a bugfix for older, less capable versions of Zenity (thanks Ivan!)

- 1.1; Bugfix for broken shells that ignore the #!/bin/bash shebang and try to use /bin/sh instead
(thanks Simon!). Also added a new config dialog in the file menu to allow users to force kdialog on Gnome, or zenity on KDE.

- 1.0; Initial public release.

Questions? Bug reports? Comments? I always like to hear feedback via email. Hope this proves useful, happy animating! :)