Buy

Window layout

Free

A WebDonkey Editor project window consists of the code area in the middle and the tool windows around it: Project, Git, Terminal, Claude, Database and all the others. Every tool window has an icon in a narrow stripe at the left or right edge. Clicking it shows or hides the window. The title bar with the project menu sits on top, the status bar at the bottom. You decide how the tools are arranged, and the editor remembers it.

What you do here

Parts of the window

Part What is there
Title bar the project menu with the project name on the left, a search field for Search everywhere in the middle, the launcher bar, the WebDonkey button and the Free notice on the right
Stripes one stripe on each side with the icons of the tool windows
Tool windows left, right and at the bottom, up to two per side, stacked or side by side
Code area your tabs, split as often as you like (Tabs, Splits)
Status bar branch, WebDonkey and site, cursor, indentation, line endings, encoding and language of the active file

Out of the box

Place Tools
Left top Project
Left, below Remote, Git, Notes
Right top Claude, MCP, WebDonkey, Database, AI
Right, below Mail
Bottom left Terminal, Mission Control, Find, Problems & Output, Git Graph
Bottom right Launcher

A project you open for the first time shows Project and Terminal. While no tab is open, the terminal takes up the whole code area. The first tab that opens sends it back to its place at the bottom. You can switch this off under Terminal in the settings: Terminal fills the editor area when no tab is open.

Tip: Esc takes you from a tool window back to the code. Not in the terminal: there, Esc belongs to the program that is running.

Free and Premium

The window layout is free. The Remote and Notes tool windows are part of WebDonkey Premium. Without Premium they show the notice "This tool window is part of WebDonkey Premium." and the link See Premium instead of their content. Prices are on webdonkey.io/pricing.

Stripes and icons Free

To the left and right of the code area there is a narrow stripe of icons. Each icon belongs to a tool window. One click opens the window at its place, a second click hides it again. The stripes, their shortcuts and the settings decide which tools you see.

Where to find it

The stripes are always there, even without an open project. Hovering an icon shows the tool's name and, if it has one, its shortcut.

How to do it

  1. Click an icon, for example Git. The tool window opens at its place and the icon is highlighted.
  2. Work in the window. Esc takes you back to the code.
  3. Click the icon again or press its shortcut to hide the window.

How a stripe is built

Each stripe has up to four groups, separated by thin lines:

Group Where it opens
top in the upper half of this side (left out of the box: Project)
below in the lower half of this side (left out of the box: Remote, Git, Notes)
at the foot also in the lower half; the group sits at the bottom of the stripe and grows upwards
at the very bottom, below the line in the bottom dock: the left stripe shows its left half, the right stripe its right half

An empty group is invisible. It only appears, as a dashed spot to drop onto, while you drag an icon (Places and window types).

What an icon tells you

  • Highlighted: the tool is open right now.
  • Small dot at the bottom right: the tool lives as a tab in the code area or in a window of its own. Clicking brings that tab or window to the front.
  • Mission Control opens as a tab on every click, whichever group its icon sits in.

Tool window shortcuts

Tool Shortcut
Project ⌘1
Remote ⌘2
Claude ⌘3
WebDonkey ⌘4
Database ⌘5
Problems & Output ⌘6
MCP ⌘7
Git ⌘9
Terminal ⌥F12
AI ⇧⌘I

These shortcuts also work while the focus is in the terminal, so ⌥F12 hides the terminal from inside it. Mission Control, Git Graph, Find, Mail, Notes and Launcher have no shortcut of their own. ⇧⌘F opens Find in files in the Find window.

Other ways to reach every tool:

  • View › Tool Windows in the menu bar: all tools, the visible ones with a check mark (Menus)
  • Command palette (⌘K): commands such as Show/hide Git
  • Search everywhere (⇧⇧): the Tools category

Switching tools off

What you never need, you switch off under Settings › Features, group Tool windows. Hidden means: not loaded, no icon in the stripe, no shortcut, no menu entry. This works for every tool except Project. If you switch off a tool that is open, it disappears at once from its place and from the code area. A window of its own then only shows the notice "… is hidden in the settings." See Features.

Free and Premium

