Skip to content

Custom themes

Jump to bottom
Cyberdelia edited this page Oct 30, 2026 · 1 revision

Custom themes

Documentation home · Settings and help

Preview feature: the custom theme editor and JSON import/export are currently available in the local test build. They are not included in the public Tagcast 1.1.0 downloads. This page previews a planned update; no release number is assigned yet. See Upcoming changes.

Amber Original example

A charcoal-grey interface with amber highlights, adapted from Amber · Original in ibfetch. The file includes separate Light and Dark variants. It changes Tagcast's colour roles while keeping its existing layout and controls.

Tagcast's Album artists page with charcoal-grey surfaces and amber highlights; the Theme menu shows Amber Original from ibfetch selected under My themes

Amber · Original (ibfetch), shown with Dark colours and Auto appearance in the local macOS test build, 30 October 2026. The 1.1.0 footer is the test build's version label; the custom-theme controls are not part of the public 1.1.0 release.

Download Amber Original JSON

Import the example

  1. Save the linked file as ibfetch-amber-original.json. If your browser displays JSON text, save that file with its .json extension.
  2. In a build that includes the theme editor, open Settings → Appearance.
  3. Choose Import JSON… and select the file.
  4. Check the component preview. Switch between Light and Dark to inspect both colour variants; this does not change the app's appearance preference.
  5. Choose Save & use to save and apply the theme. Save theme saves it without changing your current theme.

Tagcast's Appearance settings showing the imported Amber Original theme, Import JSON and Export JSON buttons, editable Dark colour fields and an isolated component preview

The imported Amber theme in the local test build's editor. The component preview uses Amber while the surrounding app still uses the current iBroadcast-inspired palette; previewing does not apply the draft. Import/export buttons share the current theme as JSON.

The theme then appears under Theme → My themes. Auto · follow system, Light and Dark remain independent choices. Importing creates a new unsaved preview; it does not overwrite another saved theme or change your library.

Create and share your own theme

Start from an existing palette or saved theme, give your draft a name, and adjust colours alongside the component preview. Duplicate draft starts a separate copy. Built-in palettes remain available.

Export JSON downloads the current valid draft, including both colour variants, without saving or applying it. Invalid colour fields must be corrected first. Each file contains one theme: its name, built-in base palette and colour overrides. It does not include account details, tokens, library data or other preferences.

Theme files are limited to 16 KB and accept known colour roles with six-digit hex values. Saving is explicit. Saved themes are local to this browser or desktop profile; export/import lets you move them to another installation.

Contrast checks highlight representative text, button and focus combinations; they are guidance rather than a guarantee for every screen. Native audio controls, output pickers and window borders can retain operating-system styling. Warning and error colours keep their existing meaning.

Tagcast website · Tagcast source · Releases · Reddit community · Report an issue · Media kit

Independent project by Cyberdelia. Not made or endorsed by iBroadcast.

Tagcast documentation

Start

Browse and listen

Organise

Edit

Maintain

Settings and help

Developers

Clone this wiki locally