Settings
Free & PremiumThe settings decide how the editor looks, how it behaves while you type, save and search, and which windows and features it loads at all. They open as a tab in the editor area. Every change applies at once, in the editor's other windows too.
Where to find it
- ⌘,
- Menu WebDonkey Editor › Settings…
- The button on the right of the title bar (WebDonkey, or Without WebDonkey), then Settings
- Command palette (⌘K): Settings
What you do here
- Pick theme, language, density and single code colours: Appearance, ready-made and shared editor themes in the Gallery.
- Set typeface, size and line height for code and terminal: Font.
- Display, indentation, saving and ⌘-click in the code editor: Editor.
- Shell, cursor, bell and keys of the terminal: Terminal.
- Hide tool windows, status bar, start and updates: Features.
- Where Claude starts, local AI, AI in the code and suggestions while typing: AI.
- Viewers, local history and images: Files & formats, plus which file types open in the editor on double-click: Default editor.
- Search window, Remote, services: Search, Remote, Services.
- Look up every shortcut: Shortcuts.
- Back up, move and reset settings: Advanced.
- Version, license and legal texts: About, License, Legal.
The Starter category is described in the Launcher chapter.
Page layout
Categories on the left. Appearance, Font, Editor, Terminal, Features, Starter, AI, Files & formats, Search, Remote, Services, Shortcuts, Advanced, About. A click jumps to the category, and the highlight follows as you scroll. A dot next to a category means you changed something in it.
Search on top. Type into Search settings. It looks through names, hints, options and keywords, including common synonyms. The list starts at the first hit and the field shows Matches: with the count. ↓ and ↑ walk from hit to hit, Enter puts the cursor into the switch or field of the hit, Esc clears the search. With no hit you see "No setting matches …".
Modified only. The checkbox next to the search shows only what differs from the default. If everything is at its default, you see "Everything is at its default."
A row. A dot on the left (Modified), then name and hint, the switch, menu or field on the right. The arrow at the end (Reset to default) brings the default back. Next to a category heading, Reset … resets the whole category. Both arrows only appear once something has changed.
Values. Numbers apply on Enter or when you leave the field. A number outside its bounds becomes the nearest allowed value. Text that does not fit gets a red border, and hovering it shows "This value does not fit here." Esc restores the previous value.
Preview. In Appearance and Font a small code sample and a terminal sample at the top show how theme and font look right now.
When you switch to another tab and come back, search and scroll position are where you left them.
What happens in the background
The editor keeps the settings in its app storage on your Mac. The theme choice lives in WebDonkey's database, or in the editor's own database without WebDonkey. Changed values apply in all open windows right away.
Free and Premium
Almost everything is free. Part of WebDonkey Premium are the theme presets, using and sharing themes in the gallery, suggestions while typing, the CLI for Agent in the AI window, and mappings and server search under Remote. Without Premium the affected settings carry a lock ("Part of WebDonkey Premium.") and cannot be changed.
Appearance Free & Premium
Under Appearance you choose the editor's theme, the interface language, how dense lists are, and how motion and contrast look. The Editor colours group changes single colours in the code without building a theme of your own.
Where to find it
- Settings › Appearance
- With Premium you can also switch themes from the palette icon on the right of the title bar (Switch theme) or with Switch theme… in the command palette.
- The command palette also lists Theme: Aurora, Theme: Arctic, Theme: like WebDonkey and one Theme: entry per theme name.
How to: switch the theme
- Open Settings › Appearance. The Theme card at the top shows a large swatch of the current theme.
- Click the button with the theme's name on the right of the card. It opens the same menu as the palette icon in the title bar.
- Pick a theme. It applies at once, in every window. The active theme has a check mark.
The theme menu
The menu is split into groups:
| Group | Entries | Tier |
|---|---|---|
| Base | Like WebDonkey (follows WebDonkey's theme; without WebDonkey the entry is called Default (Aurora)), Aurora (dark), Arctic (light), System (Aurora/Arctic) (follows macOS light and dark) | Free |
| Presets | the ready-made themes Sunset, Sunrise and Galaxy, plus a theme you took from the Gallery | Premium |
| Own | themes you created yourself in WebDonkey | Free |
Without Premium the presets are greyed out and marked Premium. The card says: "Presets need Premium; your own themes work on Free too."
More settings
| Setting | What it does | Default |
|---|---|---|
| Language | Interface language. Like WebDonkey takes WebDonkey's language; without WebDonkey the option is called System. | Like WebDonkey or System |
| Interface font size | Menus, project tree, tabs and status bar, 11 to 16 px. Code and terminal are set under Font. | 13 px |
| Density | How much room rows get in the tree, in lists and in the status bar: Compact, Normal, Roomy. | Normal |
| Color gradient on the start screen | The gradient behind the start screen. Behind the code the surface always stays calm and plain. | on |
| Motion | Like the system or Always reduce. Reduced means: no smooth scrolling, no gliding cursor, no animations. | Like the system |
| Contrast | Like the system or Increased. Increased makes dividers and secondary text stronger. | Like the system |
| Last change in the project tree | Shows when files and folders last changed, behind their names. | on |
| File icons | Icons in front of file names in the tree, tabs, quick open and search: Colored, Monochrome or Off. | Colored |
Editor colours
The Editor colours group recolours single parts of the code. An empty field means the colour comes from the theme.
- Code background, Accent (cursor, focus) and Selection
- Syntax: Keywords, Strings, Numbers, Comments, Types, Functions, Variables, Tags, Attributes, Constants, Operators, Regular expressions
Every field shows the contrast against the code background, as the editor shows the colour right now. The arrow at the end of the row brings back the theme's colour.
Keep text readable (default: on) moves every colour to the nearest well readable value. If the editor moved a colour, the field says adjusted to with the new value. Switched off, this only applies on this Mac: a theme you share must still meet every rule. If a theme would not give a readable code surface at all, the editor shows a calm version with a neutral ground. The accent then stays for controls.
Taking a theme from the gallery replaces your own colours. The editor asks first.
Free and Premium
Aurora, Arctic, System, Like WebDonkey and your own themes are free, and so are all settings of this category. Presets and taking themes from the gallery need Premium, and the palette icon in the title bar only shows with Premium. When Premium ends, the editor shows a preset as Aurora.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| The theme button is grey and the card says themes unlock with WebDonkey | The editor runs without a database, usually because WebDonkey is older than the editor needs | Update WebDonkey, see About |
| A preset is grey and marked Premium | Presets are part of Premium | Activate Premium, see License |
| A colour looks different from what you entered | Keep text readable moved it | Check the value next to adjusted to, or switch off Keep text readable |
See also
Gallery Free & Premium
The Gallery shows editor themes: colours for code and terminal, plus font, size, line height and cursor. Every card shows real code in that theme and a readability score. You can use a theme, swap themes by share code or share your own look in the gallery.
Where to find it
Settings › Appearance, right below the Theme card. Or type "gallery" into the settings search.
The gallery appears as soon as the editor has a database: WebDonkey's, or the editor's own without WebDonkey. If it has neither, for example because WebDonkey is older than the editor needs, the gallery stays hidden.
Layout
- Gallery with the Search themes field. Without Premium it says next to it: "Taking and sharing come with Premium. Arctic and Aurora are always there."
- By WebDonkey: six ready-made looks, Ember, Fjord, Paper, Moss, Obsidian and Porcelain, each with a short description.
- From the community: themes other people shared. Choose the order New or Popular at the top. The list loads more themes as you scroll.
- Paste share code and Share my look: each opens a panel below the buttons.
Every card shows:
- a code preview in the theme's colours and font,
- the name and Readability with a score from 0 to 100, worked out from contrast and colour distance. Scores below 70 are marked,
- how often the theme was taken (downloads),
- the Use button.
The search forgives typos: the letters only have to appear in the right order, accents do not count. The looks By WebDonkey also match their description. Esc clears the field.
How to: use a theme
- Open Settings › Appearance and scroll to the Gallery.
- Pick a theme and click Use on its card.
- If you set your own colours under Editor colours, the editor asks "Replace your own colours?" and says how many there are. Confirm with Apply.
- The editor reports that the theme is now your editor theme.
The theme then shows in the theme menu among the presets. The editor also sets typeface, font size, line height, font weight, letter spacing, ligatures, cursor and Colored bracket pairs from the theme. If the theme's font is not installed on your Mac, it uses Geist Mono and tells you.
Paste share code
A share code is a short text that describes a whole editor theme. You get it from the website or from someone else.
- Click Paste share code.
- Paste the code into the field and click Check. The editor checks it before anything changes.
- If the code is fine, you see preview, name and readability. Click Use.
Share my look
- Pick a theme with colours of its own first, for example a preset, an own theme from WebDonkey or a theme you took. Arctic and Aurora are built in and cannot be shared.
- Click Share my look.
- Enter a Name (2 to 40 characters) and choose an Icon.
- Check preview and readability. If a rule is not met, the editor says how many, and the look stays on your Mac.
- Copy share code puts the code on the clipboard. Share in the gallery submits the look: "Sent. It shows up in the gallery once someone has approved it."
What gets shared: the theme's colours including your own editor colours, font, size, line height, font weight, letter spacing, ligatures, cursor and bracket colours. Sharing only works once every rule is met and readability is at least 70.
Your submissions lists what you submitted, with the status waiting, in the gallery or not approved. Anything still waiting can be taken back with Withdraw.
What happens in the background
The editor loads the community list from the WebDonkey shop. Only the order and the page of the list go out, the search runs on your Mac. When you use a theme, only its ID goes out so downloads can be counted. Submitting and withdrawing work with your license key. A person looks at every submitted theme before it is approved. Who submitted a theme is never shown in the gallery.
Free and Premium
Browsing and searching are free. Use, Paste share code and Share my look are part of Premium. Arctic and Aurora are always there.
Troubleshooting
| What you see | What to do |
|---|---|
| "The gallery cannot be reached right now." | Check the connection and click Try again. |
| "This needs Premium." | Activate Premium, see License. |
| "This is not a share code." | Copy the whole code, without lines before or after it. |
| "This is a WebDonkey app theme. Paste it in WebDonkey under Themes." | The code belongs to WebDonkey's app themes, not to the editor. |
| "This share code comes from a newer version." | Update the editor, see Updates. |
| "This exact look is already in the gallery." | Nothing to do, the theme exists already. |
| "You already have three editor themes waiting for approval." | Wait until one is approved, or withdraw one. |
| "Too many attempts. Please wait a moment." | Wait a little and try again. |
| The name is refused | Allowed are letters, digits, spaces and . _ ' as well as the hyphen, 40 characters at most. |
See also
Font Free
Under Font you set the type for the code editor and for the terminal separately. A preview at the top with a code sample and a terminal sample shows the effect.
Where to find it
Settings › Font. The category has two groups: Editor and Terminal.
Editor group
| Field | What it does | Default |
|---|---|---|
| Typeface | The monospace fonts installed on this Mac. | Geist Mono (bundled) |
| Font size | 9 to 28 px | 13 px |
| Line height | As a multiple of the font size, 1.2 to 2 | 1.54 |
| Letter spacing | -1 to 3 px | 0 px |
| Font weight | Light, Regular, Medium, Semibold, Bold | Regular |
| Ligatures | Sequences like => or != become one glyph when the font has them. |
off |
Terminal group
| Field | What it does | Default |
|---|---|---|
| Typeface | as for the editor | Geist Mono (bundled) |
| Font size | 9 to 28 px | 13 px |
| Line height | 1 to 2 | 1.15 |
| Letter spacing | 0 to 4 px | 0 px |
| Font weight | as for the editor | Regular |
Ligatures exist for the code editor only.
How to do it
- Open Settings › Font.
- Under Editor, choose a Typeface. The list shows Geist Mono (bundled) and every monospace font on your Mac.
- Set size and line height and watch the preview at the top.
- Repeat under Terminal if the terminal should look different.
If a chosen font is no longer installed, the list shows it as "… (not installed)" and the editor shows Geist Mono.
The font size of menus, project tree and tabs is set under Appearance. Taking a theme from the Gallery also sets the values of the Editor group.
Tip
In the terminal you can change the size directly: the Terminal settings menu in the header of the terminal window offers Bigger font (⌘=), Smaller font (⌘-) and Default font size (⌘0, back to 13 px). See Terminal keys.
See also
Editor Free
The Editor category covers everything about the code editor: what it shows, how it indents, what happens as you type and save, and where a ⌘-click jumps. A project's .editorconfig takes precedence per file for indentation and the save actions.
Where to find it
Settings › Editor. The category has the groups Display, Indentation, Typing, On save and ⌘-click.
Display
| Setting | What it does | Default |
|---|---|---|
| Line numbers | On, Relative to the cursor or Off | On |
| Minimap | A small overview of the file on the right edge | off |
| Word wrap | Long lines wrap at the window edge | off |
| Ruler at column | A vertical line at this column, 0 to 240. 0 means no ruler. | 0 |
| Show whitespace | Never, At word edges, In the selection, At line ends, Always | In the selection |
| Colored bracket pairs | Matching brackets get the same colour | on |
| Sticky scroll | The line of the surrounding function or class stays at the top | on |
| Markdown toolbar | Buttons above Markdown files and notes: formatting, lists, checkboxes, tables | on |
| Code folding | Arrows in the margin fold blocks in and out | on |
| Cursor | Line, Block, Underline, Thin line, Block outline, Thin underline | Line |
| Cursor blinking | Smooth, Blink, Pulse, Expand, Not at all | Smooth |
| Git blame in the line | Shows faintly behind the cursor's line who last changed it, when, and the start of the commit message. Rest the mouse on it to see the whole commit. Lines not yet committed show "Not committed yet". More in Git blame in the line. | on |
Indentation
| Setting | What it does | Default |
|---|---|---|
| Tab width | 1 to 8 characters | 4 |
| Spaces instead of tabs | The Tab key inserts spaces | on |
| Take indentation from the file | Recognizes for every file how it is already indented | on |
Typing
| Setting | What it does | Default |
|---|---|---|
| Save automatically | Local files 1 s after typing and when the window loses focus. Remote files are saved with ⌘S only. | on |
| Emmet | div.card>h2+p*2 followed by Tab writes the HTML for it, in HTML, PHP, Twig and CSS/SCSS |
on |
On save
| Setting | What it does | Default |
|---|---|---|
| Remove trailing spaces | Not in Markdown (two spaces are a line break there) and never on the line you are typing on | off |
| End files with a line break | Adds a line break at the end of the file if it is missing | off |
| Format on save (⌘S) | Formats JSON, CSS, HTML and JS/TS when you save with ⌘S, never on autosave | off |
More about saving and the local history: Saving.
⌘-click
| Setting | What it does | Default |
|---|---|---|
| ⌘-click jumps to declarations | Templates, classes, imports, snippet and config keys open with ⌘-click, with ⌥⌘-click in a split | on |
| Find unknown paths by their ending | When no rule knows a reference, the editor offers files whose path ends the same way | on |
| Also search vendor/ | When nothing else matches, the editor indexes vendor/ once and searches it too |
on |
| Suggest blocks, snippet keys and config keys | Twig block names from the parent templates, snippet keys for the Twig filter trans, plugin settings for config() |
on |
| Own aliases | One rule per line, for example @Foo => packages/foo/views. Relative paths start at the project. |
empty |
Aliases for a single project go into .webdonkey-editor/aliases.json in the project folder.
See also
Terminal Free
The Terminal category sets up the editor's Terminal: which shell starts, what the cursor looks like, what a bell does and how ⌥ and ⌘K behave. The terminal's font is under Font.
Where to find it
Settings › Terminal. Some values are also in the Terminal settings menu in the header of the terminal window: ⌥ as Meta, ⌘K in the terminal, Renderer and the font size.
Settings
| Setting | What it does | Default |
|---|---|---|
| Connect Claude Code | claude in an editor terminal sees your selection and shows proposed edits in the editor as a diff, like in VS Code. The editor registers in ~/.claude/ide for this. More: IDE bridge. |
on |
| Shell | Applies to new terminals. The shells from /etc/shells are offered. |
Your login shell |
| Cursor | Block, Line or Underline | Line |
| Cursor blinks | The cursor blinks | on |
| Scrollback | This many lines stay available when you scroll up, 1000 to 100000 | 10000 |
| Bell | Notification when the window is in the background or Off. A program rings, for example, when Claude is waiting for you. More: Notifications. | Notification when the window is in the background |
| Option as Meta | Automatic: ⌥ with letters becomes Meta (Claude's ⌥P, ⌥T …), characters like @, [ and € stay typeable. Also Always and Never. | Automatic |
| Copy on select | Selected text goes to the clipboard right away | off |
| ⌘K in the terminal | Command palette or Clear terminal | Command palette |
| Renderer | WebGL or DOM. Switch to DOM if text in the terminal looks garbled. | WebGL |
| Terminal fills the editor area when no tab is open | With no file or other tab open, the terminal uses the whole editor area. The first tab that opens puts it back at its usual size. | on |
How to: use a different shell
- Open Settings › Terminal.
- Under Shell, choose for example
/bin/bash. - Open a new terminal. Running terminals keep their shell.
See also
Features Free
Under Features you switch tool windows and features on and off, choose what the status bar shows, and decide how the editor starts and handles updates. At the very top you see whether the desktop widgets are getting data.
Where to find it
Settings › Features. If you open a hidden tool window, it says "… is hidden in the settings." with the link Open settings, which leads right here.
Desktop widgets
The Desktop widgets block shows whether the widgets on the macOS desktop get data, and offers Open Full Disk Access when access is missing. More: Widgets and Full Disk Access.
Tool windows
"Hidden means: not loaded, no icon in the stripe, no shortcut." A switched-off window polls nothing and frees its shortcut. Every tool window except the project tree can be switched off:
AI, Git, Git Graph, Remote, Database, Mail, Notes, Claude, WebDonkey, Find, Problems & Output, Terminal, Mission Control, MCP and Launcher.
All are on by default. AI off means: no AI window, no chat, no suggestions while typing, no AI actions in the code. Launcher off means: no launcher window, no ▶ in the project tree, no detection, no shortcuts. With Problems & Output off, launchers write their output into a terminal instead of an output channel.
Status bar
One switch each, all on by default:
| Switch | What the status bar shows |
|---|---|
| Git branch | the current branch |
| WebDonkey and the project's site | whether WebDonkey is running and which site belongs to the project |
| Open in browser | a link to the project's site while it runs |
| Update notice | Update with the version number while an editor update is waiting |
| AI ghost text | the state of the suggestions while typing |
| Claude | Claude's use of the 5-hour and the weekly limit, such as ✳ 64 % · W 18 %, plus a dot while a claude is connected to the editor |
| Who last changed the line | author and time of the cursor's line |
| Cursor, language and indentation | line and column, language mode, indentation |
| Free notice | Free while no Premium is active |
Start
| Setting | What it does | Default |
|---|---|---|
| Reopen the projects that were open last | Off: the editor starts with the start screen. | on |
| Sites from WebDonkey on the start screen | Lists WebDonkey's sites on the start screen to open | on |
App
| Setting | What it does | Default |
|---|---|---|
| Keep running when the window is closed | Terminals and Claude sessions keep going. The Dock icon or wd edit brings the window back. ⌘Q quits. |
on |
| Check for updates automatically | Once at start, then every 10 minutes. Installing always waits for your click. | on |
| Announce new versions in a window | Closing the window skips only that version; the next one is announced again. Off: updates still show in the changelog and the status bar. | on |
If you quit with ⌘Q while files are unsaved or programs still run in terminals, the editor asks first. More about updates: Updates.
More features
"Here too: switched off, none of it is loaded."
| Switch | What it does | Default |
|---|---|---|
| Open files without text in a viewer | Images, PDFs and other binary files open in their viewer instead of the "binary file" notice. | on |
| Services in the editor | Status bar item, terminal badge, checking on save and the service configs in the WebDonkey window. The details are under Services. | on |
Git
| Setting | What it does | Default |
|---|---|---|
| Pull strategy | Fast-forward only (git pull --ff-only), Rebase (git pull --rebase) or Merge (git pull --no-rebase). Fast-forward never changes your commits and asks when both sides have new ones. | Fast-forward only |
| Commit message history | How many recently used messages the Git window offers, up to 50. 0 keeps none. | 15 |
| Group the worktrees of a repository | Worktrees of the same repository appear once in every repository picker and as one group in the Git window. | on |
| Show changes as | Tree (follows the folders) or List (every file with its path) | Tree |
| PhpStorm shortcuts everywhere | ⌘K Commit, ⇧⌘K Push, ⌘T Pull outside the Git window too. The command palette is then on ⇧⌘A and ⇧⇧. | off |
More: Git.
See also
AI Free & Premium
The AI category decides what the editor uses for AI: local models on your Mac, Claude Code, or both. Here you set which server and how much memory the local AI uses, what AI: Explain and AI: Adjust in the code run on, how suggestions while typing behave and where Start Claude takes you.
Where to find it
Settings › AI. The category has four groups: Local AI, AI in the code, Suggestions while typing and Claude. The AI window itself is switched on and off under Features.
Local AI
| Setting | What it does | Default |
|---|---|---|
| Own server URL | An OpenAI-compatible server, e.g. http://127.0.0.1:5000. Only this Mac unless LAN hosts are allowed. |
empty |
| Allow LAN hosts | Lets the own URL point to another computer in your network. The editor warns once. Internet addresses are never used. | off |
| Memory budget (model + context) | How much memory the model may use in total. Whatever the weights leave over becomes context. Automatic, a fixed value or Custom… in MB or GB. | Automatic |
| CLI | Which CLI Agent starts in the AI window: Aider, Qwen Code, Codex CLI (--oss), Goose, OpenCode or Crush. If it is missing, WebDonkey installs it. Premium. | Aider |
| Never send as context | File patterns that chat and ghost text never read, one per line. By default the list holds .env, .env.*, *.pem, *.key, id_rsa*, auth.json, .npmrc, credentials* and more. |
list |
AI in the code
The code's context menu has AI: Explain and AI: Adjust. The first time, the editor asks what the AI should run on. You change that choice here.
| Setting | What it does | Default |
|---|---|---|
| Explain and adjust with | Local AI, Claude Code or Ask next time (asks again) | Ask next time |
| Local model | A model, or a chat configuration that brings memory and specialist along. The AI window's model uses whatever model is selected in the AI window. | The AI window's model |
| Memory for the local model | Applies to a chosen model. A chat configuration brings its own memory. | Automatic |
| Claude access | Claude sign-in (/login) uses your Claude subscription, or you pick your own API key from Claude access. The pencil next to it (Manage Claude access) adds accesses. The key is kept only in the macOS keychain. | Claude sign-in (/login) |
More: AI.
Suggestions while typing
A local model suggests the rest of the code in grey as you type. Tab takes it, ⌘→ word by word, Esc drops it. The whole group is part of Premium.
| Setting | What it does | Default |
|---|---|---|
| Suggestions while typing | switches the suggestions on and off | on |
| Model | Empty: the smallest installed completion model that fits this Mac | empty |
| Wait after typing | The editor asks only after this pause, 100 to 1000 ms. Every key press cancels the pending request. | 250 ms |
| Longest suggestion | Upper limit in tokens, 32 to 256. Suggestions stop at an empty line anyway. | 96 |
| Pause on low battery | Below 20 % on battery no requests go out | on |
More: Suggestions while typing.
Claude
Open Claude in decides where Start Claude, ⌘⎋ and Resume take you:
- Automatic: Mission Control with Premium, the terminal without.
- Editor terminal: always the terminal.
- Mission Control: Premium only.
The conversation always runs in the editor terminal. Mission Control shows it together with its agents. The default is Automatic.
What happens in the background
Local AI only talks to servers on this Mac, and with Allow LAN hosts also to computers in your network. Files matching Never send as context are read neither by the chat nor by the suggestions. With Claude Code, what you ask and the selected code go to Anthropic.
Free and Premium
Local AI, AI in the code and Open Claude in are free. Suggestions while typing, the CLI for Agent and the Mission Control option need Premium.
See also
Files & formats Free
The Files & formats category decides which file types use the editor as your default editor in Finder, how much of images and documents the local history keeps, and how images are zoomed and saved.
Where to find it
Settings › Files & formats. Whether images, PDFs and other binary files open in a viewer at all is switched under Features with Open files without text in a viewer.
Default editor
The Default editor block sits at the top. There you tick groups of file types that should open in WebDonkey Editor when you double-click them in Finder, and see for how many types the editor is the default already. The details are on the Default editor page.
Local history
| Setting | What it does | Default |
|---|---|---|
| Keep binary files in the local history up to | Every save of an image or document keeps the previous state, up to this size, 0 to 200 MB. 0 turns it off. | 50 MB |
How to view and restore earlier states: Saving.
Images
| Setting | What it does | Default |
|---|---|---|
| Pixel grid when zoomed in | From 800 % on, a fine grid shows each pixel. | on |
| Default quality for JPEG and HEIC | Used when compressing or converting an image, 10 to 100 %. | 82 % |
What happens in the background
The local history lives in ~/Library/Application Support/app.webdonkey.editor/history on your Mac. It can contain files with credentials too, such as .env. Deleting the app does not remove this folder.
See also
Default editor Free
With the Default editor you decide which file types open in WebDonkey Editor when you double-click them in Finder. You choose groups of file types instead of everything at once, because macOS asks once for every file type. HTML files stay with your browser.
Where to find it
- Settings › Files & formats, block Default editor
- Shortly after start the editor asks once: "Make WebDonkey Editor your default editor?"
- When you open a file whose type does not open in the editor yet, a bar appears above it.
How to do it
- Open Settings › Files & formats.
- On the right of the Default editor block you see the state: "Not set as the default yet.", "Default for … of … file types." or "The editor is the default for all … file types."
- Tick the groups you want. Each group tells you up front how many macOS prompts it costs. The total is shown below the list.
- Click Apply selection.
- Confirm the macOS prompts, one per file type.
- The editor reports "Done: these file types now open in WebDonkey Editor when you double-click them."
If you declined a prompt or it is still open, the editor reports how many types it took. Confirm an open prompt in macOS then. When you come back to the editor, the block reads the state again.
The groups
| Group | Extensions |
|---|---|
| Essentials | .txt .text .md .markdown .json .yaml .yml .xml .env .conf .ini .toml |
| Configuration | .jsonc .json5 .cfg .properties .neon .tf |
| Web and styles | .css .scss .sass .less .js .mjs .cjs .jsx .ts .tsx .mts .cts .vue .svelte .astro .twig .tpl .php |
| Scripts and SQL | .sh .bash .zsh .fish .py .rb .pl .lua .sql |
| Programming languages | .c .h .cpp .hpp .cc .m .cs .go .rs .java .kt .kts .swift .dart .scala .groovy .gradle |
| Docs, diffs and schemas | .mdx .rst .adoc .diff .patch .graphql .gql .proto |
What counts is file types, not extensions: .yml and .yaml are one type and cost one prompt. A group the editor has completely stays ticked and greyed out with already in the editor. Groups for which macOS knows no matching type are left out.
The question at start
Shortly after start the editor asks once, as long as the Essentials group is not fully its own, whether text, Markdown, JSON, YAML and XML files as well as config files should open here on double-click. The question also names the number of macOS prompts. Set as default takes the group, No, thanks leaves everything as it is. Any answer, Esc included, ends the question for good. It waits until you pause typing and no other dialog is open.
The bar above a file
When you open a local file whose type is in one of the groups but does not open in the editor yet, a bar appears above it: "Double-clicking .php files in Finder does not open them in WebDonkey Editor yet." (with the file's extension).
- Always open with the editor: makes the editor the default for just this type. macOS asks once.
- Don't ask again: the bar never comes back for this type.
- Dismiss (the X): the bar goes away until the next start.
The bar appears once per type and start, above the first matching file.
What happens in the background
The editor registers with macOS as the default app for the chosen file types. That is the same assignment you change in Finder in a file's info window under "Open with". If you change it there, the block notices as soon as you come back to the editor. Types the editor already has are left untouched.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| "Only available in the installed app." | The editor is not running as an installed app | Start the editor as an installed app |
| "Applied: … of … file types. If a macOS prompt is still open, confirm it there." | macOS is still waiting for your answer, or you declined | Confirm the macOS prompt or apply the group again |
| "Default editor not set: …" | macOS refused the change | Check the message and try again |
| HTML files open in the browser | Intended, HTML is in no group | Choose the editor in Finder via "Open with" |
See also
Search Free
The Search category sets up the search window: which files it searches, where it stops, how it shows hits and from when it asks before replacing. The values apply to every search in local projects. Search on servers is set under Remote.
Where to find it
Settings › Search, groups Files, Limits, Search window, Replace and History.
Files
| Setting | What it does | Default |
|---|---|---|
| Default excludes | Patterns as in .gitignore, one per line. vendor and node_modules can be switched on in the search window. |
node_modules, vendor, var/cache, .idea, *.min.js, *.min.css, *.map |
| Respect .gitignore | What git ignores is not searched either. | on |
| Search hidden files | Files like .env and .htaccess |
on |
| Follow symlinks | The search also walks through linked folders | off |
Limits
| Setting | What it does | Default |
|---|---|---|
| Largest file searched | 1 to 100 MB. Larger files are skipped and counted. | 5 MB |
| At most this many hits | 100 to 100000 | 10000 |
| Skip binary files | Images, archives and other binary files stay out | on |
| Encoding | Automatic (UTF-8, otherwise Latin-1, just like the editor), UTF-8 or Latin-1 | Automatic |
Search window
| Setting | What it does | Default |
|---|---|---|
| Search while typing | Off: the search starts on Enter | on |
| Pause before the live search | 0 to 2000 ms | 150 ms |
| Context lines in the preview | 0 to 50. 0 always shows the whole file. | 4 |
| Group hits | Folder → file → line or Flat | Folder → file → line |
Replace
| Setting | What it does | Default |
|---|---|---|
| Ask before replacing from | Number of files from which replace asks first, 1 to 1000 | 50 |
History
| Setting | What it does | Default |
|---|---|---|
| Keep search history | The last 50 searches with their options, recalled with ⌃↓ | on |
See also
Remote Free & Premium
The Remote category applies to working with servers in the Remote tool: notices about the risks, the version status of server software, mappings between project and server, and search on the server.
Where to find it
Settings › Remote. At the top are Remote notices and Fetch version status, below them the groups Mappings and Search on the server.
Notices and version status
| Setting | What it does | Default |
|---|---|---|
| Remote notices | Shows a notice about the risks on Remote pages and in dialogs that connect to a server or write or delete there. Got it and Don't show again on the notice hide it, this switch brings it back. The questions before deleting and overwriting stay in any case. | on |
| Fetch version status | Asks endoflife.date, php.net, nodejs.org and nginx.org whether PHP, Node.js, web servers and databases still get updates, and shows marks for it in the Remote tool (Server software, Fetch locally). Off: no requests, no marks. | on, otherwise the setting in WebDonkey |
As long as you have not changed Fetch version status here yourself, the editor follows the setting of the same name in WebDonkey. If you switched it off there, it is off here too. Once you flip the switch in the editor, your choice in the editor applies.
Mappings
A mapping links a local folder to a folder on a server. More: Sync.
| Setting | What it does | Default |
|---|---|---|
| Always show the preview | Also before uploading or downloading a single file without a conflict | off |
| Mark mapped folders in the trees | A tinted background and a small mark on folders and files paired with a server. The tooltip says which server and where. | on |
Whether a file uploads on save is set on the mapping itself, not here.
Search on the server
| Setting | What it does | Default |
|---|---|---|
| Leave out on the server | Folders and patterns that a server search never walks. A name means any folder of that name, a path like var/cache that folder at any depth. The vendor chip in the search window adds vendor back. |
.git, node_modules, vendor, var/cache, var/log, public/media, public/thumbnail, files |
| Ask when the load is above | Before every search the editor checks the server's load. Above this value times the number of cores it asks before searching. 0.1 to 8. | 0.8 |
| Hit limit | The search stops here and ends the process on the server, 100 to 2000 | 2000 |
More: Search on the server.
What happens in the background
For the version marks only product names go out, for PHP the major version, never sites or servers. The server search runs over SSH on the server and ends at the hit limit at the latest.
Free and Premium
Remote notices and Fetch version status are free. Mappings and Search on the server are part of Premium, like the Remote tool itself.
See also
Services Free
The Services category sets how WebDonkey's services show up in the editor: PHP and Node versions in the terminal, services in the status bar, and checking config files on save. All of this only works when WebDonkey is installed on this Mac. More: WebDonkey.
Where to find it
Settings › Services. The whole category is switched off under Features with Services in the editor. Off means: no status bar item, no terminal badge, no checking on save and no service configs in the WebDonkey window.
Settings
| Setting | What it does | Default |
|---|---|---|
| The site's services in the status bar | One dot per service, green or red. A click offers start, stop, restart and follow log. | on |
| Check service configs on save | WebDonkey checks nginx, Apache, Caddy and PHP after saving and then offers to reload. | on |
Group Terminal:
| Setting | What it does | Default |
|---|---|---|
| WebDonkey shims in editor terminals | php, node, composer and co. use the site's version inside its project folder. Applies to new terminals. Your shell profile stays as it is. |
on |
| PHP, Node and site badge in the terminal | Shows which versions apply in the current folder. A click changes the site's version. | on |
What happens in the background
With the shims, the editor puts a folder of its own in front of the search path of new terminals, so php and node pick the site's version. It does not touch your .zshrc or .bashrc.
See also
Shortcuts Free
The Shortcuts category lists every shortcut of the editor in one place, sorted by command. Keys assigned twice are marked. The list is for looking things up: shortcuts cannot be reassigned here.
Where to find it
Settings › Shortcuts. If you search the settings for "shortcuts", the whole list appears; if you search for a command, the list shows only the matching rows.
How to do it
- Open Settings › Shortcuts.
- Type a command name or a key into Search command or shortcut, for example "Commit" or "⇧⌘".
- Every row shows the command and its shortcut on the right. With no match you see "No command matches."
- If a key is assigned more than once, the row says "Also assigned to:" followed by the other commands.
Double assignments are often intended. A shortcut only acts where it is needed, for example ⌘K in the terminal or in the Git window. Hiding a tool window under Features frees its shortcut.
The most important shortcuts
| Key | Action |
|---|---|
| ⌘P | Open file |
| ⌘K, ⇧⌘A | Command palette |
| ⇧⇧ | Search everywhere |
| ⌘E | Recent files |
| ⌘O | Open folder |
| ⌘, | Settings |
| ⇧⌘F, ⇧⌘R | Find in files, replace in files |
| ⌘1 | Project |
| ⌘2 | Remote |
| ⌘3 | Claude |
| ⌘4 | WebDonkey |
| ⌘5 | Database |
| ⌘6 | Problems & Output |
| ⌘7 | MCP |
| ⌘9 | Git |
| ⌥F12 | Terminal |
| ⇧⌘I | AI |
| ⌘⎋ | Open the project's Claude terminal |
| ⌥⌘K | Send selection to Claude |
| ⌃R | Run last launcher |
| ⌃⇧R | Run current file |
| ⌘W, ⇧⌘T | Close tab, reopen closed tab |
| ⌘\ | Split editor right |
| ⇧⌘' | Maximize tool window |
| ⇧⌘F12 | Hide all tool windows |
Shortcuts with ⌃ are left out of the menu on purpose, so Claude Code and programs in the terminal keep them. In the terminal itself ⌃R belongs to the shell, for example for history search.
See also
Advanced Free
Under Advanced you back up your settings as a file, move them to another Mac or reset everything to the defaults.
Where to find it
Settings › Advanced, with the rows Export settings, Import settings and Reset everything.
How to: move your settings to another Mac
- Under Export settings, click Export ….
- Choose a place. The editor suggests
webdonkey-editor-settings.json. - The editor reports "Saved:" with the path.
- Copy the file to the other Mac.
- There, under Import settings, click Import … and choose the file.
- The editor reports how many settings it applied and, if some were dropped, how many were unknown and how many rejected.
Export
The file holds everything that differs from the default, as JSON. Whatever is at its default is left out, so a later new default still reaches you after an import. The theme itself is not included, it lives in WebDonkey's or the editor's database.
Import
- Unknown entries are dropped.
- Values outside their bounds are rejected, not bent into shape.
- Settings that belong to Premium are only taken with Premium. Without it they count as rejected.
- If the file is not a settings file of the editor, you see "This is not a settings file of the editor."
Reset everything
Reset … puts every setting back to its default. The editor asks first: "Reset all settings to their defaults?" Afterwards it says "All settings are back at their defaults." Projects, terminals and themes stay.
To reset a single category, use the arrow next to its heading. To reset a single setting, use the arrow at the end of its row.
See also
About Free
The About category shows the editor's version, whether WebDonkey is connected and which license applies. From here you reach the changelog, the open-source licences and the legal texts. You need this for support requests and to check why something is Free or Premium.
Where to find it
- Settings › About
- Menu WebDonkey Editor › About WebDonkey Editor shows the short macOS info window with the version.
The rows
| Row | What it shows |
|---|---|
| License | Only without WebDonkey, at the very top: this is where you enter your license key. See License. |
| WebDonkey Editor | The version number, plus Open-source licences and Changelog & Updates |
| Legal | Terms of use, Privacy, Imprint, Security and All legal texts open the Legal tab |
| WebDonkey | Whether and how the editor is connected to WebDonkey, see below |
| License | Only with WebDonkey: Premium or Free, plus the shortened license key |
The WebDonkey row
| What it says | Meaning |
|---|---|
| Connected, with WebDonkey's data folder below | WebDonkey is installed. The editor uses its database, license, sites and services. |
| Not installed, with "The editor runs on its own. Sites, local services and backups need WebDonkey." | WebDonkey is not on this Mac. The editor uses a database of its own and manages the license itself. |
| Without WebDonkey, asking you to update WebDonkey | WebDonkey is older than this editor needs. Until it is updated, editor, files, terminal and git work. Once WebDonkey is updated, the editor connects by itself. |
| Without WebDonkey, with "Editor, files, terminal and git work. Remote, database and themes unlock with WebDonkey." | The editor can open neither WebDonkey's database nor one of its own. |
Open-source licences
Open-source licences opens a window with every open-source component by others inside the editor, with their full licence texts. Filter at the top with Search component or licence …, and see how many components are shown. The editor is free to use, but it is not open-source software.
Free or Premium?
The license decides whether Premium is active. With WebDonkey that is WebDonkey's license, without WebDonkey the key you enter in the editor. Without Premium the status bar shows Free (can be switched off under Features with Free notice). For prices see webdonkey.io/pricing.
See also
License Free & Premium
WebDonkey Premium applies in WebDonkey and in the editor. If WebDonkey is installed on your Mac, WebDonkey manages the license and the editor takes it over. Without WebDonkey you enter your license key in the editor itself, and the editor checks the license on its own. That way you can use Premium in the editor without WebDonkey at all.
Where to find it
- Without WebDonkey: Settings › About, the License row at the very top.
- If you open a Premium tool window without WebDonkey, Enter license key takes you straight there.
- With WebDonkey, Settings › About only shows whether Premium or Free applies. You then enter the key in WebDonkey under Settings › General in the License section, see WebDonkey settings.
How to: activate Premium without WebDonkey
- Copy your license key from your customer account in the WebDonkey shop. It looks like
WD1-XXXXX-XXXXX-XXXXX-XXXXX. - Open Settings › About.
- Paste the key into the field under License.
- Click Activate or press Enter. While it checks, the button says Activating….
- Once it says Premium active, the Premium features are unlocked.
The editor first checks the key for typos on your Mac and only then asks the license server.
What the row shows
| State | Meaning |
|---|---|
| Free | No key entered |
| Premium active | Everything is fine |
| Premium (offline) | The license server could not be reached for a while. Premium stays active until you are back online, at most until the date shown. |
| Active on another device | The license is in use on another Mac right now. The editor names the device and when it was last seen. Quit WebDonkey there and the seat moves here instantly. Otherwise it transfers automatically once that device has been silent for about 15 minutes. |
| License conflict | Several devices claim the license at once. It unlocks again automatically once only one device keeps using it. |
| License revoked | The license was revoked, for example after a refund. Contact support if you think this is wrong. |
| Subscription expired | Premium unlocks again automatically with the next successful payment. |
| Checking… | A check is running |
With a key entered, below it you see This device: with your Mac's name, Valid until with a date, and three buttons:
- Check now: asks the license server right away.
- Remove license from this device: frees the seat and removes the key from the editor.
- Manage licenses: opens your licenses in the customer account in the browser.
What works without WebDonkey
With your Premium key the editor offers, even without WebDonkey, among others Remote with mappings and sync, databases on servers, theme presets and the gallery, notes, suggestions while typing and the AI specialists. Local database connections you create in the editor itself are free anyway.
You need WebDonkey itself for everything tied to its sites and local services:
- the WebDonkey window with sites, services and shims,
- the databases of WebDonkey's sites,
- the mailboxes in the Mail window,
- backups and scheduled tasks on servers.
If you open one of these without WebDonkey, the editor says it needs WebDonkey on this Mac.
Installing WebDonkey later
Once WebDonkey is installed and has started once, the editor connects to it on its next start and hands over, once, whatever WebDonkey does not have yet:
- the license key, if WebDonkey has none,
- your own themes and the theme choice, as long as WebDonkey still wears its default,
- your server connections with password, colour, start folder, homepage and the servers' database entries.
The editor overwrites nothing WebDonkey already has. Sync pairs and the notes' vaults do not move over. From then on WebDonkey manages the license, and the License row for entering a key disappears from the editor.
What happens in the background
Without WebDonkey the editor creates a database of its own in its app storage. It holds license, server connections (passwords encrypted), themes and settings. The editor checks the license at start, then about every ten minutes and when quitting. With WebDonkey both apps count as one device and share one seat.
Free and Premium
What Premium costs is on webdonkey.io/pricing.
Troubleshooting
| What you see | What to do |
|---|---|
| The key does not look like a valid license key | Check for typos, best copy the key from the customer account |
| "The shop doesn’t know this key. Copy it from your shop account." | Copy the key again from the customer account |
| Activation failed, asking whether the internet connection is up | Check the connection and click Activate again |
| Activate stays grey | The key is still too short, it starts from 10 characters |
| With WebDonkey there is no input field | Intended, with WebDonkey you enter the key in WebDonkey |
See also
Legal Free
Legal opens as a tab in the editor with the legal texts for WebDonkey Editor in a readable short form: imprint, terms of use, privacy, withdrawal, accessibility and security. From each section you reach the full version on the website.
Where to find it
- Menu Help › Legal
- Command palette: Legal: imprint, terms of use, privacy
- Settings › About, row Legal: Terms of use, Privacy, Imprint, Security or All legal texts. The first four open the tab at the matching section.
Layout
Choose the section at the top: Overview, Imprint, Terms of use, Privacy, Withdrawal, Accessibility and Security. Below it is the short version. At the end of every section except the overview there is a note that the version on the website governs, because an installed app can be a release behind, and the link Open on shop.webdonkey.io. With a German interface it opens the German version, otherwise the English one.
- Overview: what applies, and the Open-source licences button. The editor is covered by the same terms and privacy policy as WebDonkey.
- Terms of use: Free and Premium, one key for one device at a time, what applies without internet, what happens when a subscription ends and what you are responsible for.
- Privacy: when the editor talks to the internet and which data it keeps on your Mac, see below.
- Withdrawal: the right of withdrawal for the Premium subscription and how to cancel.
- Accessibility: what works already and what is still being worked on.
- Security: how to report a vulnerability, with the button Report a vulnerability by email. It opens a new mail with a fitting subject in your mail app.
What the privacy summary says
The editor contains no advertising, analytics or tracking. It talks to WebDonkey's servers in four cases:
- Updates and release notes: shortly after start and then every 10 minutes. You switch off the automatic check under Features.
- License check: only with a license key entered. Without WebDonkey the editor checks by itself, see License.
- Documentation: when you open the Documentation.
- Theme gallery: when you open the Gallery in the settings.
On top of that come connections you trigger yourself: to your servers, to your Git server, links in the browser. For the version marks at the server software and in fetch locally, the editor asks endoflife.date and the websites of PHP, Node.js and nginx. Only product names go out. You switch that off under Remote with Fetch version status.
If a note embeds images or other content by web address, the notes view loads it straight from that server, which then learns your IP address. You switch that off per vault with "Load content from the web", see Notes.