mrkeyoor.com_
Sun 04 Oct 06:24 UTC
Dev Toolsevaluationupdated 04 Oct 2026

iTerm2-Color-Schemes review

iTerm2 Color Schemes is a large collection of terminal palettes with previews and ready-made files for iTerm2, Windows Terminal, Ghostty, Kitty, Konsole, Alacritty, and many other programs. It saves you from translating the same ANSI colors into each application's configuration format by hand.

Verdict

Our run installed 36 packages in 14 seconds and built in 1 second, but it found no test target, so this is an easy catalog to consume and a less reassuring codebase to change. Use it when you want one palette across several terminal programs or want to compare a large number of choices. Packagers should resolve the open theme-licensing question before redistributing the whole collection.

We ran it

Lab card: what happened when we ran iTerm2-Color-SchemesScreenshot of iTerm2-Color-Schemes (terminalthemes.com)
Install✓ · 14s36 packages · 36 MB
Build✓ · 1s
Testsn/ano test script
Known vulns0(pip-audit)
Repo27807 files~87,181 lines of source · 52.9 MB · 2 CI workflows · Dockerfile

Answers from our run

Does iTerm2-Color-Schemes build from source?

Dependencies installed in 14 seconds (36 packages), and the build succeeded in 1 seconds. We cloned commit 3273816 into a clean Debian container with 3 CPUs and no project-specific setup.

Does iTerm2-Color-Schemes have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does iTerm2-Color-Schemes have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use iTerm2-Color-Schemes?

Teams that need a tested software package: the repository exposes no tests script or target, and our sandbox therefore skipped tests.

What are the alternatives to iTerm2-Color-Schemes?

Gogh, Dracula for iTerm, Catppuccin for iTerm2. Our run installed 36 packages in 14 seconds and built in 1 second, but it found no test target, so this is an easy catalog to consume and a less reassuring codebase to change.

Setup4/5Finished themes are simple; contribution tooling adds 36 packages
Docs4/5Many terminal-specific instructions and clear contribution steps
Community5/527,244 stars and new pull requests on October 4
Maturity4/5Wide format coverage, but no test target and licensing is unresolved

Who it’s for

Terminal users who want to browse hundreds of palettes before choosing one.
Developers who move among macOS, Linux, Windows, and several terminal emulators.
Tool authors who need source palettes in YAML or Windows Terminal JSON.
Theme contributors willing to use the Python generator and review its output across many target formats.

Who it’s NOT for

Teams that need a tested software package: the repository exposes no tests script or target, and our sandbox therefore skipped tests.
Accessibility policies that require every included palette to pass a contrast gate: the contribution guide says the WCAG check is optional and failing checks are acceptable.
Distributions that need settled redistribution rights for every bundled theme: open issue 638 documents unclear or restrictive licensing and remains parked for a product or legal decision.
Users expecting one automatic installer for every terminal: iTerm2 has an import script, while several other targets require copying files or pasting configuration.
People who want one tightly controlled theme family: this is a broad catalog, so consistency across hundreds of independently sourced palettes is not its promise.

Setup reality

Our sandbox installed commit 3273816 in 14 seconds, adding 36 packages and using 36 MB. The build passed in 1 second. There was no tests script or target, so testing was skipped; the repository also had no tests directory. Pip-audit found 0 known vulnerabilities.

Using a finished theme needs no account, API key, or background service. iTerm2 imports .itermcolors files through its preferences or the supplied shell script. Contributors need Python dependencies for generation and screenshots, or Docker to isolate that toolchain.

Each terminal has its own application step. Some accept copied files, others need pasted configuration, a registry merge, or a restart. The checkout itself is 52.9 MB with 27,807 files, so cloning everything is excessive when a release archive for one terminal will do.

More than 600 palettes make format conversion the main attraction

The repository starts with iTerm2, but its useful trick is repetition done for you. The same palette appears in formats for Windows Terminal, Ghostty, Kitty, Konsole, Alacritty, PuTTY, Xresources, Termux, Vim, and many more targets. If you use three terminals across work and personal machines, that breadth saves a tedious round of translating foreground, background, cursor, selection, and 16 ANSI colors.

Breadth also explains the odd shape of the checkout. Our clone held 27,807 files and about 87,181 lines of source in 52.9 MB. Much of the value is data and generated configuration rather than an application you keep running. You can download only the format you need instead of carrying the full repository.

The source side is useful beyond manual browsing. Committed YAML files give importers a machine-readable palette, while Windows Terminal files are already JSON objects. Running tools/gen.py also produces a local JSON Lines file with the full color map used by screenshot tooling. That makes this collection usable as input to another theme browser or configuration generator, provided you respect each theme's redistribution terms.

iTerm2 imports cleanly, while other terminals need manual steps

