tsty 0.1.0

A simple command-line utility for changing your terminal colors

tsty

tsty short for "terminal style"

A simple command-line utility for quickly switching your terminal's background, text, and cursor colors.

Works in any terminal that honors the standard OSC 10/11/12 escape sequences, including:

• Ghostty
• kitty
• Alacritty
• WezTerm
• iTerm2
• macOS Terminal.app
• foot, and other modern terminals

When run inside tmux or screen, sequences are automatically wrapped in the appropriate DCS passthrough envelope.

Example usage

# Change background to green
tsty bg green

## by default, the tsty command runs the `bg` subcommand, so this works too:
tsty green

## you can also pass in rgb values, in order of: r g b
tsty 0 100

# Change text color to orange
tsty text orange

# change cursor to lavender
tsty cursor lavender

# reset to sensible defaults
tsty reset

# list commands and colors
tsty list

Current status

• Cross-terminal: works anywhere OSC 10/11/12 is supported (Ghostty, kitty, Alacritty, WezTerm, iTerm2, Terminal.app, ...)
• tmux / screen passthrough handled automatically

TODOS

• Add ability to switch themes
• Make separate color presets for background/cursor and text, as the former generally needs to be darker and the latter brighter
• make aliases, e.g. tsty t for tsty text
• finish writing tests
  • throw error when user has more than 4 values for color argument
  • throw error when user has more than 1 non-numerical value for color argument
• Replace verbose-by-default with --verbose opt-in flag (i.e. deprecate --quiet)

Installation and development notes

Install this tool using pip:

pip install tsty

Dev and Testing

# install locally
pip install -e .


# run all tests
pytest

# run just alpha tests
pytest -m 'alpha'


# skip alpha tests
pytest -m 'not alpha'