iTerm Color Schemes
Intro
This is a set of color schemes for iTerm (aka iTerm2). It also includes ports to Terminal, Konsole, PuTTY, Xresources, XRDB, Remmina, Termite, XFCE, Tilda, FreeBSD VT, Terminator, Kitty, Ghostty, Otty, MobaXterm, LXTerminal, Microsoft's Windows Terminal, Visual Studio, Alacritty, Vim
Screenshots below and in the screenshots directory.
Installation Instructions
There are 3 ways to install an iTerm theme:
-
Direct way via keyboard shortcut:
- Launch iTerm 2. Get the latest version at iterm2.com
- Type CMD+i (⌘+i)
- Navigate to Colors tab
- Click on Color Presets
- Click on Import
- Click on the schemes folder
- Select the .itermcolors profiles you would like to import
- Click on Color Presets and choose a color scheme
-
Via iTerm preferences (go to the same configuration location as above):
- Launch iTerm 2. Get the latest version at iterm2.com
- Click on iTerm2 menu title
- Select Preferences... option
- Select Profiles
- Navigate to Colors tab
- Click on Color Presets
- Click on Import
- Select the .itermcolors file(s) of the schemes you'd like to use * Click on Color Presets and choose a color scheme
-
Via Bash script
- Launch iTerm 2. Get the latest version at iterm2.com
- Run the following command:
# Import all color schemes
tools/import-scheme.sh schemes/*
# Import all color schemes (verbose mode)
tools/import-scheme.sh -v schemes/*
# Import specific color schemes (quotations are needed for schemes with spaces in name)
tools/import-scheme.sh 'schemes/SpaceGray Eighties.itermcolors' # by file path
tools/import-scheme.sh 'SpaceGray Eighties' # by scheme name
tools/import-scheme.sh Molokai 'SpaceGray Eighties' # import multiple
- Restart iTerm 2. (Need to quit iTerm 2 to reload the configuration file.)
Contribute
Using Docker
If docker is installed, the script generate-all.sh will do most of the
steps described in Prerequisites, except for the instructions
related to pyenv as this is not required in a docker container dedicated to
generating the required files.
With docker, there is no need to install python and its dependencies on your
computer.
The remaining manual tasks are to update README.md to include your theme and
screenshot, and to update CREDITS.md to credit yourself for your contribution.
Debugging using Docker
In cases where new tools have to be tested, ./generate-all.sh debug will start
an interactive terminal session inside the container.
Prerequisites
- For convenient work with generation scripts, it is recommended to install pyenv.
- Run
pyenv install inside project folder to install python version from .python-version file.
- Run
pip install -r requirements.txt to install the project dependencies.
How to add new theme
Have a great theme? Send it to me via a Pull Request!
Theme naming
Name source files exactly as the theme should be displayed. Use the human-readable
name — no slugification, no replacing spaces with underscores.
- iTerm2:
schemes/Your Theme Name.itermcolors
- YAML:
yaml/Your Theme Name.yml (see yaml/README.md)
Quote names with spaces in shell commands: python3 tools/gen.py -s "Your Theme Name".
Have an iTerm theme?
- Get your theme's
.itermcolors file.
- Launch iTerm 2
- Type CMD+i (⌘+i)
- Navigate to Colors tab
- Click on Color Presets
- Click on Export
- Save the .itermcolors file
- Put your theme file into
/schemes/, named as you want it displayed.
mv <your-itermcolors-file> schemes/"Your Theme Name.itermcolors"
Have a theme in another format?
- Convert it to the YAML format specified in yaml/README.md.
This is an extension of the format supported by the Gogh project.
- If it helps, you can use
tools/kitty_to_yaml.py and tools/ghostty_to_yaml.py.
These tools accept configuration file streamed into stdin, and output a YAML fragment to stdout.
- Put the YAML file in
yaml/ as Your Theme Name.yml.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