The iTerm2 path is direct: open the Colors tab, import one or more .itermcolors files, select a preset, and restart the application when using the supplied import script. The script accepts a file path, a displayed scheme name, or several names. None of those routes needs an account, network service, or credential after you have the files.

Other formats are less uniform because the host applications differ. Konsole expects files in one of two configuration directories. Windows Terminal asks you to paste a JSON object into its schemes configuration. PuTTY uses Registry files, and the guide explains both creating a new session and modifying an existing one. Ghostty, Alacritty, Otty, Rio, Termux, and Vim each get separate instructions. This is a well-organized parts shelf, not a cross-platform theme manager.

The safe preview tool helps before you touch configuration. preview_theme.py renders ANSI colors, surface colors, and semantic samples with truecolor escape codes without changing the terminal palette. A separate generic preview script does mutate the current session through OSC 4 codes. That distinction is documented plainly, including the warning that the older Ruby preview is deprecated and broken with current iTerm color files.

What happened when we ran it

Our sandbox installed commit 3273816 in 14 seconds, pulling 36 packages and using 36 MB on disk. The build completed in 1 second. The run used an unprivileged Debian container with 3 CPUs, 8 GB of RAM, Python 3.12, and no secrets. Pip-audit reported 0 known vulnerabilities. The repository had a Dockerfile and 2 CI workflow files.

There was no tests script or target, so our pipeline skipped tests. We also found no tests directory. That result does not mean a test failed, and it does not prove the generated files are wrong. It means commit 3273816 offered no automated suite for our sandbox to run after the successful build. For a catalog producing thousands of terminal-specific files, that is a meaningful gap for contributors.

The consumer risk is smaller because a palette is configuration, not a resident process. You can preview one scheme, import it, and switch back if it looks poor. Generator changes have a wider blast radius: a new template or converter value can affect every theme emitted for that target. Without a test target, review should include generated diffs and opening representative outputs in the programs they claim to support.

Contributors generate formats from iTerm2 or YAML sources

A new theme begins as an iTerm2 file or a YAML definition. The guide requires human-readable filenames and tells contributors to quote names containing spaces. tools/gen.py then emits the other formats, while the screenshot module fills missing previews. Docker can run the generation work without installing Python dependencies on the host, although contributors still update the README and credits manually.

Contrast checking is optional. The documented command checks an iTerm2 file, and YAML inputs must be generated first. The guide says failed checks are acceptable because the generator may adjust colors toward a minimum 1.75:1 threshold. That is honest documentation, but it is not a promise that every included palette passes an accessibility policy. Teams with contrast requirements need to apply their own threshold to the exact foreground and background pairs they will ship.

Whole-catalog redistribution still needs a license decision

GitHub's repository metadata did not identify a standard SPDX license. More importantly, open issue 638 concerns the licenses of individual themes, not merely the generator code. The reporter's review classified 225 of 443 examined themes as having unknown, unclear, or nonfree terms. Maintainer comments thanked the reporter, and the latest update left the issue open pending an explicit product or legal decision.

That issue changes the recommendation for package maintainers. A person importing one palette for personal use faces a different decision from a Linux distribution or terminal vendor bundling the entire catalog. We cannot settle those rights from an issue thread. Package only themes whose provenance and terms you have checked, or wait for the project to publish a resolved policy.

October pushes show active catalog maintenance

The repository was pushed on October 4, 2026, with two theme pull requests updated that day. GitHub listed 27,244 stars and 3 combined open issues and pull requests. The latest release arrived on September 28 with new palettes, fixes for four unparseable iTerm2 schemes, and per-terminal archives. Those dates describe a collection being maintained, despite the absence of an automated test target.

For an individual developer, the collection is easy to recommend: preview a palette, download the narrow archive, and import the one file you want. The 52.9 MB checkout and 36-package contributor environment are unnecessary for that job. Forking, packaging, or generating the catalog deserves more care because tests are absent and theme licensing remains unresolved.

Alternatives

ProjectWhat it isPick it when
GoghA terminal color collection centered on Linux terminals, with macOS compatibility.pick this instead when GNOME Terminal, Pantheon Terminal, Tilix, or XFCE is your main target.
Dracula for iTermThe official iTerm package for the Dracula dark theme.pick this instead when you already want Dracula and prefer a small, single-theme repository.
Catppuccin for iTerm2The official iTerm2 port of Catppuccin's four palettes.pick this instead when a coordinated palette family matters more than a catalog of unrelated choices.

What people are saying

  1. [velocity-scout] mbadolato/iTerm2-Color-Schemes

Sources

  1. iTerm2 Color Schemes README
  2. Terminal Themes September 28 release
  3. Theme licensing issue 638
  4. YAML source format guide
  5. iTerm2 Color Schemes GitHub repository

More dev tools reviews

github-stars-history · BrokenPipe · FGOAC-scooby · plexo · window-sweaters · qingjian · the whole board →