Themes
Free & PremiumThemes set how WebDonkey looks: background, panels, text and accent colours. You wear one of the built-in themes, follow the macOS setting, or with Premium build your own from three colours. Themes by other users come from the community gallery.
What you do here
- Built-in themes: wear or copy Aurora Dark, Arctic Light, System and the Premium themes.
- Theme editor: build your own theme from base, background and two accents.
- Your own themes: wear, edit, delete your themes and paste them by code.
- Community gallery: save themes by other users and share your own.
Switching themes
The quickest way is the Theme switcher at the bottom of the sidebar. It lists Aurora Dark, Arctic Light and System, with Premium the three Premium themes, then your own themes and at the end Manage themes…, which opens this page.
In the command palette (⌘K), Switch theme toggles between Aurora Dark and Arctic Light. The group Themes lists the Premium themes and your own themes to wear directly.
WebDonkey saves every choice, whether made on this page, in the switcher or through ⌘K. It survives a restart, and a WebDonkey Editor that follows WebDonkey's theme picks it up.
Page layout
From top to bottom:
- Built-in themes: Aurora Dark, Arctic Light and System. They cannot be edited.
- Premium themes: Sunset, Sunrise and Galaxy.
- Your themes: everything of your own, with Paste code and New theme. A new theme opens its editor right above this section, an existing one below it.
- Community gallery: themes by other users to save.
The active theme carries a check mark and a highlighted border.
Free and Premium
| Free | Premium | |
|---|---|---|
| Wear Aurora Dark, Arctic Light, System | yes | yes |
| Wear Sunset, Sunrise, Galaxy | no, visible but locked | yes |
| Copy & edit on built-in themes | no | yes |
| Build and edit your own themes | no | yes |
| Wear and delete your own themes | yes | yes |
| Browse the gallery, save a theme, Paste code | yes | yes |
| Share your own themes in the gallery | no | yes, up to three pending requests |
When Premium ends, your own themes stay in the list and can be worn. A Premium theme you are wearing falls back to a standard theme. Prices are at webdonkey.io/pricing.
From the command line
wd themes lists the themes, wd themes use wears one. More under More tools.
Built-in themes Free & Premium
WebDonkey ships two standard themes, the System setting and three Premium themes. They are part of the app and not in your own list, so they can be neither edited nor deleted. With Premium they serve as a starting point for a theme of your own.
Where to find it
Sidebar Account & Help › Themes, at the top the sections Built-in themes and Premium themes. Or in the Theme switcher at the bottom of the sidebar.
How to do it
- Open the Themes page.
- Click a card, such as Arctic Light. The app switches right away, and the card carries a check mark.
- With Premium: click Copy & edit below a card to make a theme of your own from it.
The themes
| Theme | Section | What it is |
|---|---|---|
| Aurora Dark | Built-in themes | The dark standard theme and the app's default. |
| Arctic Light | Built-in themes | The light standard theme. |
| System | Built-in themes | Follows the macOS setting and switches with it between Arctic Light and Aurora Dark. |
| Sunset, Sunrise, Galaxy | Premium themes | Three ready-made looks included with Premium. |
Each card shows the theme's colours as dots and its icon.
Copy & edit
With Premium, Copy & edit stands below Aurora Dark, Arctic Light and the Premium themes. It opens the Theme editor with the theme's colours and icon and its name with the suffix "copy", such as "Sunset copy". The original stays as it is. Only Save creates the new theme. System has no colours of its own and therefore no copy button.
Free and Premium
- Aurora Dark, Arctic Light and System are always free.
- On Free the Premium themes stay visible, the section carries the Premium badge, and the cards cannot be picked. Hovering over a card shows Wearing an included theme requires Premium. On Free they are missing from the theme switcher.
- Copy & edit is available with Premium only.
- When Premium ends, a Premium theme you are wearing falls back to a standard theme. Copies you made of it stay as your own themes.
See also
Theme editor Premium
The theme editor builds a complete theme from four decisions: base, background and two accent colours. Text, muted text, borders, panels and the background glow follow from them. That way a theme of your own still looks like WebDonkey and stays readable. The editor is a Premium feature.
Where to find it
Sidebar Account & Help › Themes, then:
- New theme in the section Your themes. The editor is called New theme and opens right above Your themes.
- Copy & edit on a built-in theme. This copy also opens above Your themes.
- The pencil (Edit) on one of your themes. The editor is called Edit theme and opens below the list.
- Paste code with a share code from the gallery: with Premium, the pasted theme opens straight in the editor.
The page scrolls the editor into view by itself.
How to do it
- Click New theme. The editor starts with a dark base and violet and turquoise colours, so you start from something finished.
- Enter a Name.
- Choose the Base: Dark or Light.
- Set Background, Accent and 2nd accent, with the colour well or as a hex value in the text field next to it.
- Choose an Icon.
- Check the preview on the right.
- Click Save. The theme appears under Your themes, and the app wears it right away.
Save unlocks as soon as there is a name. Cancel closes the editor without saving anything.
Fields and options
| Field | Meaning |
|---|---|
| Name | Name of the theme, placeholder "My theme". |
| Base | Dark or Light: sets whether text is light on dark or dark on light. Terminal, code editor, charts and Adminer follow it too. |
| Background | The app's base colour. |
| Accent | The first accent colour, used for buttons and selections, for example. |
| 2nd accent | The second accent colour. |
| Icon | One of sixteen icons. It shows in the sidebar's theme switcher while the theme is active. |
Each colour has a colour well to pick from and a text field for the hex value, such as #1b1430. That way you can also enter a given brand colour.
The preview
On the right a small view shows the real result: name and icon, a panel with Preview and Secondary text looks like this., the states Running and Stopped and the buttons Save and Cancel. It is painted with the same rules as the app. What looks unreadable here looks the same in the app.
What happens in the background
- WebDonkey derives all other colours from the three. It moves text colours lighter or darker until they read well. The target is a contrast of at least 4.5 : 1.
- Your own themes live in WebDonkey's database on this Mac. They are part of the app backup, see App backup.
- If you edit the theme that is active, the app switches to the new colours as soon as you save.
Tips
- Start with Copy & edit on a finished theme instead of three random colours.
- Choose the Base first, then the Background. If the text does not fit, switch the base.
- Once the theme is done, you can share it in the Community gallery.
Free and Premium
Without Premium there is no New theme button, no pencil and no Copy & edit. The section Your themes then says With Premium you can build and save your own themes., and while it is empty also Building your own themes is a Premium feature. Wearing, deleting and Paste code stay free.
See also
Your own themes Free & Premium
The section Your themes holds everything you built yourself, pasted by share code or saved from the gallery. Each theme is a card with a small preview. From here you wear, edit, share and delete them.
Where to find it
Sidebar Account & Help › Themes, the section Your themes. Your themes are also in the Theme switcher and in the command palette (⌘K) in the group Themes.
How to do it
- Click the preview or the name of a card. The app wears the theme right away, and the card gets a check mark.
- To change it, click the pencil (Edit). The Theme editor opens below the list.
- To delete it, click the bin and confirm Delete theme?.
What a card shows
| Part | Meaning |
|---|---|
| Preview | A small view of the app in the theme's colours. A click wears it. |
| Icon and name | The icon shows in the theme switcher while the theme is active. That way you see at a glance that you are wearing a theme of your own. |
| Cloud with arrow (Share in the gallery) | Premium only: uploads the theme to the gallery for review, see Community gallery. |
| x (Cancel request) | Instead of the cloud while a request waits for review. Withdraws it. |
| Pencil (Edit) | Premium only: opens the editor. |
| Bin (Delete) | Deletes the theme, also without Premium. |
| Status line | For shared themes Being checked, Public or Not approved. If the theme has another name in the gallery, In the gallery as “…” appears below. Themes saved from the gallery carry a note that they come from the community and are already in the gallery. |
Paste code
On the gallery's website you can copy a share code for every theme.
- Copy the code on the website.
- Under Your themes, click Paste code. WebDonkey reads the code from the clipboard.
- With Premium the pasted theme opens straight in the editor. On Free the app wears it directly.
Paste code works on Free too.
Deleting
Delete theme? says the theme is removed and the app falls back to Aurora Dark if it is active. If you shared it in the gallery, the dialog points out that the shared copy stays in the gallery. Withdraw it first if you want it gone.
Free and Premium
- On Free the section says With Premium you can build and save your own themes. Instead of New theme there is the Premium badge; pencil and sharing are missing.
- Wearing, deleting and Paste code always stay free, also when Premium ends. Your themes then stay in the list.
- Your own themes are part of the App backup.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| That is not a valid share code. Copy it again from the preset page. | The code is incomplete or not a share code. | Copy it again. |
| The clipboard could not be read. Grant clipboard access and try again. | macOS or WebDonkey refused access. | Allow access and click again. |
| The code could not be inserted. | Another error while creating the theme. | Try again later. |
See also
Community gallery Free & Premium
The Community gallery shows themes other WebDonkey users have shared. Save one and it is yours: it stands under Your themes and can be worn and, with Premium, edited. With Premium you share your own themes. A person reviews every shared theme first.
Where to find it
Sidebar Account & Help › Themes, the section Community gallery at the very bottom.
How to do it
Save a theme
- Scroll to the Community gallery.
- Sort by New or Popular.
- Search by name with Search themes… if needed.
- Click Save on a card. The theme appears under Your themes.
- Click its card there to wear it.
Share a theme of your own (Premium)
- Build a theme in the Theme editor.
- Click the cloud (Share in the gallery) on its card under Your themes.
- Uploaded. It appears in the gallery once approved. appears, and the card shows Being checked.
- After the review, the card says Public or Not approved.
The gallery
- Each card shows a small preview in the theme's colours, the name, Save and, once it has been taken, the number of downloads.
- New shows the newest themes first, Popular sorts by popularity.
- Search themes… filters by name and forgives small typos. If the search finds nothing, it says Nothing matches “…”.
- The gallery loads more as you scroll, 24 themes per page. While you search, it keeps loading until it finds matches or reaches the end.
- Browsing and saving are free and need no licence.
Sharing
- At most three requests can wait for review at the same time. The subtitle of Your themes says how many are pending, such as 1 of 3 requests pending. An approved theme no longer takes a slot.
- When all three slots are taken, the cloud is locked. Its tooltip says three requests are already waiting for review and that a slot frees up once one is approved.
- While a request waits, the x (Cancel request) withdraws it. Approved or rejected themes have no button any more.
- A theme saved from the gallery cannot be shared again. If you change its colours in the editor, it is a new theme and can be shared. A new name alone is not enough.
- If you rename a shared theme in WebDonkey, it keeps its old name in the gallery. The card then shows In the gallery as “…”.
- If you delete a shared theme in WebDonkey, the copy in the gallery stays.
What happens in the background
- The gallery lives in WebDonkey's shop. Without internet it says The gallery could not be reached. It needs an internet connection.; the rest of the page keeps working.
- When you save someone else's theme, WebDonkey sends only its id to the shop. All that is counted is a plain total on the theme.
- When you share, name, icon, base, the three colours and your licence key go to the shop, stored as a hash. Your name is never shown; the gallery knows no author.
Free and Premium
Browsing and saving are free. Sharing needs Premium and an activated licence.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| Sharing requires an activated licence. | No licence activated. | Activate a licence, see Activate a license. |
| These colours are already in the gallery. | The same colour combination is already published. | Change the colours in the editor. |
| The theme name is too short. / The theme name is too long (max. 40 characters). / The theme name contains characters that are not allowed. | The name does not fit the gallery's rules. | Change the name in the editor. |
| You can share three themes at a time. Withdraw one first. | All slots are taken. | Cancel a request or wait for the review. |
| Too many uploads in a short time. Try again later. | Too many uploads in a row. | Wait a while. |
| Upload failed. Please try again later. | Another error at the shop. | Try again later. |