|Developer(s)||Allan Odgaard (MacroMates), Ciarán Walsh|
|Initial release||5 October 2004|
2.0.23 / 12 October 2021
|Type||Source code editor|
TextMate is a general-purpose GUI text editor for macOS created by Allan Odgaard. TextMate features declarative customizations, tabs for open documents, recordable macros, folding sections, snippets, shell integration, and an extensible bundle system.
TextMate 1.0 was released on 5 October 2004, after 5 months of development, followed by version 1.0.1 on 21 October 2004. The release focused on implementing a small feature set well, and did not have a preference window or a toolbar, didn't integrate FTP, and had no options for printing. At first only a small number of programming languages were supported, as only a few “language bundles” had been created. Even so, some developers found this early and incomplete version of TextMate a welcome change to a market that was considered stagnated by the decade-long dominance of BBEdit.
TextMate 1.0.2 came out on 10 December 2004. In the series of TextMate 1.1 betas, TextMate gained features: a preferences window with a GUI for creating and editing themes; a status bar with a symbol list; menus for choosing language and tab settings, and a “bundle editor” for editing language-specific customizations. On 6 January 2006, Odgaard released TextMate 1.5, the first “stable release” since 1.0.2. Reviews were positive, in contrast to earlier versions that had been criticised.
TextMate continued to develop through mid-2006. On 8 August 2006, TextMate was awarded the Apple Design Award for Best Developer Tool, at Apple's Worldwide Developers Conference in San Francisco, California, to “raucous applause.” In February 2006, the TextMate blog expressed intentions for future directions, including improved project management, with a plug-in system to support remote file systems such as FTP, and revision control systems such as Subversion. Throughout 2007, the core application changed only minimally, though its “language bundles” continued to advance.
In June 2009, TextMate 2 was announced as being about 90 percent complete, but with an undisclosed final-feature list. A public alpha was made available for download on the TextMate blog in December 2011, followed by a release candidate at the end of 2016. In September 2019, a final version was released.
In August 2012, TextMate 2's source code was published on GitHub under the terms of GPL-3.0-or-later, an attempt by the developer to counteract restrictions Apple placed on software distributed through the Mac App Store. Odgaard stated he prefers receiving patches as public domain as this preserves his ability to release a future version under a more permissive license, or to make a version available on the Mac App Store. Odgaard also stated he has a friend who uses some of TextMate's frameworks in a closed-source project, and they could not incorporate patches released under GPL.
In October 2021, the latest/last commit was made to GitHub, though no announcement has been made to the effect that the project has been officially abandoned and its source code is still publicly available.
TextMate language grammars allows users to create their own arbitrarily complex syntax highlighting modes by assigning each document keyword a unique name. It uses a modified version of the Apple ASCII property list format to define language grammars. These grammars allow nesting rules to be defined using the Oniguruma regular expression library, and then assigned specific “scopes”: compound labels which identify them for coloration.
Each point of a document is assigned one or more scopes, which define where in the document the point is, how it should be colored, and what the behavior of TextMate should be at that point. For instance, the title of one of the links in the “External links” section has the scope:
text.html.mediawiki markup.list.mediawiki meta.link.inline.external.mediawiki string.other.link.title.external.mediawiki
This scope tells us that we are looking at a link title within a link within a list within a MediaWiki document.
TextMate themes can mark up any scope, at varying levels of precision. For instance, one theme may decide to color every constant (
constant.*) identically, while another may decide that numerical constants (
constant.numeric.*) should be colored differently than escaped characters (
constant.character.escape.*). The hierarchal scope syntax allows language authors and theme authors various levels of coverage, so that each one can choose to opt for simplicity or comprehensiveness, as desired.
TextMate documentation provides a list of naming commonly used across different programming languages for interoperability between bundles.
TextMate supports user-defined and user-editable commands that are interpreted by bash or the interpreter specified with a shebang. Commands can be sent many kinds of input by TextMate (the current document, selected text, the current word, etc.) in addition to environment variables and their output can be similarly be handled by TextMate in a variety of ways. At its most simple, a command might receive the selected text, transform it, and re-insert it into the document replacing the selection. Other commands might simply show a tool tip, create a new document for their output, or display it as a web page using TextMate's built-in HTML renderer.
Many language-specific bundles such as bash, PHP or Ruby contain commands for compiling and/or running the current document or project. In many cases the STDOUT and STDERR of the code's process will be displayed in a window in TextMate.
At their simplest, TextMate “snippets” are pieces of text which can be inserted into the document at the current location via a context-sensitive key stroke or tab completion. Snippets are "intelligent", supporting "tab stops" dynamic updating, access to environment variables, and the ability to run inline scripts. This allows complicated behaviors. Tab stops can be cycled through using the “tab” key and support default text, drop-downs, to complete elements of the snippet. The results of these tab stops can be dynamically changed in another portion of the snippet, as the user fills in a stop. TextMate environment variables can be used, supporting information about the current scope, line number, or author name, etc. Snippets also have the ability to run inline shell scripts.
TextMate language grammars, snippets, macros, commands, and templates can be grouped into “bundles” of functionality. Any snippet, macro, or command can be executed by pressing a keyboard shortcut, by typing a particular word and then pressing the “tab” key (so-called “tab triggers”), or by selecting the command from a menu. Tab triggers are particularly useful; the combination of tab triggers and snippets greatly eases coding in verbose languages, or languages with commonly typed patterns.
Snippets, macros, and commands can be limited to a particular scope, so that for instance the “close html tag” command does not work in a python script, freeing up that keyboard shortcut to be used for something else. This allows individual languages, and even individual scopes, to override built-in commands such as “Reformat Paragraph” with more specialized versions. Even special keys such as the return key and spacebar can be overridden.
Several documents or folders can be opened at once in a TextMate project window, which provides a drawer along its side listing file and folder names, and a series of tabs across the top. In TextMate 1.5, this drawer provides a means for users to organize files and folders from across the file system, as well as the ability to create virtual folders for further organization. This feature was removed from TextMate 2 and replaced with an ordinary file browser. Search and replace can be undertaken across an entire project, and commands can interact with the selected files or folders in the drawer. Bundles for CVS, Subversion, darcs, and other revision control systems allow TextMate to manage versioned code.
TextMate has many features common to programming editors:
- Folding code sections can be used to hide areas of a document not currently being edited, for a more compact view of code structure or to avoid distraction. The sections to be folded can be selected by hand, or the structure of the document itself can be used to determine foldings.
- Regular-expression–based search and replace speeds complicated text manipulations. TextMate uses the Oniguruma regular expression library developed by K. Kosako.
- A function pop-up provides a list of sections or functions in the current document.
- Clipboard history allows users to cut many sections of text at once, and then paste them.
- Column editing mode allows adding the same text to several rows of text, and is very useful for manipulating tabular data.
- "rmate" support for launching textmate as editor for files from remote servers - much improved over work-arounds needed in version 1 
In addition, TextMate supports features to integrate well with the OS X graphical environment:
- Clipboard graphical history supports pasting from previous copies, including prior launches.
- Find and replace support an analogous graphical history.[clarification needed]
- Editing is further enhanced by multiple cursors (insertion points), and the ability to extend the current selection to additional instances creating multiple cursors.
- A WebKit-based HTML view window shows live updates as an HTML document is edited.
- VoiceOver and Zoom users can use TextMate thanks to its accessibility support.
This section needs to be updated.(October 2021)
TextMate does have a few limitations when compared to other editors in its class:
- Because TextMate is not tightly coupled to a scripting language, as Emacs is to Emacs Lisp, it is impossible for users to have complete control over the program's configuration and behavior. Allan Odgaard explained his thoughts on the subject in an email to the TextMate mailing list, advocating for "platform-recommended" solutions.
- No built-in HTML validator — because TextMate uses the W3C validator for HTML validation, users must have an active network connection to validate HTML using the standard functionality.
- Lack of code-completion feature: despite its substantial support for macros, commands, and snippets, TextMate has no built-in support for code-hinting or guided code-completion, so text editors that support these features may prove to be a better choice when learning the syntax of a new language or coding in verbose languages. Remark: you can get code/word suggestions by typing one or more letters and (repeatedly) pressing ESC. The suggestions are words that occur in the current document.
- TextMate is not binary safe. It is explicitly text only, and does not guarantee that arbitrary binary data in a file will be preserved through a load/save cycle, regardless of whether that data is edited.
TextMate 1.5 won the Apple Design Award for best developer tool in 2006.
- Error: Unable to display the reference properly. See the documentation for details.
- David Hansson. “TextMate 1.0 is finally here! Archived 2008-12-05 at the Wayback Machine”, TextMate Blog, 5 October 2004.
- Allan Odgaard. “Profiles/Allan Odgaard Archived 2007-07-03 at the Wayback Machine” on the TextMate wiki, 20 November 2005.
- David Hansson. “TextMate 1.0.1 emerges after nine betas Archived 2020-09-12 at the Wayback Machine”, TextMate Blog, 21 October 2005.
- Matt Willmore. “TextMate 1.0.1 Review: A Checkmate for TextMate? Archived 2006-08-20 at the Wayback Machine”, Maczealots.com, 8 October 2004.
- Michael “drunkenbatman” Bell. “TextMate: The Missing Editor for OS X Archived 2006-05-14 at the Wayback Machine”, Drunkenblog, 4 November 2004.
- Kimbro Staken. “A cool new text editor - TextMate - Mac OS X Archived 2004-12-04 at archive.today”, Inspirational Technology, 6 October 2004.
- Allan Odgaard. “TextMate 1.5 Archived 2006-03-25 at the Wayback Machine”, TextMate Blog, 6 January 2006.
- Rui Carmo. “Third Time’s The Charm Archived 2006-11-30 at the Wayback Machine”, Tao of Mac, 8 January 2006.
- John Gruber. “ADA: TextMate 1.5.2 Archived 2017-11-10 at the Wayback Machine”, Daring Fireball Linked List, 8 August 2006.
- Allan Odgaard. “Future Directions Archived 2008-12-05 at the Wayback Machine”, TextMate Blog, 15 February 2006.
- TextMate Blog: Working on It Archived 2010-03-07 at the Wayback Machine, 14 June 2009
- TextMate Github:  Archived 2019-09-15 at the Wayback Machine, Sep 16, 2019
- GitHub,  Archived 2018-01-31 at the Wayback Machine, Aug 9, 2012
- "TextMate 2.0 goes open source in response to OS X restrictions". 9 August 2012. Archived from the original on 30 December 2016. Retrieved 15 June 2017.
TextMate developer MacroMates announced on Thursday that the code for TextMate 2.0, currently in alpha, is now available via the online GitHub repository. The code is being open sourced in order to counteract what some developers see as Apple's increasingly limiting user and developer freedom on the Mac platform.
- Odgaard, (2009). CONTRIBUTING.md Archived 2022-06-02 at the Wayback Machine.
- "Odgaard: "I will continue working on TextMate as long as I am a Mac user"". 10 August 2012. Archived from the original on 7 June 2017. Retrieved 15 June 2017.
Many open source proponents and would-be code contributors were vociferous in their opposition to Odgaard's choice of version 3 of the GNU General Public License, while asking upstream code patches to carry a public domain license. The problem, unfortunately, is the tug-of-war between FOSS principles and the desires of commercial ventures.
- "Github commits textmate/textmate". GitHub. Retrieved 2023-07-29.
- "Language Grammars — TextMate 1.x Manual". macromates.com. Archived from the original on 2021-10-30. Retrieved 2021-10-30.
- For information on getting more bundles, see the relevant section in the TextMate manual Archived 2008-10-10 at the Wayback Machine.
- "20 Regular Expressions". TextMate. Archived from the original on 2018-01-21. Retrieved 2009-04-28.
- How to edit files from my FTP Server as a TextMate project Archived 2017-07-19 at the Wayback Machine. TextMate Wiki - FAQ: Projects
- Support accessibility in text view - VoiceOver and Zoom Archived 2020-03-14 at the Wayback Machine. GitHub pull request
- Allan Odgaard. “Re: Changing cursor position from command Archived 2016-03-04 at the Wayback Machine”. TextMate mailing list. 14 February 2007.
- Gray, James Edward II (January 2007). Textmate: Power Editing for the Mac. Pragmatic Bookshelf. ISBN 978-0-9787392-3-2.