Quick actions, and writing your own
Five actions are built in — Translate, Explain with AI, Improve writing, Summarize and Step-by-step plan — and you can write up to eight of your own, each just a name, an instruction and an icon.
A quick action takes the text you just captured and hands it to your AI; you hear the answer. Five are built in — Translate, Explain with AI, Improve writing, Summarize and Step-by-step plan — and you can write up to eight more yourself. They turn up in the same places: Quick action in the bar under the frame, the Quick actions button on the subtitle bar, the bar at the bottom of a text you open, and the three dots on the two cards on Home. The three dots next to a text in History offer the built-in ones.
You need Speakybara installed and running, and an AI connected under Settings › AI for tasks — a key of your own from OpenAI, Google Gemini or OpenRouter, or a model on your PC such as Ollama or LM Studio. The guide on connecting your own AI covers that.
Writing one of your own
Step 1
Try a built-in action first
Capture a piece of text and pick Quick action in the bar under the frame: Translate, Explain with AI, Improve writing, Summarize or Step-by-step plan. At the bottom, Custom instruction… lets you ask your own question about the text, once. Nothing else has to be set up, as long as an AI is connected.
Step 2
Open Settings › AI for tasks › Quick actions
On the AI for tasks page, the row Quick actions has a Manage… button, which opens the list: the built-in actions first, then your own, and the button Add a new action… at the bottom. The last item behind the three dots on the capture card on Home, New action…, opens the same form.
Step 3
Fill in a name, an instruction and an icon
Name the action, write what the AI should do with the captured text as an instruction, and pick one of 24 icons. Save it there and the action already works.
Step 4
Decide what happens to the answer
Read the result out loud is on; switch it off for an action that only writes. Also copy the result to the clipboard is off. A shortcut of its own is optional, and there is none by default: it captures and runs this one action in a single keypress.
Step 5
Switch on Advanced options if you want more control
A second card folds open. There you set Reply language, Length of the answer (short, normal or long), Model for this action, and Creativity (precise, balanced or creative). Send the instruction word for word drops the app's own rules and puts the captured text where you write {text}. Do not keep in history keeps this action's capture and answer out of the history file: they stay in memory until you close the app.
Step 6
Save it, and use it everywhere
A saved action stands next to the built-in ones in the bar under the frame, on the subtitle bar, at the bottom of an opened text and behind the three dots on Home. Editing and deleting happen back in the list at Settings › AI for tasks › Quick actions — click the action to open the same form, the bin asks once.
Worth knowing
- Eight actions of your own is the ceiling.
- Ctrl+Alt+Q (Capture and choose) reads nothing until you pick: the bar under the frame has Read aloud, Copy and, under Quick action, every action you have, built in or your own.
- An action can be write-only: switch off Read the result out loud, switch on Also copy the result to the clipboard, and the answer lands on your clipboard without a sound. The built-in Improve writing always copies its result.
- Settings › Shortcuts lists the hotkeys of your own actions at the bottom; you change them in the action's form.
- On a Mac you can also adjust a built-in action (its instruction, AI service or model) and Reset it later, and every action can use a service of its own under AI for this action. On Windows the built-in actions stay as they are, and an action of your own can pick another model of the same service.
If something goes wrong
Translate (with a target language), Explain with AI, Improve writing, Summarize and Step-by-step plan, which turns a text into numbered steps and reads them one at a time. Read aloud and Copy sit in the same menus, but they use no AI.
No. It uses whatever you connected under Settings › AI for tasks, unless you pick a different model for that one action under Advanced options.
Yes. Turn on Do not keep in history for that action under Advanced options, and its capture and answer stay in memory only, until you close the app.
The list at Settings › AI for tasks › Quick actions says why at the top: AI for tasks is switched off, or it has no key or model yet. Connect one on the AI for tasks page and the actions work.