Reference

Settings

I/O

  • binary — If set for a file, file browser will open it with external program when double clicked. Mainly makes sense when targetting specific globs.
  • encoding — Set to the file’s encoding. This will be used during save but is also fallback during load (when file is not UTF-8). Load encodinng heuristic is likely going to change. The value for the encoding must be one of the libiconv codes (e.g., for "Windows - Western", use "CP1252").
  • fileType — The file type given as scope, e.g. text.plain.
  • useBOM — Used during save to add BOM (for those who insist on putting BOMs in their UTF-8 files).

Display

  • theme — UUID of theme, presently unused but will be back, and should allow name of theme as well (use _View → Themes_ to change theme — remember to install the Themes bundle).
  • fontName, fontSize — Name and size of font, e.g. Menlo and 13. Presently these two keys are required to override font, but there will be a font option in the _View_ menu, so this is only for special requirements.
  • showInvisibles — Sets the initial value. Can also be changed via View menu.
  • softTabs, tabSize — Presently can only be changed this way, but there should be some memory added to TextMate.
  • spellChecking, spellingLanguage — Enable/disable spelling and set language. (See below for spellingLanguage values.)

Projects

  • projectDirectory — the project directory, generally set to $CWD in a .tm_properties file at the root of the project. This affects TM_PROJECT_DIRECTORY and default folder for ⇧⌘F.
  • windowTitle — override the window title. The default is $TM_DISPLAYNAME but could e.g. be changed to $TM_FILEPATH. Should add a $TM_SCM_BRANCH.

Other

  • scopeAttributes — The value is added to the scope of the current file.

File Filtering Keys

These are all globs and perhaps a bit arcane.

The file browser, if it has a file, checks that file against the first key with a value in this order: excludeFilesInBrowser, excludeInBrowser, excludeFiles, exclude. If neither match, it then does the same with include keys, and if one match, it is included. Directories work the same, except using the Directories

  • InFileChooser is "Go -> Go To File... ⌘T"
  • InBrowser is the sidebar.
  • InFolderSearch is "Edit -> Find -> Find in Project ⇧⌘F"

The default include key is * (so no hidden files, although see the default .tm_properties which include .htaccess and .tm_properties). The default exclude key is the empty string (nothing matches).

  • exclude
  • excludeFiles
  • excludeDirectories
  • excludeInBrowser
  • excludeInFolderSearch
  • excludeInFileChooser
  • excludeFilesInBrowser
  • excludeDirectoriesInBrowser
  • include
  • includeFiles
  • includeDirectories
  • includeInBrowser
  • includeInFileChooser
  • includeFilesInBrowser
  • includeDirectoriesInBrowser
  • includeFilesInFileChooser

spellingLanguage Values

These values depend on which dictionaries you have installed so not all may be available. (You can see a list of what is available from the Edit → Spelling menu.)

en → English
en_AU → English (Australia)
en_GB → English (United Kingdom)
en_CA → English (Canada)
da → Danish
fr → French
de → German
es → Spanish
it → Italian
pt → Portuguese
pt_BR → Portuguese (Brazil)
nl → Dutch
sv → Swedish
ru → Russian
pl_PL → Polish (Poland)