Skip to content
living-code-themePublic

Repository files navigation

Living Code [lc] mark

📊 Living Code for bottom

Calm slate. Living color.
Living Code for bottom: native TOML styles for CPU, memory, network, batteries, graphs, tables and selected widgets.

teal #00a692 mint #52d7c1 aqua #9ae0dd steel #80b6d3 moss #8acb83 amber #f0be6d copper #e18c5f flare #e96560 orchid #bf91cd rose #ddaec3

Living Code: 4 flavors GitHub stars Open issues Last commit

Installation · Flavors · Configuration · All ports

Previews

Night
Dark · full palette

bottom running Living Code Night
Frost
Dark · softer chroma

bottom running Living Code Frost
Paper
Light · near-white slate

bottom running Living Code Paper
Signal
Dark · teal accent

bottom running Living Code Signal

Select any preview to view the image at full size.

Installation

flavor=night # night, frost, paper, or signal
curl -fsSL --create-dirs -o "${XDG_CONFIG_HOME:-$HOME/.config}/bottom/themes/living-code-$flavor.toml" "https://raw.githubusercontent.com/living-code-theme/bottom/main/themes/living-code-$flavor.toml"
btm --config "${XDG_CONFIG_HOME:-$HOME/.config}/bottom/themes/living-code-$flavor.toml"

This leaves your normal bottom.toml untouched. To retain its monitor layout and process settings, merge the downloaded file’s [styles] tables into that config instead. Remove duplicate style tables and do not pass a built-in --color override.

Flavors

Expand a flavor for its full-size preview and activation instructions.

Night · Dark · full palette

bottom running Living Code Night

btm --config "${XDG_CONFIG_HOME:-$HOME/.config}/bottom/themes/living-code-night.toml"
Frost · Dark · softer chroma

bottom running Living Code Frost

btm --config "${XDG_CONFIG_HOME:-$HOME/.config}/bottom/themes/living-code-frost.toml"
Paper · Light · near-white slate

bottom running Living Code Paper

btm --config "${XDG_CONFIG_HOME:-$HOME/.config}/bottom/themes/living-code-paper.toml"
Signal · Dark · teal accent

bottom running Living Code Signal

btm --config "${XDG_CONFIG_HOME:-$HOME/.config}/bottom/themes/living-code-signal.toml"

Configuration

The file contains only [styles] and its child tables. Remove existing duplicates before merging. Do not pass --color when testing the custom palette: a built-in-theme command-line override takes precedence. CPU, temperature and GPU series use a consistent set of Living Code semantic hues. Widget text and selected text use explicit foreground/background pairs.

Compatibility

Targets bottom’s current [styles] format, verified against its complete upstream valid-style fixture. Older releases using different styling keys are not claimed. Truecolor is recommended. Tests parse TOML, check section/field names against the fixture and verify foreground/selection contrast; the native application is also captured automatically.

Previews are captured programmatically from the actual application in an isolated profile. See capture/app.py for the app-owned recipe and images/capture.json for runtime, palette and image provenance. No mock interface is drawn.

Contributing

Found a problem? Open an issue with the app version, the flavor and a screenshot. Want Living Code somewhere else? Request a port.

Pull requests are welcome. Keep this README, port.json and images/ in sync, and use real screenshots of the app, never mockups.

🦎 One chameleon, many habitats. Part of Living Code.

License

MIT license

© Elliot Luque

Releases

Packages

Used by

Contributors

Languages