Buy

Settings

Free & Premium

The 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

  1. Open Settings › Appearance. The Theme card at the top shows a large swatch of the current theme.
  2. 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.
  3. 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

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

  1. Open Settings › Font.
  2. Under Editor, choose a Typeface. The list shows Geist Mono (bundled) and every monospace font on your Mac.
  3. Set size and line height and watch the preview at the top.
  4. 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

  1. Open Settings › Terminal.
  2. Under Shell, choose for example /bin/bash.
  3. 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

  1. Open Settings › Files & formats.
  2. 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."
  3. Tick the groups you want. Each group tells you up front how many macOS prompts it costs. The total is shown below the list.
  4. Click Apply selection.
  5. Confirm the macOS prompts, one per file type.
  6. 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

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

  1. Open Settings › Shortcuts.
  2. Type a command name or a key into Search command or shortcut, for example "Commit" or "⇧⌘".
  3. Every row shows the command and its shortcut on the right. With no match you see "No command matches."
  4. 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

  1. Under Export settings, click Export ….
  2. Choose a place. The editor suggests webdonkey-editor-settings.json.
  3. The editor reports "Saved:" with the path.
  4. Copy the file to the other Mac.
  5. There, under Import settings, click Import … and choose the file.
  6. 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

  1. Copy your license key from your customer account in the WebDonkey shop. It looks like WD1-XXXXX-XXXXX-XXXXX-XXXXX.
  2. Open Settings › About.
  3. Paste the key into the field under License.
  4. Click Activate or press Enter. While it checks, the button says Activating….
  5. 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

Cookie preferences

This website uses cookies to ensure the best experience possible. Your choice applies to webdonkey.io and the shop at shop.webdonkey.io. More information...

Technically required

Cookies required for this website to function:

Always on
WebDonkey
WebDonkey
Provider: BuI Hinsche GmbH, Neumarkt 7, 06712 Zeitz, Germany
Purpose: Your consent, colour scheme and language for website and shop, price switches; with wd_debug in the address, the measurement events in the developer console for troubleshooting
Cookies and storage: Cookie wd_consent on .webdonkey.io, shared with shop.webdonkey.io (12 months); cookies wd_theme and wd_lang on .webdonkey.io, shared with shop.webdonkey.io, only when you switch colour scheme or language yourself (365 days); localStorage wd:consent, wd:theme, wd:lang; sessionStorage wd:acc, wd:term, wd:debug (only with wd_debug in the address; until the tab closes)

Statistics

Shows us which pages and products people look at on webdonkey.io and in the shop, where visitors come from and how they get to a purchase (with order number, amount and products, without name or email address). Provider: Google. Transfer to the USA possible (EU-US Data Privacy Framework). Your choice applies to webdonkey.io and the shop together.

Google Tag Manager, Google Analytics 4
Google Tag Manager
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Loads the services you agreed to, here and in the shop. Sets no cookies of its own.
Cookies and storage: none
Privacy policy
Google Analytics 4
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Usage statistics: page views, clicks, scroll depth, sources, devices, load times; in the shop also basket, checkout, purchases, registration and sign-in
Cookies and storage: _ga, _ga_<ID> (2 years)
Privacy policy

Marketing

Measures whether our ads on Facebook, Instagram and TikTok lead to visits and downloads on webdonkey.io and to registrations and purchases in the shop, and builds audiences for ads. Providers: Meta and TikTok, with whom we are jointly responsible for this. With this consent Google may also set advertising cookies (_gcl_…). Transfer to the USA and other countries outside the EU possible. Your choice applies to webdonkey.io and the shop together.

Google Tag Manager, Meta Pixel (Facebook, Instagram), TikTok Pixel
Google Tag Manager
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Loads the services you agreed to, here and in the shop. Sets no cookies of its own.
Cookies and storage: none
Privacy policy
Meta Pixel (Facebook, Instagram)
Provider: Meta Platforms Ireland Limited, Merrion Road, Dublin 4, D04 X2K5, Ireland
Purpose: Ad measurement and target groups on Facebook and Instagram, also in the shop (basket, checkout, purchases, registration)
Cookies and storage: _fbp (3 months), _fbc (3 months, only if you arrive through an ad), fr on facebook.com (3 months)
Privacy policy
TikTok Pixel
Provider: TikTok Technology Limited, 10 Earlsfort Terrace, Dublin, D02 T380, Ireland
Purpose: Ad measurement and target groups on TikTok, also in the shop (basket, checkout, purchases, registration)
Cookies and storage: _ttp, _tt_enable_cookie (13 months)
Privacy policy