Actions and recipes

Open URL

Opens a URL with the matched text inserted, in your default browser.

• The URL must start with a scheme such as https: or mailto:. A template of just $0 means the selected text is itself the URL.
• When the selection goes into the URL's query, turn on "URL-encode inserted values". Spaces, & and non-Latin text then survive. For a ticket key made of letters and digits going into the path, leave it off.

Copy

Copies the matched text, or text built from the template, to the clipboard. With an empty template, the whole match is copied as it is.

While pinned, this action pastes at your cursor instead of copying.

Run Command

Runs the template as a zsh command. Insert the selected text with $0 and the other placeholders. Output isn't shown in the panel.

Translate

Works out which language of the pair you set the selection is in, and translates it into the other one. With Japanese as your language and English as the other language, English text gives you Japanese and Japanese text gives you English. There's nothing to switch. Text in a language outside the pair gets nothing, and neither do short phrases, IDs or URLs whose language can't be told with confidence.

Translation uses macOS's translation feature and runs on your Mac; the text isn't sent to an outside server. The first time you use a language pair, macOS may need to download language data, and the panel offers a button for it.

• Translate is a built-in feature. It has no match condition or template and always translates the whole selection. You can change its name, icon, whether it's enabled, and the language pair ("Your language" and "Other language"). In Settings it has its own "Translation" section, and it can't be deleted.
• The panel shows the original and the translation, at the bottom of the column and as wide as the rows. Long text scrolls within its box. You can select the translation and copy it.
• Translations have no ⌃+number. Pin or unpin one with the pin button on the panel or with ⌃⌘T.
• If the pair isn't supported, the translation fails, or the result is over 4,000 characters, the translation suggestion goes away.

Single words get the dictionary

When the selection is a single word (no spaces) in the other language, you get its definition from the macOS dictionary instead of a translation. If no definition is found, you get a translation. Words in your own language don't get a definition. The lookup also happens on your Mac, so the text isn't sent anywhere.

• Which dictionary is used is decided by the Dictionary app's settings. You can't choose it in Pluck.
• "Open in Dictionary" on the panel, or ⌃⌘T, opens the word in the Dictionary app.
• The dictionary is part of the Translate rule, not a rule of its own. Turning the Translate rule off turns off definitions too.

Replace All

Finds every place in the selected text that an Open URL rule matches, and rebuilds the whole text with each of them replaced by its URL. Use it to turn the keys scattered through a paragraph into links while keeping the prose intact.

Selected text
  Please look at WT-1 and WT-2

Result
  Please look at https://your-domain.atlassian.net/browse/WT-1 and
  https://your-domain.atlassian.net/browse/WT-2

Replace All has no match condition or template of its own; you can change only its name, icon, and whether it's enabled. The conditions and URLs come from your Open URL rules, so adding an Open URL rule extends Replace All as well.

• Only Open URL rules are used. Copy and Run Command templates aren't.
• Open URL rules with an empty match condition aren't used either, since they would replace the whole text with a single URL.
• Where two matches overlap, the rule higher in the list wins.
• Inserted values aren't URL-encoded, because the result is prose rather than a URL.
• If replacing changes nothing, no suggestion appears.

The panel works a little differently for this one.

• ⌃+number replaces your selection with the rebuilt text. It writes to the clipboard and sends one ⌘V, so keep the text selected when you press it.
• Clicking the row only copies the rebuilt text, so a stray click can't rewrite your selection. While pinned, a click pastes as well.

Paste Image

When you take a screenshot or copy an image from a browser, a single suggestion with a thumbnail appears. It doesn't react to text.

• It arrives already pinned. esc and clicks outside the panel leave it alone; close it with × or ⇧⌃⌘+number.
• Press it, or ⌃⌘+number, to paste the image at your cursor. This still works after you've copied something else, as long as the suggestion is there.
• Pinned images have a total size limit. Past it, further images aren't pinned and the panel says so. Close images you're done with using ×.
• Turn this rule off and Pluck stops reading images from the clipboard. If you never use it, turning it off is fine.

In Settings, this rule sits under "Rules for images" with an image tag.