Thoughtful, detailed coverage of the Mac, iPhone, and iPad, plus the TidBITS Content Network for Apple consultants.

TextExpander 4 Fills in Fill-ins

At our regular TidBITS staff meeting a week before Apple announced its third quarter financial results (see “iPads, iPhones Propel Apple’s $8.8 billion Q3 2012 Profit,” 24 July 2012), we discussed how we were going to cover the earnings results conference call. Someone mentioned that our story from the previous quarter probably could be recycled with only minor changes, given how consistently profitable Apple had been of late. I was just finishing the revision to my “Take Control of TextExpander” book to bring it up to date with the newly released TextExpander 4, and so I jokingly suggested I could probably create a boilerplate article using TextExpander’s powerful new fill-in capabilities. Hilarity ensued.

Well, I didn’t create a boilerplate article (we do have journalistic integrity here at TidBITS), but I did create a boilerplate opening paragraph snippet so I could quickly slug in the appropriate numbers as they were read out. Creating the snippet took only a few minutes and it was a lot of fun to figure out how to craft a template paragraph that could suit either expected profits or surprising losses. When it came time for us to write the story, we did, in fact, begin it with a revised version of the paragraph produced by my snippet.

For those who are new to the party, let me explain some TextExpander basics. With TextExpander you create short (or not-so-short) chunks of text that TextExpander calls snippets. You associate each snippet you create with a short, unique string of text called an abbreviation. TextExpander then watches what you type on your Mac and replaces the abbreviations that you type with the contents of the associated snippet. For example, I never type the name “TextExpander” anymore; I type the abbreviation I created for it, “ttx,” and TextExpander automatically replaces it with the snippet containing the text “TextExpander.” It works much like the text substitution feature in OS X 10.8 Mountain Lion’s Language & Text preference pane, but with considerably more flexibility.

Much of the flexibility has to do with TextExpander macros. These are strings of text within a snippet, prefaced with a percent sign, that perform some special function. TextExpander has macros for positioning the cursor after a snippet has expanded, inserting the current date or a calculated date, and a number of others.

One set of macros is for fill-in items that you can enter at the time the snippet expands. Fill-ins in earlier versions of TextExpander provided simple fields to fill in, but TextExpander 4 offers several types of fill-in macros: not only text fields, but also pop-up menus, multi-line fields, and optional text passages. (There are some other changes and new features in TextExpander 4, but fill-in snippets are the marquee feature.)

When you create a snippet, you don’t have to type any macro code; TextExpander has menus that insert the macro code for you. But when you edit a snippet that contains macros, the macro code does appear like any other text, so a snippet with a lot of macros can look rather gnarly. In fact, with the addition of TextExpander 4’s multiple types of fill-in macros, such as those I used for the financial results article, a snippet can look, at first glance, highly chaotic. Smile Software, though, has made sure that such snippets are not only editable by code geeks but by mere mortals who prefer a more friendly method.

In TextExpander 4, the text editing pane in which you create your snippets may look like a simple text editor, but it isn’t: when you double-click the text of any fill-in macro in a snippet, a specialized editor for the fill-in appears. Changes you make in the editor change the macro text in the snippet, so you don’t end up with any code stains on your fingers.


Each fill-in macro can be assigned a name, too, to help you reduce typing when you fill the snippet in: if a named macro appears in several places in the snippet, you fill it in once in the fill-in window and the content appears in all the fill-ins with that same name. I used that feature in my financial results snippet: I had to choose “profit” from only the first pop-up menu in the snippet to have “profit” appear in the other pop-up menu fill-in items in the paragraph.

Of course, the financial results snippet is something I’m able to use only a few times a year, but I use fill-ins snippets far more often than that. For example, I have a snippet that generates the opening parts of TidBITS articles for me (title, blurb, and author) whenever I start a new article. I also have a fill-in snippet I use for a book I’m writing to create figure and illustration file names so they’re always formed the way my editors like them.

In TextExpander 4, fill-in snippets, which were already very handy, became an even more powerful tool, and one that is a pleasure to use. Sure, I may not be able to write the Great American Novel using TextExpander 4’s fill-in snippets alone, but maybe when TextExpander 5 is ready…


READERS LIKE YOU! Support TidBITS by becoming a member today!
Check out the perks at <>
Special thanks to Mike, George Williams, Michael Rubin, and Michael
Nelson for their generous support!

Comments about TextExpander 4 Fills in Fill-ins
(Comments are closed.)

Durbrow  2012-09-10 16:22
This article was slightly disappointing. I was hoping the author was convince me that the new feature was worth the non-trivial upgrade price. I am still unconvinced. To each his own.
Michael E. Cohen  An apple icon for a TidBITS Staffer 2012-09-10 17:08
The point of the article was to describe the fill-in feature and show how it could be used both for fun and for serious work, not to try to sell you an upgrade. However, the "non-trivial" upgrade price you mention is $15: seeing one so-called "summer blockbuster" earlier this year, plus parking, cost me more than that, and was not nearly as satisfying!
Tracy Valleau  2012-09-10 17:40
This whole genre brings up a question: I have purchased TextExpander; Keyboard Maestro; Dash; Grammarian and a few I've forgotten. Each offers features the others do not, but all of them are watching my typing. In the "days of yore" such a number of programs doing the same thing was pretty much guaranteed to bring the system to its knees.

Outside of the obvious travails of keeping it all straight, are there still downsides to running these things together? (TE does a better job of expansion than the others, but KM offers machine control macros; Dash is great for computer reference manuals; Grammarian is a nice dictionary cum spell checker... but... all at once? )

I'd love it if multifunction software would give me the option to monitor for expansion...

Comments appreciated (including any techno-geeky stuff as to how this all works these days without "hooks" into the OS...

Adam Engst  An apple icon for a TidBITS Staffer 2012-09-11 05:44
I don't run as many of these things as you do, but I've never noticed any slowdowns with TextExpander and Keyboard Maestro. It may simply be that Macs have so much CPU power now that background stuff like this (which is happening at the application level, so no crufty hacks) is easily handled.

I think there are multiple approaches to making this stuff work - Grammarian uses an Input Manager, and both Keyboard Maestro and TextExpander require that access for assistive devices be turned on in the Accessibility preference pane.
William Garrett  2012-09-11 08:37
Michael, a question about the fill-in feature: can the boilerplate text and the fill-in text be formatted differently? For example, I have a form in which the boilerplate should be plain text, but whatever goes in the blanks should be bold.

Bill G
Michael E. Cohen  An apple icon for a TidBITS Staffer 2012-09-11 09:07
I just tried it. For some reason, bold didn't work in my quick test, but italic did, as well as a different font. Of course, the snippet itself has to be set to allow for formatted text (an available menu option).
William Garrett  2012-09-11 11:34
Thanks for testing it for me. Italic or even a different font might work for my purposes, so I'm definitely going to give TextExpander a try.
William Garrett  2012-10-11 14:08
Thought I would follow up and report that bold is working for me, and so far TE is doing everything I hoped it would do.

Next, if I can learn a little bit of Apple Script, I hope I can automate some boilerplate emails, order-taking and other tedious things.

--Bill G