Themis

Themis is a theme orchestrator CLI for Linux and macOS. It manages switching system themes across multiple applications by coordinating profiles, palettes, and integrations.

Themis acts as a “General Contractor” for desktop theming—it doesn’t generate colors, but manages the who, what, and when of applying themes.

Features

• Profile-based theming - Define profiles that include color palettes and app-specific settings
• Palette inheritance - System palettes (nord, dracula, etc.) can be extended by user palettes
• Multiple integration types - Templates, symlinks, commands, and scripts
• Safety-first - Generates hidden partials (.themis.conf) that users manually include
• Dry-run mode - Preview changes without modifying files
• XDG compliant - Respects XDG_CONFIG_HOME and XDG_STATE_HOME on both Linux and macOS

Quick Start

# Initialize configuration
themis init

# Load a profile
themis load my-profile

# Check current status
themis status

# Preview changes without applying
themis load my-profile --dry-run

How It Works

1. Enroll applications in themis.yaml with their integration type
2. Create profiles that define variables (colors, fonts, settings)
3. Run themis load to apply the profile to all enrolled apps

Themis never overwrites your main config files. Instead, it generates hidden partial files (like .themis.conf) that you include in your app’s configuration.

Next Steps

• Getting Started - Installation and first profile
• Guides - In-depth guides for profiles and integrations
• Reference - CLI commands and configuration schema