7.0 KiB
Add a theme pack
Theme packs add palettes without rebuilding Canvas Pilot. They change the app, viewport and source-coordinate helper colors; they do not change projects, device transfers, imported pictures, fonts or interface size.
Install and try the collections
Download a ZIP, leave it zipped, then open Settings → Theme packs → Install theme pack…. Select a pack, then click one of its themes to try it immediately. It also appears in More themes… and recent themes. The picker stays open while you try alternatives. Selecting High Contrast twice returns to your last theme, including an installed one.
Choose either collection, or install both:
- Video-game themes: 6 themes — Deep Rock Galactic, Detroit: Become Human, Dispatch, Helldivers, Ravenswatch and Vivid World.
- Classic themes: 11 themes — Catppuccin Mocha, Dracula, GitHub Dark/Light, Gruvbox Dark, Monokai, Nord, One Dark, Solarized Dark/Light and Tokyo Night.
Each ZIP is one normal theme pack. Select video-game-themes or classic-themes in the manager to try its palettes. Removal or replacement applies to that whole collection. Individual downloads below remain available; installing both an individual pack and its collection keeps separate copies.
Video-game themes
| Pack | Palette | Editable manifest |
|---|---|---|
| Detroit: Become Human | Deep blue, pale text and cyan android-inspired accents | manifest.json |
| Ravenswatch | Midnight blue, ivory and crimson | manifest.json |
| Vivid World | Midnight navy, violet, pink and cyan crystal accents | manifest.json |
| Deep Rock Galactic | Dark, gold/molten-orange accents | manifest.json |
| Dispatch | Dark, yellow/cyan accents | manifest.json |
| Helldivers | Dark | manifest.json |
Classic themes
| Pack | Palette | Editable manifest |
|---|---|---|
| Tokyo Night | Dark blue with cool cyan accents | manifest.json |
| Catppuccin Mocha | Soft charcoal and pastel accents | manifest.json |
| Dracula | Dark | manifest.json |
| GitHub Dark | Dark | manifest.json |
| GitHub Light | Light | manifest.json |
| Gruvbox Dark | Dark | manifest.json |
| Monokai | Dark | manifest.json |
| Nord | Dark | manifest.json |
| One Dark | Dark | manifest.json |
| Solarized Dark | Dark | manifest.json |
| Solarized Light | Light | manifest.json |
Tokyo Night adapts the upstream palette, and Catppuccin uses Mocha colors. Their license notices travel inside the ZIP and can be viewed under Attribution and licenses. The Detroit, Vivid World, Ravenswatch, Dispatch, Helldivers and Deep Rock Galactic themes are original, unofficial color interpretations; they include no game artwork, fonts or code and are not endorsed by the games' owners.
Moving from the old combined pack
The two collections replace the former extra-themes.zip download and have new
pack IDs. Install the desired collections, select a theme from one of them, then
remove extra-themes in Settings if you no longer need its duplicate entries.
Existing installations and saved choices are not renamed or deleted automatically.
Removing a pack while its theme is active falls back to Midra Dark. Standalone
packs, including older Minecraft installations, remain user-managed.
Manage packs
The manager uses a compact, searchable pack list and shows the contents of only one selected pack. Search by pack ID or theme name; Clear restores the full list. Rows show the theme count and revision, with a dot marking packs currently in use. Large collections scroll within the list instead of stretching Settings.
Select a pack to see its theme names, swatches, attribution and Remove pack… action. The contents and license text scroll independently; removal stays above them. On narrower windows, details appear below the list. Newly installed or updated packs are selected automatically. Search and selection are remembered during the session, separately from language packs. Theme changes save immediately and survive restart.
Install a newer revision of the same pack to update it immediately. Equal or older revisions ask before replacing the installed copy. Updating an active theme refreshes its colors. Removing a pack asks for confirmation; if it contains the active theme, Canvas Pilot returns to Midra Dark. The downloaded ZIP is kept for reinstalling.
If a pack disappears outside the app, Canvas Pilot keeps your saved choice but uses Midra Dark and marks the theme unavailable. Reinstalling that pack restores its colors. Invalid packs are reported and skipped; they do not prevent startup.
Make your own
Start with one of the editable manifests above. Change the pack id, each theme's
id and name, and its colors; keep the required fields. Choose light: true
for a light palette or false for a dark one. Every color is opaque #RRGGBB.
Put the file at the ZIP root as manifest.json, with no folder or other files.
A pack may contain up to 16 themes. Increase its positive revision for updates.
Use your own pack ID when distributing a variant. Retain relevant upstream notices when adapting licensed palettes. Check primary and secondary text on every surface, selection fills and both checkerboard tile colors. Light/dark mode does not fix poorly contrasted colors automatically.
The theme-pack contract lists all palette roles,
validation limits, settings compatibility and round-trip behavior. Repository
contributors regenerate the individual ZIPs and both collections with python3 scripts/build-theme-packs.py.