PULT

A universal remote for your colors

Pult is a terminal app that themes your other apps from one palette. It finds the apps you have, writes only their color settings, shows a dry run first, and pult uninstall puts every file back.

READ THE DOCS INSTALL

Change the
channel

A browser mock-up of pult tui, with eight real palettes from the catalog. Click the list, then j and k move, enter applies and u goes back. The real app asks y/N before it writes anything.

Pult themes apps
/ search · 1-9 tags · s similar · enter apply · u undo · q quit
  • catppuccin-mochaCatppuccin Mochacool,dark,pastel
  • draculaDraculacool,dark,high-contrast
  • nordNordcool,dark,muted
  • gruvbox-darkGruvbox Darkdark,warm
  • kanagawaKanagawadark
  • everforest-darkEverforest Darkdark,pastel
  • ayu-darkAyu Darkdark,high-contrast,pastel
  • rose-pine-dawnRose Pine Dawncool,light,low-contrast

shell

~/src/pult on main
> ls
cmd  docs  internal  registry
README.md  Makefile  go.mod

delta: kitty.conf

 font_size 12
+include pult.conf

btop

cpu
58%
mem
41%

Colors, and nothing else

  1. Find what you have

    pult list

    Checks which of the 20 supported apps are installed and which tool, if any, owns each config file.

  2. Read the plan

    pult apply -dry-run catppuccin-mocha

    Prints every file it would touch and a diff for each. Nothing is written.

  3. Apply

    pult apply catppuccin-mocha

    Uses the app's include or theme mechanism where it has one, so your other settings stay as they are. Each file is recorded before it changes.

  4. Put it back

    pult uninstall

    Restores every changed file. If you edited a file after Pult wrote it, Pult leaves your edit alone unless you pass -force.

$ pult apply -dry-run catppuccin-mocha
alacritty  skip: not installed
bat        ~/.config/bat/config via ansi, 1 file(s)
ghostty    ~/.config/ghostty/config via include, 2 file(s)
kitty      ~/.config/kitty/kitty.conf via include, 2 file(s)
...

--- ~/.config/kitty/kitty.conf
+++ ~/.config/kitty/kitty.conf (Pult)
@@ -1,1 +1,2 @@
 font_size 12
+include pult.conf

What it covers

20 apps

Terminals
Alacritty, Ghostty, kitty, foot, iTerm2, WezTerm, Terminal.app
Shell
fish, Starship, tmux, Zellij
Tools
bat, btop, cava, delta, eza, Helix, lazygit, lsd, Yazi

WezTerm and Terminal.app get manual setup instructions.

About 2,700 themes

From iTerm2 Color Schemes, Tinted Theming, Catppuccin, Dracula and Gogh. About 1,800 ship with their colors. The rest download when you apply them. Search by name or tag, list close matches, or bring your own palette as a JSON or TOML file.

Your other tools

Files managed by stow, chezmoi, matugen, wallust, pywal or a Hyprland framework are written only after you confirm. On Omarchy, Pult writes an Omarchy theme and switches to it instead of editing Omarchy's files.

Install

Arch Linux, from the subcult pacman repository on git.subcult.tv. Gitea signs it with its own key.

curl -fsS https://git.subcult.tv/api/packages/subculture-collective/arch/repository.key | sudo pacman-key --add -
sudo pacman-key --lsign-key CCE8B0F3BCDD601D909773E4466AA6E8241453D2
printf '\n[subcult]\nSigLevel = Required\nServer = https://git.subcult.tv/api/packages/subculture-collective/arch/$repo/$arch\n' | sudo tee -a /etc/pacman.conf
sudo pacman -Sy pult
pult tui

Linux and macOS tarballs with the catalog built in are on the releases page. More in the docs.

Batteries not included

SUBCULT builds Pult and pays for the hours and the hosting. Pult stays public, and paying doesn't unlock anything in it. If you want to chip in, the money goes to the studio.

SUPPORT ON PATREON