SnippetsLab popclip mac os x#
SnippetsLab popclip mac os#
SnippetsLab popclip install#
SnippetsLab popclip license#
SnippetsLab popclip plus#

A common error is to enter a number as a string type.įields with the type 'String or Dictionary' can take either a String or Dictionary value.

Make sure that you set each field the correct type.

You can use opacity to achieve 'shades of grey'.įor example, here is the full-size icon file for 'Sort': The image should consist of a black figure on a transparent background. Icons may be created in any graphics program I use Pixelmator.įor best results, the icon should be a square PNG file at least 256x256 pixels in size. The icon is displayed in the PopClip popup itself, and also in the preferences window and on the web site (if published). Here is an example plist for 'Translate Tab', as viewed in Xcode:Įxtensions may include icons to represent actions. Alternatively, use one of the existing extensions as a basis and edit with a text editor You can generate a blank plist with Xcode or a dedicated plist editor such as PlistEdit Pro. The plist contains information about the extension, and also defines one or more actions. This should be in Apple Property List format. Here is an example package structure, using the 'Say' extension:Įvery extension must contain a ist file. PopClip stores its installed extensions in ~/Library/Application Support/PopClip/Extensions/.

SnippetsLab popclip install#

popclipext package, PopClip will attempt to load and install it. To view the contents of a package, right click it in Finder and choose 'Show Package Contents'.

SnippetsLab popclip mac os#

Such a directory will be treated as a package by Mac OS X.

SnippetsLab popclip plus#

popclipext packageĪ PopClip extension consists of a property list called ist, plus (optional) additional files such as the icon and any required scripts, all contained in a directory whose name ends with. zip extension and unzipping it, to reveal a. You can examine an existing PopClip extension by renaming it with a. popclipextz filesįor distribution on the PopClip Extensions page, extensions are zipped and renamed with the extension.

Filter by whether the text contains a URL, email address or file path.Īnatomy of a PopClip Extension About.

Filter by whether cut, copy or paste is available.

Filter by application (either include or exclude).

Filter by matching a regular expression.

Open an HTTP URL, with the selected text URL-encoded and inserted.Īll extensions have access to the following filtering mechanisms, to help prevent them appearing when they are not useful: Run a shell script, with the selected text passed as an environment variable. Run an AppleScript, with the selected text embedded.

SnippetsLab popclip mac os x#

Invoke a Mac OS X Service, passing the selected text. There are five main kinds of actions supported by PopClip extensions. Be careful about the extensions you create, and be wary about loading extensions you get from someone else. Please be aware that PopClip extensions can contain arbitrary executable scripts. Run the following command at the Terminal, then Quit and restart PopClip: If you find this gets annoying while you are testing your work, you can turn off the warning. Extension Signingīy default, PopClip will display a warning dialog when you try to install your own extension, because it is not digitally signed by Pilotmoon Software. I reserve the right to change or remove features in future versions of PopClip at any time. You need to be comfortable with creating and editing plist files, scripts, and so on. Please note that user-created extensions are not an officially supported part of PopClip. These instructions are designed to help a technically competent person to create their own PopClip extension.

Create Your Own Custom Extension for PopClip (Tuts+).

Here are some external 'how to' guides for creating extensions:

I will take care of that.įor an easy way to create certain types of extension with no coding necessary, check out Brett Terpstra's PopMaker app.

Don't worry about signing the extension.

I will choose which extensions to publish at my sole discretion, and I may make changes to any extension.

By contributing to this repo, you agree that your contribution may be published at PopClip Extensions.

Thank you for contributing! Contributors, please note the following: Contributor credits are are shown in the readme file of each individual extension. CreditsĪll the extensions and documentation were created by Nick Moore, except where stated.

SnippetsLab popclip license#

LicenseĪll extension source files are published under the MIT License (see LICENSE) unless noted otherwise in the readme files of individual extensions. This repository contains the documentation for making your own extensions (this readme file) as well as the source files for the extensions published on the main PopClip Extensions page.

PopClip extensions add extra actions to PopClip.

Documentation for PopClip 1.5.5 Introduction