canvas-pilot/docs/canvas-pilot/guide/theme-packs.md

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.