Themes

A theme sets every colour, font, radius, shadow and opacity of the bar, and it can carry bar settings too: position, width, behaviour, the fisheye. Everything is in one JSON file, so a theme is easy to share and easy to have written.

Bundled themes

smabar ships four: default (dark, magnified), paper (light and calm), terminal (monospace, square, full width at the bottom) and topbar (a full-width bar at the top edge). Settings › Design switches between them and lets you adjust the accent colour, the fonts and the bar and flyout opacity on top of any theme.

Ask your agent

The agent that builds your widgets can also design. Describe the look:

Give me a warm paper look with a serif clock, the bar at the top, no magnification.

The agent writes the theme into ~/.smabar/themes/, fetches a Google Font if the look needs one, activates the theme and screenshots the result. Fonts downloaded this way are stored under ~/.smabar/cache/fonts/; nothing is installed system-wide, and the bar never loads fonts from the network at runtime.

The theme store

Settings › Design opens the theme part of the Community Store. Themes there are single JSON files in public GitHub repositories, listed with their author, license and stars. Installing one downloads that file, verifies its checksum against the signed catalog, and puts it into your themes folder. The theme store on this site shows the same catalog with a preview.

Sharing a theme

A theme is one file. Send it, or publish it on GitHub and submit the repository to the store, which is described on the publishing page.