Skip to content

Latest commit

 

History

History
1720 lines (960 loc) · 36.2 KB

README.md

File metadata and controls

1720 lines (960 loc) · 36.2 KB

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, MobaXterm, LXTerminal, Microsoft's Windows Terminal, Visual Studio, Alacritty

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

Prerequisites

  1. For convenient work with generation scripts, it is recommended to install pyenv.
  2. Run pyenv install inside project folder to install python version from .python-version file.
  3. Run pip install -r requirements.txt to install the project dependencies.

How to add new theme

Have a great iTerm theme? Send it to me via a Pull Request!

  1. 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
  2. Put your theme file into /schemes/
    • mv <your-itermcolors-file> schemes/
  3. Generate other formats for your theme using the gen.py script.
    • cd tools/ && python3 gen.py OR
    • cd tools/ && ./gen.py
  4. If you only want to generate files for your theme, you can specify this with the -s flag.
    • ./gen.py -s Dracula
  5. 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/
  6. Update README.md and screenshots/README.md to include your theme and screenshot. Also update CREDITS.md to credit yourself for your contribution.

How to add new template

Do you want to convert existing iTerm themes to themes for your favorite terminal/editor/etc?

  1. Get config file from your terminal/editor/etc.
  2. 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
  1. If you need a new value type for color, add it too tools/converter.py
  2. 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 as editor/scheme_name.ext
  3. 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
  1. 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.

Screenshots

3024 Day

Screenshot

3024 Night

Screenshot

Aardvark Blue

Screenshot

Abernathy

Screenshot

Adventure

Screenshot

AdventureTime

Screenshot

Afterglow

Screenshot

Alabaster

Screenshot

AlienBlood

Screenshot

Andromeda

Screenshot

Apple Classic

Screenshot

Apple System Colors

Screenshot

Arcoiris

Screenshot

Argonaut

Screenshot

Arthur

Screenshot

AtelierSulphurpool

Screenshot

Atom

Screenshot

Atom One Light

Screenshot

ayu

Screenshot

ayu Light

Screenshot

ayu Mirage

Screenshot

Aurora

Screenshot

Banana Blueberry

Screenshot

Batman

Screenshot

Belafonte Day

Screenshot

Belafonte Night

Screenshot

BirdsOfParadise

Screenshot

Blazer

Screenshot

BlueBerry Pie

Screenshot

BlueDolphin

Screenshot

Blue Matrix

Screenshot

Bluloco Dark

Screenshot

Bluloco Light

Screenshot

Borland

Screenshot

Breeze

Screenshot

Bright Lights

Screenshot

Broadcast

Screenshot

Brogrammer

Screenshot

C64

Screenshot

Calamity

Screenshot

Catppuccin Frappé

Screenshot

Catppuccin Latte

Screenshot

Catppuccin Macchiato

Screenshot

Catppuccin Mocha

Screenshot

CGA

Screenshot

Chalk

Screenshot

Chalkboard

Screenshot

ChallengerDeep