✨ Highlights

• 🎨 8 built-in themes — Acrylic Glass, five retro palettes, Notes, and AMOLED
• 🖼️ Custom wallpapers — from file, clipboard, or built-in collection
• 🔴🟢🔵 Custom palettes — generate a full 16-color terminal scheme from a single accent color
• 👀 Live preview — see every change in real-time before committing
• 💾 Safe backups — automatic byte-identical backup on first run, one-key restore
• 🎬 Heavily animated — typewriter effects, transitions, and a TUI that sparks joy
• 📦 Zero dependencies — pure Node.js, no build step

Install

npm install -g termcute
termcute

Requires Node.js 18+ and Windows Terminal.

Update to the latest version

If TermCute is already installed globally, update it with:

npm install -g termcute@latest

Features

🎨 Browse Themes

Preview built-in themes live and apply one permanently. Arrow through 8 curated colorschemes while watching your terminal transform in real-time.

🔴🟢🔵 Custom Theme

Pick an accent color with an interactive hue slider. TermCute generates a cohesive 16-color palette, then lets you tweak font size, opacity, and padding — all with live preview.

🖼️ Custom Image

Choose a background image from three sources:

• Local file path — point to any image on disk
• Clipboard paste — grab an image straight from your clipboard
• Built-in wallpapers — pick from the bundled collection

TermCute normalizes the image and lets you dial in the opacity before applying.

⏪ Restore Defaults

Restore the byte-identical Windows Terminal settings saved before TermCute first made a change. One key, zero worries.

CLI

termcute                                      # animated picker
termcute list                                 # list built-in themes
termcute apply <slug>                         # apply a theme permanently
termcute custom-image <path> [--fit smart|crop|pad]
termcute custom-image --clipboard
termcute restore                              # restore original settings

Safety

• The first modification saves settings.termcute-original.json next to Windows Terminal's settings file and never overwrites it.
• Writes are atomic, and live preview is reverted on Esc, Ctrl+C, or a crash.
• No network calls. No telemetry. Your settings stay local.

Built With

| What | How | |------|-----| | TUI framework | Custom — built from scratch with ANSI escape codes + readline | | Color math | Custom HSL ↔ RGB ↔ Hex engine for palette generation | | Animations | Frame-by-frame ASCII art, typewriter effects, screen wipes | | Image handling | PowerShell/.NET interop for clipboard + format normalization | | Dependencies | None. |

Development

git clone https://github.com/vishalx0707/termcute.git
cd termcute
node bin/termcute.js

License

MIT