Remote and Notes are part of WebDonkey Premium. Their icons stay in the stripe without Premium; the window then shows a notice with See Premium. When the editor runs without WebDonkey, there is also Enter license key: you enter your Premium key right in the editor, you don't need WebDonkey itself for that.

Troubleshooting

What you see Why What to do
An icon is missing the tool is switched off under Settings › Features switch it back on there
A shortcut does nothing the tool is switched off, or a dialog covers the window check the setting, close the dialog
A window says "… is hidden in the settings." it was switched off while it was open Open settings and switch it on

See also

Places and window types Free

Every tool has a fixed place: a side (left, right or bottom) and a half of that side. You change the place by dragging or through a menu. Independently of that, a tool can appear in three ways: docked at the edge, as a tab between your files, or as a macOS window of its own, for example on a second display.

Where to find it

  • Place: right-click an icon in the stripe
  • Window type: the ⋯ button (Options) in the header of a tool window, or right-click the header

How to do it

Moving an icon

  1. Pick up the icon in the stripe and drag it into another group or between two icons. A line marks the spot; empty groups appear as dashed spots.
  2. Let go. The tool now lives there and opens in that half from now on. If it was open, it stays open, just at its new place.

Without dragging, use right-click on the icon › Move to:

Entry Place
Left top (side) upper half, left
Left, below (side) lower half, left
Left bottom (side) lower half, left, icon at the foot of the stripe
Right top (side), Right, below (side), Right bottom (side) the same on the right
Bottom dock, left left half of the bottom dock, icon at the bottom of the left stripe
Bottom dock, right right half of the bottom dock, icon at the bottom of the right stripe

The current place has a check mark. Reset all icons to default in the same menu restores the original arrangement. The entry is greyed out as long as you haven't moved anything.

The place applies to all projects and all windows. Put Project on the right and it is on the right in every project, including windows that are open right now.

Opening a tool as a tab or a window of its own

  1. Click ⋯ in the header of the tool window.
  2. Choose Open as tab or Open in own window.

Dragging the header of the tool window is quicker:

  • into the middle of an editor group: the tool becomes a tab there
  • onto the edge of an editor group: it opens as a tab in a new split
  • out of the editor window: it becomes a window of its own
  • onto a group in a stripe: it gets its new place there

It comes back to the edge when you close its tab or its window. The tab's context menu has Back to its side for this, and a window of its own has a button of the same name in its title bar. The tool then docks at its place and is open there.

The menu in a tool window's header

The header has two buttons: ⋯ (Options) and a bar (Hide). The Options menu (also on right-click on the header):

