- Intro
- Installation Instructions
- Contribute
- Screenshots
- Credits
- Extra
- X11 Installation
- Konsole color schemes
- Terminator color schemes
- Mac OS Terminal color schemes
- PuTTY color schemes
- Xfce Terminal color schemes
- FreeBSD vt(4) color schemes
- Previewing color schemes
- MobaXterm color schemes
- LXTerminal color schemes
- Visual Studio Code color schemes
- Windows Terminal color schemes
- Alacritty color schemes
- Ghostty color schemes
- Termux color schemes
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, MobaXterm, LXTerminal, Microsoft's Windows Terminal, Visual Studio, Alacritty
Screenshots below and in the screenshots directory.
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.)
- 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.
Have a great iTerm theme? Send it to me via a Pull Request!
- 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/
mv <your-itermcolors-file> schemes/
- Generate other formats for your theme using the
gen.py
script.cd tools/ && python3 gen.py
ORcd tools/ && ./gen.py
- If you only want to generate files for your theme, you can specify this with the
-s
flag../gen.py -s Dracula
- Get a screenshot of your theme using the
screenshotTable.sh
script and ImageMagick. For screenshot consistency, please have your font set to 13pt Monaco and no transparency on the window.cd tools/ && ./screenshotTable.sh
- this will create a color table for your theme that you can screenshot.- Use ImageMagick (or some other tool) to resize your image for consistency -
mogrify -resize 600x300\! <path-to-your-screenshot>
- Move your screenshot into
screenshots/
-mv <your-screenshot> screenshots/
- Update
README.md
andscreenshots/README.md
to include your theme and screenshot. Also updateCREDITS.md
to credit yourself for your contribution.
Do you want to convert existing iTerm themes to themes for your favorite terminal/editor/etc?
- Get config file from your terminal/editor/etc.
- Change actual colors in config to template placeholders from the list below.
{{ Background_Color }}
{{ Bold_Color }}
{{ Cursor_Color }}
{{ Cursor_Text_Color }}
{{ Foreground_Color }}
{{ Selected_Text_Color }}
{{ Selection_Color }}
{{ Ansi_0_Color }} // black
{{ Ansi_1_Color }} // red
{{ Ansi_2_Color }} // green
{{ Ansi_3_Color }} // yellow
{{ Ansi_4_Color }} // blue
{{ Ansi_5_Color }} // magenta
{{ Ansi_6_Color }} // cyan
{{ Ansi_7_Color }} // white
{{ Ansi_8_Color }} // bright black
{{ Ansi_9_Color }} // bright red
{{ Ansi_10_Color }} // bright green
{{ Ansi_11_Color }} // bright yellow
{{ Ansi_12_Color }} // bright blue
{{ Ansi_13_Color }} // bright magenta
{{ Ansi_14_Color }} // bright cyan
{{ Ansi_15_Color }} // bright white
Each color has these fields:
- {{ Background_Color.hex }} for hex representation
- {{ Background_Color.rgb }} for rgb representation as a "(r, g, b)" string
- {{ Backgroun_Color.guint16 }} for guint16 representation
Also you have access to this metadata fields:
- {{ Guint16_Palette }} with a string containing all ansi colors as guint16 values
- {{ Dark_Theme }} which contains a sign that the theme is dark
- If you need a new value type for color, add it too
tools/converter.py
- Put your template file into
tool/templates
. A folder with schemas will be created based on the filename. And the file extension will remain with all generated ones. Example:editor.ext
file will generate schemas aseditor/scheme_name.ext
- Generate all existing themes for all templates
cd tools/ && ./gen.py
. Or, if you only want to generate schemas for your template, you can use the-t
flag.
./gen.py -t kitty
- If in the process you had to add new dependencies or update the version of python, do not forget to indicate this in
requirements.txt
or.python-version
.