What

One theme script to rule them all.

Features

• 270+ preloaded themes.
• Works on any terminal with OSC 4/11 support (e.g kitty, osx term)
• Small, self contained and POSIX compliant.
• Interactive theme selection (requires fzf)

Demo

Why?

• Lets you easily switch themes inside of an open terminal.
• Lets you configure st's colour theme without recompiling it :P
• Lets you keep your shell's init file as the single source of truth.
• Lets you script theme changes

Usage

Put theme.sh somewhere in your $PATH

Then:

> theme.sh -l
  
  zenburn
  gruvbox
  solarized-dark
  ...

> theme.sh zenburn

or

> theme.sh -i #Interactive theme selection (requires fzf)

Once you find something you like simply put

theme.sh <theme>

in your ~/.bashrc

Configuration

If $THEME_HISTFILE is set then the path is contains will be used to store recently selected themes.

Recommended ~/.bashrc

To load the most recently selected theme automatically you can put

if command -v theme.sh > /dev/null; then
	export THEME_HISTFILE=~/.theme_history
	[ -e "$THEME_HISTFILE" ] && theme.sh "$(theme.sh -l|tail -n1)"

	# Optional  

	bind -x '"\x0f":"theme.sh $(theme.sh -l|tail -n2|head -n1)"' #Binds C-o to the previously active theme.
	alias th='theme.sh -i'
fi

in your ~/.bashrc.

Recommended ~/.vimrc

colorscheme default
set notermguicolors
highlight Search ctermfg=0

The above makes vim play nicely with the stock terminal theme.

Supported Terminals

Below is a list of terminals on which theme.sh is known to work:

• kitty (not KiTTY)
• gnome-terminal
• terminator
• st with the appropriate patch
• Terminal.app (osx)
• iTerm2
• alacritty
• urxvt (non interactively unless the truecolor patch is applied)
• any libvte based terminal

Caveats

• Requires a shell that properly implements OSC 4/11.
• Interactive mode also requires TRUECOLOR support (though the theme can still be set without it.)
• May cause an imperceptible flash when you start your terminal.
• Will not help you achieve enlightenment or improve your marriage.
• May cause epilepsy.

Known issues

• Will not work in screen (tmux uses the same TERM variable)