mjswensen /themer
🎨 themer takes a set of colors and outputs themes for your apps (editors, terminals, wallpapers, and more).
★ 5,868⑂ 135👁 35⑃ 94● 78▤ 14
+0
Daily
5,868
stars
135
forks
35
watchers
94
prs
78
issues
14
releases
README
themer !GitHub Workflow Status (main branch)
themer takes a set of colors and generates editor themes, terminal themes, themes for other apps, and desktop wallpapers.
!visual description
Table of contents
- Getting started
- CLI documentation
- Installation
- Usage
- Example workflow: dotfiles integration
- Example workflow: npx
- Example workflow: using base16 schemes with Themer
- API documentation
- Installation
- Interface
- Create custom ColorSets
- Color mappings
- Create custom Templates
- Themer color sets
- Web-only color sets
- Original color sets
- Ports from third-party themes
- Themer templates
- Terminals
- Editors/IDEs
- Other apps
- Wallpapers
- Prior art
- Contributing
Getting started
There are a few different ways to level up your development setup with themer:
1. Web-based graphical user interface. themer has an official progressive web app located at themer.dev.
2. Command-line interface. themer can be used to generate themes on the CLI, see the CLI docs below.
3. Application programming interface. themer exposes a JavaScript API (complete with TypeScript type definitions) for programmatic use; see the API docs below.
Feature comparison:
| | Web UI | CLI/API |
| ----------------------------- | -------------- | -------- |
| Instant preview | ✅ | ❌ |
| Supported color format | Any CSS format | Hex only |
| Wallpaper output format | PNG + SVG | SVG only |
| Raytraced 3D wallpaper | ✅ | ❌ |
| Seamless dotfiles integration | ❌ | ✅ |
CLI documentation
As of V5, themer is distributed as a single TypeScript/JavaScript package containing all built-in color sets and templates for ease of use—but still supports the use of custom color sets or templates.
Installation
Install themer from npm with your JavaScript package manager of choice.
sh
npm install themer
themer can also be installed globally. Or if you prefer not to install it at all, it can be used with npx.
Usage
sh
themer [options]
Pass themer one or more color sets, as many templates as you wish, as many wallpaper resolutions as you wish, and an output directory.
| Option | Description | Default value | Available options |
| ----------------------------------------------------------- | -------------------------------------------------------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Top issues
#9GTK3 theme?8 comments · 2017-09-24#63Theme support for Notepad++3 comments · 2020-05-15#126Kate editor support1 comments · 2022-01-31#173Fix broken base16 links on README0 comments · 2026-06-27#170Add Lazygit theme generation support0 comments · 2026-05-26#169Add Ghostty theme generation support0 comments · 2026-05-26#160Utilize better color space for calculated shades0 comments · 2024-02-24#159Support for wezterm0 comments · 2024-01-20
Latest release
v6.0.0 v6.0.0 2023-12-30The primary breaking change from v5 → v6 is that rendered files use strings instead of Buffers for their contents (this change may affect some programmatic API users but should not affect CLI-only users).