A newer version of Max is available. Click here to access the latest version of this document.
Search Paths in Standalones
A standalone application you create with Max searches for files in a slightly different order than that used in the Max search path when you’re editing patches. If you want to include non-standard Max objects or other types of files, you’ll need to understand how search paths and File Preferences work in standalone applications.
In a standalone application, here is the order in which folders in the standalone package (Macintosh) or folder (Windows) will be searched:
1. The collective file (and any other open collective files)
2. The support folder
You can add additional locations to this list by checking the Utilize Search Path option in the standalone object's Inspector.
On Macintosh systems, checking the Utilize Search Path option, does the following for the search path of a standalone:
On Windows systems, checking the Utilize Search Path option, does the following for the search path of a standalone:
You can use the Utilize Search Path option to aid in testing your standalone application.
If some of the supporting files used by Max/MSP objects in your patch will not be included in the collective itself, check the Search for Files Not in the Application's Collective option. (It is checked by default.) Unchecking this option can be useful for ensuring that you have included all necessary files in the collective that you are making into a standalone application. If you create your application with this option turned off, your application will not look outside the collective for any files it cannot find, such as missing sequences or coll files that your application attempts to load. So, you can make your application with Search for Files Not in the Application's Collective unchecked, and then run it to see if it works properly. If your application is unable to find a file that it needs, you will get an error message to that effect, and you will know that you have to rebuild your standalone application. In some cases, however, you may want your application to look for a file outside of the collective. For example, you may want it to look for a MIDI file that can be supplied by the user of your application. In that case, you will naturally want the Search for Files Not in the Application's Collective option to be on. Please also note that this feature restricts itself to looking in folders nested only three levels deep.
When your application searches for files outside the collective, you can control where it looks with the Utilize Search Path in Preferences File option. If this option is on (which it is by default), your application will use the search path settings stored in the Max 4 Preferences file instead of using the default search path. You can instruct your application to use its own Preferences file instead of the default Max 4 Preferences by supplying a preferences file name in this field. If the Utilize Search Path in Preferences File is checked and you type in a name other than the default Max 4 Preferences, your application will make its own unique preferences file (in ~/Library/Preferences, where ~ represents your home directory) the first time it is run. From then on, your application will use that preferences file to recall the settings for options such as Overdrive or All Windows Active.
Testing your standalone

Checking the current file paths in use

On Macintosh systems, the Finder uses a four-character ID to distinguish one application from another, including Max and MaxMSP Runtime. When you create a standalone, a default generic creator (????) is assigned to the application automatically. Can use the standalone object Inspector to change this to a unique ID.