PopMaker

FYI, this project is listed as "retired." It may no longer function or I may just not be updating it anymore.

PopMaker is an OS X app for generating PopClip extensions. It’s currently limited in scope to “search” extensions and “surround” extensions. You simply fill in the fields and hit the button to save to disk or install immediately. It even lets you import your own icons (more info below).

It occurred to me — after a couple dozen request for “can you make a PopClip extension for this?” — that I could probably put the power in the hands of people who aren’t necessarily comfortable editing PLIST files.

As a usage example, I added an extension to my PopClip Extensions collection that searches a selected “texting” abbreviation (e.g. LOL) on textingabbreviations.ca. It took me under 15 seconds to create it and install it.

The basics

Every extension you make will have a required set of fields shown at the top when you launch PopMaker:

• Author (your name)
• Extension Name (the long title of the extension as shown in the configuration palette)
• Menu title (the short abbreviation that will show in the PopClip bar)

There’s also an optional description field. This isn’t really useful unless you’re sharing the extension.

Palette Icon

Any extension can optionally have an icon which replaces the Menu Title. Icons have certain requirements, but PopClip is actually more flexible than the documentation would lead you to believe. For the best results, though, an extension’s icon should be a square PNG file at least 256x256 pixels in size. It should consist only of a solid black figure on a transparent background. The black areas will show up white when displayed on the PopClip bar.

Extension types

PopMaker creates two kinds of extensions right now. If I decide to push the project further, this will expand and ultimately include the ability to include custom scripts.

Search

Search extensions can point to any URL, and you use {query} (verbatim) anywhere in the url string to insert the text you have selected when you click the extension. The inserted text will be url escaped automatically.

You can use this extension type to create local file urls, too, for handlers such as nvALT or Evernote. You can even use it to send Messages. You just have to know the url scheme.

Create a Search extension by opening PopMaker, filling in the fields at the top, and choosing Search from the dropdown menu. Then simply fill in the url, substituting {query} for the variable part.

Surround

Surround extensions do just what you’d think: surround selected text on either side with whatever characters you specify when generating the extension. You can use it to create Markdown extensions (**|** or _|_), CriticMarkup shortcuts, comment syntax, etc. It’s simplistic, but a handy tool when you already have your hands off the keyboard to make a selection or you’re working in a text field without handy things like auto-pairing.

Create a Surround extension in the same manner as a Search extension. When you switch to the Surround style, you get two fields. Type whatever you want to go on either side of the text. Note that the generated extension will trim whitespace on either side of the selection and butt the surrounding prefix and suffix to word edges, so if you want a space, put it in the fields implicitly.

Installing or Saving extensions

Once you’ve completed the fields, you can click Install to send the extension to Popclip. If you hold down the option key, that button will change to “Save to Disk” and you can create a distributable extension. By default it will create a popclipextz file, which is a zip compressed version of the extension appropriate for sharing and distribution.

There’s a checkbox at the bottom (dev mode) that, when checked, prevents the extension from being zipped before saving. You can then right click on the resulting popclipext package and “Show Package Contents” in Finder. This is primarily for people who have some scripting knowledge and want to tweak the basic extensions further. See the PopClip Extensions documentation for helpful info.

Download

Download the file below, unzip and drag it to your Applications folder.