Search and commands
Free⌘K opens the palette from any page: a search box with a list below it. It finds pages, single tabs, your sites, services, sections of the settings, chapters of the documentation and actions such as Start all or New site. Every entry is an action: Enter runs it. You can also bind any action to a keyboard shortcut of your own.
What you do here
- Open and use the palette: The palette (⌘K).
- Know what the palette finds and how it sorts: Search and find.
- Bind an action to keys of your own: Keyboard shortcuts.
- Take back a shortcut pressed by mistake: Undo after a shortcut.
Layout
| Part | Content |
|---|---|
| Search box | "Search or type a command…", with the esc hint on the right |
| List | without a query Recent, Popular and the two most used entries per group, with a query the matches by group |
| Footer | the keys for using it and Manage shortcuts |
Besides ⌘K, Search & commands at the bottom of the sidebar opens the palette.
Free and Premium
The palette and the shortcuts are the same on Free and Premium. Pages that belong to an add-on package you lack show the package name in the palette.
The palette (⌘K) Free
The palette is the fastest way through WebDonkey. You type what you want and run the match with Enter: open a page, start a service, open a site in the browser, jump to a section of the settings. Along the way the palette learns what you use often.
Where to find it
- ⌘K on every page. The shortcut works even while you type in a field. Pressing ⌘K again closes the palette.
- Search & commands in the sidebar footer.
How to do it
- Press ⌘K. The search box "Search or type a command…" has the focus right away.
- Type a word, such as "php", "certificate" or the name of a site.
- Pick a match with ↑ and ↓. The highlighted entry carries an arrow on the right.
- Press Enter (↩). The palette closes and runs the action. A mouse click on an entry does the same.
Esc or a click outside the palette closes it without an action.
What the list shows
Without a query
The list has two columns:
- Recent: the last three actions you ran.
- Popular: the two actions you use most (used at least twice).
- Then every group with its two most used entries, in this order: Actions, Sites, Services, Sidebar, Toolbox, Settings, Documentation, Themes, Containers, Tools.
Below a group, Show … more (with the number) unfolds the remaining entries, Show less folds them again.
With a query
Recent and Popular disappear. The groups are sorted by their best match, with two matches per group at first. If the palette finds nothing, it says No results.
Keys
| Key | Effect |
|---|---|
| ⌘K | open or close the palette |
| ↑ ↓ | move the highlight |
| ↩ | run the highlighted entry |
| ⇥ (Tab) | unfold the whole group of the highlighted entry |
| Esc | close |
The footer reminds you of these keys (navigate, run, unfold category) and of ⌘Z undo after a shortcut. On the right, Manage shortcuts leads to Settings › Keyboard shortcuts.
What a row shows
- An icon on the left, then the name of the entry.
- On the right a hint of what happens, such as Open in browser, Details, Start, Stop, Open or Install.
- Dialog means the entry opens a form or a dialog, such as New site. So the palette never throws a window at you unannounced.
- If the entry has a keyboard shortcut, it is shown on the far right.
What happens in the background
WebDonkey counts how often and when you run each action. Recent, Popular and the order within the groups come from that. The count stays on your Mac. You reset it with Reset search statistics under Settings › Keyboard shortcuts.
See also
Search and find Free
The palette searches the whole app. It compares what you type with the name of every entry and with keywords attached to it. That is why "ssl" finds the SSL certificates page, "uptime" the Monitor and "cronjob" the Scheduled tasks, even when the word is not in the name.
How to search
- Open the palette with ⌘K.
- Type one or more words. Every word has to appear somewhere in the name or the keywords of the entry. Upper and lower case do not matter.
- Matches where your word appears further to the front come first. Between equally good matches, what you use more often wins.
What the palette finds
| Group | Entries | What Enter does |
|---|---|---|
| Actions | New site, Start all, Stop all, Restart front proxy, Check all (Monitor), New SEO audit, SEO: check a URL now, Open Adminer, Switch theme, Report a problem, Switch vault (Notes), Manage shortcuts, WebDonkey website, plus Run workflow: for every workflow with a manual start | runs the action |
| Sites | two entries per site: the domain with Open in browser, and name with domain with Details | opens the site in the browser or shows it on the Sites page |
| Services | every service from Services, such as PHP, MySQL or nginx, with Start or Stop, a running one also with Restart | starts, stops or restarts the service |
| Sidebar | every page of the sidebar, plus Changelog, Premium, Settings, Custom logs and single tabs such as AI › Chats, AI › CLI, Claude › Hooks or Terminal › Prompt | opens the page or the tab |
| Toolbox | every tool of the Toolbox | opens the tool |
| Settings | every section of the settings, such as Language, Hosts file or Sandbox | opens the right tab and scrolls to the section |
| Documentation | every chapter of the WebDonkey documentation | opens the chapter |
| Themes | the presets and your own themes | switches the theme |
| Containers | DDEV projects and Docker containers | opens a running DDEV project in the browser or starts it, starts or stops a container |
| Tools | apps and command line tools from Services with Open or Install | opens the tool or asks about installing it |
The Sidebar group is called that because it holds the pages of the sidebar.
What the palette does not show
- Pages you hid under Settings › Navigation, and the actions that belong to them.
- On Free with Hide Premium features, the Premium pages and Premium tabs.
Pages of an add-on package you lack are listed, but show the package name on the right, such as SEO package.
Tips
- Search for what you want to do, not for the page name: "certificate", "port", "backup", "language".
- One word is often enough for a section of the settings: "hosts", "sandbox", "widget", "lan".
- What you use often moves up by itself. To start over, use Reset search statistics under Settings › Keyboard shortcuts.
- From the terminal you open a page with
wd open, see CLI (wd).
See also
Keyboard shortcuts Free
Any action from the palette can be bound to keys of your own: a single letter, a combination with ⌘ ⌥ ⌃ ⇧ or a sequence such as G then S. That way you open a page, start a service or switch the theme without opening the palette. A shortcut never fires while you are typing.
Where to find it
- Settings › Keyboard shortcuts, or
- Manage shortcuts at the bottom right of the palette, or
- the action Manage shortcuts with ⌘K.
How to do it
- Under New shortcut, click into the search box "Type to find a command (same list as ⌘K) …". Empty, it shows the entries of the Actions group; with input, up to eight matches from all groups.
- Pick the action. It then shows above the box, Change picks another one.
- Click Record keys. The button reads Press keys ….
- Press the keys. For a sequence, press the keys one after the other. Recording ends when you press no key for a little over a second.
- Click Save.
The shortcut then appears in the list above the form and in the palette, in the row of the action.
What is allowed
| Kind | Example |
|---|---|
| a single letter or digit | S |
| a combination with ⌘, ⌥, ⌃ or ⇧ | ⌘⇧R |
| a sequence of several keys | G, then S |
A sequence fires when its keys follow each other within one second. Esc as the first key cancels recording.
When a shortcut is refused
- This combination is taken by the app or the system. This applies to ⌘K, ⌘Z, ⌘⇧Z, ⌘C, ⌘V, ⌘X, ⌘A, ⌘Q, ⌘W, ⌘H, ⌘M, ⌘S, ⌘F, ⌘R, ⌘P, ⌘N, ⌘T and ⌘, (comma), to most of these with ⌃ instead of ⌘, and to Esc, Enter, Tab, Space, the delete keys and the arrow keys on their own.
- Already bound to "…". The shortcut already belongs to another action, whose name is in the message. Remove it there or choose other keys.
Save stays disabled as long as no action is picked, no keys are recorded or the shortcut is refused.
Removing a shortcut
In the list of bound shortcuts, the bin icon at the end of a row removes the shortcut. If an action no longer exists (a deleted site, for example), its shortcut is shown struck through in the list.
When a shortcut fires
- Only while the palette is closed.
- Never while you type in an input field, a code editor, the terminal or a note. A plain
Sis therefore safe to bind. - After it fires, WebDonkey shows a hint with Undo for five seconds, see Undo after a shortcut.
What happens in the background
WebDonkey stores the shortcuts in its own database. They are part of the app backup (category Search & shortcuts).
See also
Undo after a shortcut Free
When you run an action with a keyboard shortcut, WebDonkey shows a hint at the bottom of the window: which keys it was and what happened. For five seconds you can take the action back with ⌘Z or the Undo button. A bar along the bottom edge shows how much time is left.
How to do it
- You press a shortcut, for example for Stop all.
- The hint appears with the keys and the name of the action.
- Within five seconds, press ⌘Z or click Undo.
⌘Z only works while you are not typing in an input field. There ⌘Z stays the normal undo for text.
What Undo does
| Action | Undo |
|---|---|
| opening a page | goes back to the previous page |
| Start all / Stop all | stops or starts everything again |
| starting or stopping a service | reverses the step |
| starting a DDEV project, starting or stopping a Docker container | reverses the step |
| switching the theme | brings back the previous theme |
| Switch vault | switches back to the previous vault |
Actions without a way back, such as opening a site in the browser or Restart front proxy, show cannot be undone in the hint.
Fields and options
| Element | Meaning |
|---|---|
| Undo ⌘Z | takes the action back |
| bell with a slash | turns the hint off for good, ⌘Z keeps working |
| ✕ | closes only this hint |
You bring back a hint you turned off under Settings › Keyboard shortcuts: Show the undo banner after a shortcut (⌘Z works either way). ⌘Z takes back the last shortcut for five seconds even without a visible hint.
Actions run from the palette itself (with Enter or a click) show no hint.