Entry What it does
Refresh resets the window to how it looked when first opened and reads everything anew; only for tools that offer it, currently the Claude window
Hide hides the window, with its shortcut next to it
Dock left, Dock bottom, Dock right moves the tool to another side, same half; the current side has a check mark
Move to lower/right half or Move to upper/left half switches the half on the same side
Open as tab opens the tool as a tab in the code area
Open in own window opens it as a macOS window of its own
Size: Half, Third, Quarter sets the width or height of the side
Maximize or Restore (⇧⌘') see Sizes and maximizing

Two windows per side

Each side has two halves. Each can show one tool, for example Project above and Git below it. Opening another tool of the same half replaces the one shown there. You drag the divider between the two with the mouse.

Window types at a glance

Type Behavior
Docked sits at the edge, shown and hidden with its icon or shortcut
Tab lives as a tab in the code area and can be moved and split like any tab
Own window a macOS window of its own, with the tool's and the project's name in the title; it belongs to the project window it came from

Exceptions:

  • Mission Control always opens as a tab and can't be docked, so its Options menu has no docking entries. You can still move its icon.
  • Notes never becomes a window of its own. Open in own window is missing there; to work with Notes at full size, open it as a tab.

Troubleshooting

What you see Why What to do
After a restart a tool is docked again own windows don't survive a restart choose Open in own window again
Reset all icons to default is greyed out you haven't moved anything yet nothing to do
A tool opens somewhere else than expected you moved its icon in another window; the place applies everywhere drag the icon back or Reset all icons to default

See also

Sizes and maximizing Free

The tool windows at the sides and at the bottom have a size you set by dragging or through a menu. Two shortcuts bring one tool up big or clear everything away except the code.

How to do it

  1. Grab the edge between the code area and the tool window with the mouse.
  2. Drag it to the size you want. Near ¼, ⅓, ½, ⅔ and ¾ it snaps.
  3. A double-click on the edge switches between ½ and the size you had last.

The same works for the divider between two tool windows of one side and for the splits in the code area.

Size from the menu

The ⋯ menu of a tool window (or a right-click on its header) has Size: Half, Third, Quarter. This sets the whole side the tool sits on.

Fractions, not pixels

Sizes are fractions of the window, not pixels. A quarter stays a quarter when you make the window bigger or smaller. A tool area takes at least 8 % and at most 85 %.

Area Starting value
left 20 %
right 24 %
bottom 32 %
divider between two tools of a side ½

Maximize and hide everything

Shortcut Command What happens
⇧⌘' Maximize tool window The tools of the side the last used tool window sits on fill the whole area between the stripes. If none had the focus yet, it is the bottom dock. The same shortcut restores the view.
⇧⌘F12 Hide all tool windows everything on the left, right and bottom is hidden, only the code stays

Both shortcuts also work while the focus is in the terminal. Both are in the View menu.

Narrow windows

When the area between the stripes is narrower than 1000 pixels, the side tool windows no longer push the code area aside but lie on top of it. A click into the code area hides them. Mission Control stays usable next to them as long as there is room left.

Terminal without open tabs

When no tab is open and the terminal is docked and visible, it takes up the whole code area. Its saved size does not change: as soon as a tab opens, it goes back to its usual size. Switch this off under Settings › Terminal: Terminal fills the editor area when no tab is open.

See also

What the editor remembers Free

The editor restores every project the way you left it: open tabs, splits, tool windows and their sizes. Some things apply to you as a whole instead, whichever project is open. This page shows what goes where and where it is stored.

For all projects and windows

  • the place of every tool: side, half and order in the stripe. When you move an icon, it applies at once to every other open project window too.
  • the editor settings, such as font, minimap or word wrap
  • the list of recently opened projects

Per project

  • which tools are open and whether they are docked or live as a tab
  • the sizes of the sides and dividers
  • what a tool showed last: the repository picked in the Git window, a filter, collapsed sections, the selected row. Close a tool and open it again, restart the editor or move the tool into a window of its own, and it looks the same.
  • the open tabs, the splits of the code area and the cursor position in your files
  • attached folders and subprojects
  • the state of the project tree

Where it is stored

A project's state lives in the project folder in .webdonkey-editor/workspace.json. File paths in it are stored relative to the project. Move or rename the project folder and everything is kept.

When the editor creates the .webdonkey-editor folder, it writes a .gitignore with * into it. Git therefore ignores the folder, and your project's own .gitignore stays untouched. If nothing can be written in the project folder, the editor keeps the state with itself instead.

After a restart

  • A tool that was a window of its own when you quit comes back docked. The window itself doesn't survive the restart.
  • Tools you switched off in the settings stay off.
  • If a tool has a different place by now, it stays open, just there.
  • If Reopen the projects that were open last is on (Settings › Features, group Start), your last projects open again. Otherwise the editor starts with the start screen.

Tip: To get the icons back in their original order, use Reset all icons to default in the right-click menu of an icon. The state of your projects stays as it is.

See also

Start screen Free

When a window has no project open, the editor shows its start screen: WebDonkey Editor, "The workplace next to WebDonkey." From here you open a folder, clone a repository or jump into a project you had recently.

Where to find it

The start screen appears on the very first start, on every start while Reopen the projects that were open last is off, and when you choose Close project in the last open window.

How to do it

  1. Click Open folder… (or press ⌘O) and pick your project folder.
  2. Or click a project in the Recent projects list.

If that project is already open in another window, the editor brings that window to the front instead of opening it twice.

What you find there

Element What it does
Open folder… opens a folder as a project, like ⌘O
Clone repository… brings a Git repository to your Mac, see Clone a repository
Recent projects your last twelve projects with name and path; until there is one, it says "Nothing open yet"
From WebDonkey your sites with domain and project folder; a click opens the site's project folder as a project

From WebDonkey only appears when the editor is connected to WebDonkey and there are sites.

When the editor can't use WebDonkey, a notice sits at the top. Usually WebDonkey is older than this editor needs, and the notice asks you to update WebDonkey. Otherwise it says what works without it: "Editor, files, terminal and git work. Remote, database and themes unlock with WebDonkey."

Settings

Setting Where Default
Reopen the projects that were open last Settings › Features, group Start; off: the editor starts with the start screen on
Sites from WebDonkey on the start screen Settings › Features, group Start on
Color gradient on the start screen Settings › Appearance on

See also

Projects and windows Free

Every project has its own editor window. You open, switch and close projects through the project menu on the left of the title bar. A project is never open twice: open one that already has a window, and that window comes to the front.

Where to find it

Click the project name on the left of the title bar (without a project: No project open). The same projects are in File › Recent projects in the menu bar.

How to do it

Opening another project

  1. In the project menu, click Open folder… or a project under Recent projects.
  2. If the window already has a project, a dialog titled Open “Name” appears with these buttons:
Button What happens
New window The folder gets a window of its own, the current project stays where it is. This is the default.
This window The current project closes here and the folder opens in its place. The editor asks about unsaved files first.
Attach The folder joins the same project as another folder, see Multiple folders.
Cancel Nothing happens.

Closing a project

  1. In the project menu choose Close project (also in the File menu).
  2. The editor asks “Close project “Name”?”. If you have unsaved files, it asks whether to save them instead.
  3. Confirm with Close project.

If other project windows are open, this window closes. If it is the last one, it stays open and shows the start screen.

The project menu

Entry What it does
Open folder… picks a folder as a project
Clone repository… clones a Git repository, see Clone a repository
Recent projects the last ten projects; a click opens one, the current one has a check mark
Rename combination… only with attached folders: gives the combination a name of its own
Detach from project: folder only with attached folders: takes that folder out again, nothing is deleted on disk
Close project closes this window's project

In the Recent projects list:

  • A green dot shows that the project is open in a window right now.
  • Close window (window icon at the right of the row, only for open projects) closes that project's window, with the same questions as above.
  • Remove from list (list icon at the right of the row) asks right in the row: "Remove?" with Yes and No. For an open project the question is "Close and remove project?": the project closes first and then leaves the list. Nothing is deleted on disk.
  • If the entry belongs to another window, the menu stays open after these actions.
  • Long names wrap. A combination with a name of its own is shown in colour, its folders below it.

The field for renaming is called Name (empty = project names). Leave it empty and the combination is named after its folders again.

Folders you mark with Show as subproject in the project tree (Subprojects) are not in the project menu. They appear in Mission Control as projects of their own, with their own sessions.

Windows and their titles

Every project window carries its project's name in the window title; with attached folders, all folder names joined with "+", or the combination's name. If two projects have the same name, the parent folder is put in front. Tool windows you detached into a window of their own belong to the project window they came from (Places and window types). Requests from outside, such as wd edit from the terminal, go to the window whose project the file belongs to.

Closing a window

Clicking the red button of a project window asks “Close the window of “Name”?”. Idle terminals are closed. Programs still running in them keep running and are back when you open the project again.

If it is the last window, it depends on Keep running when the window is closed (Settings › Features, group App, on out of the box):

  • on: The project stays open and the editor keeps running in the Dock. Terminals and Claude sessions keep going. A click on the Dock icon or wd edit brings the window back.
  • off: The editor quits afterwards. The question names the programs that will end.

Quitting

⌘Q (Quit WebDonkey Editor) quits the editor with all its windows. First it saves what autosave would save anyway, then it asks, one after the other:

  1. about unsaved files: Save, Don't save or Cancel
  2. about programs still running in terminals (such as Claude or a dev server) and operations still running on a server (Backup, Sync, Restore, Upload, Download): Quit or Cancel

The same questions come when you quit from the Dock or log out. If a window doesn't answer within a few seconds, the editor quits anyway, so it can never get stuck.

Troubleshooting

What you see Why What to do
A project doesn't open in the current window, another window comes to the front instead the project is already open there work there or close that window
The editor keeps running after you close the last window Keep running when the window is closed is on quit with ⌘Q or switch the setting off
⌘Q doesn't quit right away there are unsaved files, running programs or server operations answer the questions

See also

Status bar Free

The status bar at the bottom of the window shows where you are at a glance: branch, site and PHP version, updates, AI and Claude, who last changed the current line, and the key facts of the active file. Almost every entry is a button that opens the matching tool or a menu.

Where to find it

The status bar is at the bottom of every project window. Entries with nothing to say are left out: no branch without a Git repository, no file details without an open file.

The entries from left to right

Entry What it shows A click
Git branch the project's branch with a branch icon opens the Git window
WebDonkey and site a dot (green: WebDonkey is running), the domain of the project's site and its PHP version, then the number of running services. Without a matching site it reads WebDonkey or "WebDonkey not running". Only when the editor is connected to WebDonkey. opens the WebDonkey window
Open in browser appears when the project belongs to a site and WebDonkey is running opens the site in your default browser
Service dots one dot per service of the site, green, red or pulsing yellow while starting opens a menu to start, stop and restart, see Status bar in the WebDonkey chapter
Update Update version when a new editor version is waiting opens Changelog & Updates
AI whether suggestions while typing are on, off or paused; struck through means off opens a menu (see below)
Claude ✳ and your Claude limits: the share of the 5-hour window and, after W, of the week, in the warning colour from 80 %. A dot in front means a Claude session is connected to this editor. opens the Claude window
Who changed the line author and age of the last change to the cursor's line, such as "Alex, 2 days ago"; "Not committed yet" for new lines. The tooltip names the commit and its message. nothing
Line:Column the cursor position, with the selection in brackets after it, such as "(12 chars)" or "(120 chars, 4 lines)" nothing
Indentation 4 spaces or Tabs nothing
Line endings LF or CRLF switches, see Encoding, line endings and language
Encoding for example UTF-8 or ISO-8859-1 menu with Reopen with encoding and Save with encoding
Language the language mode, such as PHP or Twig list of all languages with a search
Free shown as long as you don't have WebDonkey Premium nothing

Cursor, indentation, line endings, encoding and language only appear while a file or a comparison is in front. Out of the box, the editor also shows who last changed a line faintly behind the cursor's line; you switch that off under Settings › Editor with Git blame in the line. The editor reads the Claude limits from Claude Code's status line, which costs no tokens. They appear as soon as WebDonkey has a value.

The AI menu

Clicking AI opens:

Entry What it does
Suggestions while typing switches the local AI's suggestions on or off everywhere
In this project switches them off or back on for this project only
Download with the model's name, or Load a model in WebDonkey appears when there is no model for suggestions yet
Show/hide AI opens the AI window

The tooltip names the model, the median response time and how many suggestions you took. The editor counts these on your Mac only. When the battery drops below 20 %, suggestions pause, as long as the matching setting is on (on out of the box). More under Suggestions while typing.

Switching entries off

Under Settings › Features, group Status bar, you switch each entry off on its own. All are on out of the box.

Switch Entry
Git branch Git branch
WebDonkey and the project's site WebDonkey and site
Open in browser Open in browser
Update notice Update
AI ghost text AI
Claude Claude limits
Who last changed the line author and age of the line
Cursor, language and indentation Line:Column, indentation, line endings, encoding, language
Free notice Free

You switch the service dots off under Settings › Services with The site's services in the status bar. If the AI tool is switched off, its entry disappears as well.

Free and Premium

The status bar is free. Suggestions while typing are part of WebDonkey Premium: without Premium the AI entry shows a lock and its menu says "Suggestions while typing are part of Premium." In the service dots' menu, the entry for following the log reads Follow log (Premium, opens WebDonkey) without Premium.

Troubleshooting

What you see Why What to do
No branch the project isn't a Git repository, or Git isn't installed create a repository or install Git
No site, just WebDonkey the project folder belongs to no site in WebDonkey open the site's folder, see Sites
No Claude limits WebDonkey has no value from Claude Code yet, or the editor runs without WebDonkey start a Claude session
No author for the line the file isn't in a repository nothing to do
No file details what's in front is no text but a tool, an image or another viewer bring a text file to the front

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