obsidian-theme/real-fruit-snacks_terminal-workbench
1
0
Fork 0
mirror of https://github.com/real-fruit-snacks/terminal-workbench.git synced 2026-07-22 05:00:25 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
real-fruit-snacks_terminal-.../README.md
Real-Fruit-Snacks 8a2294a71e README: link the Terminal Workbench family hub
2026-07-20 15:50:06 -04:00

5 KiB
Raw Permalink Blame History

Terminal Workbench

Latest release License: MIT Obsidian

Part of the Terminal Workbench family — one repo with the design spec, CSS tokens, every port, and the official monospace font.

A modern terminal-inspired theme for Obsidian, built for people who spend the day in panes, shells, logs, editors, and command palettes.

The design goal is not retro green-on-black nostalgia. It is a calm, dense, high-contrast working surface: graphite backgrounds, crisp typography, restrained ANSI-style accents, readable code, and pane chrome that feels close to a modern terminal without turning your notes into a novelty skin.

Terminal Workbench in dark mode

View the live showcase for both modes, the full palette, and feature details.

Highlights

  • Full dark and light modes, each a deliberate palette rather than an inversion
  • A consistent "terminal manifest" idiom across the interface: monospace micro-labels for properties, code block headers, tab titles, and breadcrumbs
  • Code blocks with a header band, language label, and framed styling that matches between editing and reading views
  • Custom task states with distinct checkbox colors: done, cancelled, deferred, and important
  • Styled Mermaid flowchart, state, sequence, and class diagrams that follow the theme palette
  • Respects your Obsidian settings: accent color, interface, text, and monospace fonts, and font size all flow through
  • Print-friendly: decorative elements are stripped from PDF export

Installation

Community themes (recommended)

  1. Open Settings > Appearance.
  2. Under Themes, select Manage.
  3. Search for Terminal Workbench and select Install and use.

Manual

  1. Create the folder <your vault>/.obsidian/themes/Terminal Workbench/.
  2. Download theme.css and manifest.json from the latest release and copy them into that folder.
  3. Open Obsidian and go to Settings > Appearance > Themes.
  4. Choose Terminal Workbench.

Requires Obsidian 1.5.0 or newer.

Respecting your settings

Terminal Workbench builds on Obsidian's own settings rather than replacing them:

  • The accent color follows Settings > Appearance > Accent color if you customize it; otherwise the theme's terminal green is used.
  • Interface, text, and monospace fonts set under Settings > Appearance take priority over the theme's font stacks.
  • Font size is controlled by the Appearance font-size slider, untouched by the theme.

Customization

Terminal Workbench includes settings for the Style Settings community plugin:

  • Primary, secondary, and warm accent colors, configurable separately for light and dark mode
  • Editor, UI, and code fonts, editor line width, UI corner radius, and text line height
  • Per-folder coloring: each top-level folder takes one of six palette colors and passes it down to everything inside; all six colors and a file name color are configurable
  • Per-type callout colors, chosen from the theme palette (every callout type, dark and light)
  • Compact workspace mode, soft neon highlights, and an active-line terminal prompt marker
  • Tag shape (square or pill)
  • Toggles to simplify individual features: neutral heading colors, hidden heading underline rules, hidden active-line highlight, hidden blockquote marker, plain code block headers, plain tab titles and breadcrumb, neutral task states, and stock Mermaid diagrams

Suggested fonts (the theme falls back to system fonts without them):

  • Editor and code: Berkeley Mono, JetBrains Mono, Cascadia Code, IBM Plex Mono
  • Interface: Inter, SF Pro Text, Segoe UI

Compatibility

The theme uses color-mix() for derived tints, supported by every desktop build and current mobile build that meets the minimum app version. On very old Android WebViews the theme falls back to static colors for selection, hover, and glow effects; other tints degrade gracefully.

Development

Path Purpose
theme.css The theme
manifest.json Theme metadata
versions.json Release compatibility map
screenshot.png Community-store thumbnail
docs/index.html Showcase page (GitHub Pages)
docs/THEME-SPEC.md Portable design specification for reusing this visual system elsewhere
.github/workflows/release.yml Creates a GitHub release with manifest.json and theme.css when a version tag is pushed

To cut a release: bump version in manifest.json, add the entry to versions.json, then push a tag with the same version number.

License

MIT