Skip to content

dive/modus-themes-ports

Repository files navigation

Modus Themes Ports

License: MIT Python 3

Ports of the Modus themes for terminal tools.

Modus themes are designed by Protesilaos Stavrou with a focus on accessibility—conforming to the highest legibility standard (WCAG AAA). They ship in light/dark variants with tinted and color-deficiency friendly flavors (deuteranopia, tritanopia).

Supported Tools

Tool Description
Amp AI coding agent CLI
bat Cat clone with syntax highlighting
Glamour Markdown style JSON format
Glow Markdown previewer
Ghostty Terminal emulator
Helix Modal text editor
Lazygit Terminal UI for git
LS_COLORS Colors for ls and compatible tools
OpenCode AI coding agent CLI
Pi AI coding agent CLI
tmux Terminal multiplexer
Visual Studio Code Code editor
Xcode Apple IDE
Yazi Terminal file manager
Zed Code editor

Screenshots: SCREENSHOTS.md

Quick Start

# List available tools and themes
python3 scripts/modus.py list

# Install themes for a tool (creates symlinks)
python3 scripts/modus.py install --tool ghostty

# Install a specific theme
python3 scripts/modus.py install --tool ghostty --theme modus-operandi

Themes are symlinked into $XDG_CONFIG_HOME by default. See each tool's README for activation instructions.

Theme Variants

Variant Light Dark
Default modus-operandi modus-vivendi
Tinted backgrounds modus-operandi-tinted modus-vivendi-tinted
Deuteranopia (red-green) modus-operandi-deuteranopia modus-vivendi-deuteranopia
Tritanopia (blue-yellow) modus-operandi-tritanopia modus-vivendi-tritanopia

Accent Hue Reference

Preview of the core accent foreground hues by variant (base, warmer, cooler, faint, intense).

Note

This repo uses the Modus faint preset by default for palette extraction.

Docs: Modus palette overrides

Modus Operandi accent hues

Modus Vivendi accent hues

Contributing

See CONTRIBUTING.md to add new ports—no-code templates supported.

Credits

All credit for the Modus themes design goes to Protesilaos Stavrou. This project ports his work to additional tools.

License

MIT

About

Modus theme ports for the tools in my workflow (Ghostty, Yazi, FZF, bat & others)

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors