Create retro terminal skins with CRT effects, scanlines, glow, and more
npm install retro-skins-platformGenerate retro terminal skins with CRT effects, scanlines, glow, and more. Supports WezTerm, Alacritty, Kitty, and Windows Terminal terminal emulators.
``bashClone and install dependencies
cd retro-skins-platform
pnpm install
CLI Commands
$3
List all available retro skins.
`bash
retro-skins list
`Output:
`
šØ Available Skins: ⢠phosphor Phosphor CRT
⢠amber Amber Monochrome
⢠lcd LCD Display
⢠cyber Cyber Purple
⢠terminal Classic Terminal
š Use: retro-skins preview
`---
$3
Preview a skin configuration. Shows all skins if no name given.
`bash
Preview specific skin
retro-skins preview phosphorPreview all skins
retro-skins previewPreview with terminal-specific config
retro-skins preview phosphor --terminal wezterm
`Options:
| Option | Description |
|--------|-------------|
|
-t, --terminal | Preview for specific terminal (wezterm, alacritty, kitty, windows-terminal) |---
$3
Generate terminal configuration directly (non-interactive).
`bash
Generate to stdout
retro-skins generate wezterm phosphor
retro-skins generate alacritty amber
retro-skins generate kitty lcdGenerate to file
retro-skins generate wezterm phosphor --output ~/.config/wezterm/retro_skin.lua
retro-skins generate alacritty cyber --output ~/retro-alacritty.yml
retro-skins generate kitty terminal --output ~/.config/kitty/retro_skin.confDry run (preview without writing)
retro-skins generate wezterm phosphor --dry-run
`Arguments:
| Argument | Description |
|----------|-------------|
|
terminal | Target terminal (wezterm, alacritty, kitty, windows-terminal) |
| skin | Skin name (phosphor, amber, lcd, cyber, terminal, puncore) |Options:
| Option | Description |
|--------|-------------|
|
-o, --output | Write to file instead of stdout |
| --dry-run | Preview without writing files |---
$3
Interactive command to apply a skin to your terminal.
`bash
Interactive mode (prompts for skin selection)
retro-skins apply weztermWith output file
retro-skins apply alacritty --output ~/.config/alacritty/retro_skin.yml
`Arguments:
| Argument | Description |
|----------|-------------|
|
terminal | Target terminal (wezterm, alacritty, kitty, windows-terminal) |Options:
| Option | Description |
|--------|-------------|
|
-o, --output | Write to file instead of stdout |---
Available Skins
| Name | Description | Colors |
|------|-------------|--------|
|
phosphor | Classic green phosphor CRT | #0D0208 ā #00FF41 |
| amber | Amber monochrome display | #1A0F00 ā #FFB000 |
| lcd | Clean LCD display style | #0A0A0A ā #E8E8E8 |
| cyber | Purple cyberpunk aesthetic | #0D0D1A ā #B388FF |
| terminal | Classic blue terminal | #0C0C14 ā #4AF626 |
| puncore | Neon theme | #575757 ā #858585 |---
Usage Flow
`bash
1. List available skins
retro-skins list2. Preview a skin
retro-skins preview phosphor3. Preview terminal-specific output
retro-skins preview phosphor --terminal wezterm4. Generate final config
retro-skins generate wezterm phosphor --output ~/.config/wezterm/retro_skin.lua
`---
Installation Locations
After generating configs, place them in:
| Terminal | Location |
|----------|----------|
| WezTerm |
~/.config/wezterm/retro_skin.lua |
| Alacritty | ~/.config/alacritty/retro_skin.yml |
| Kitty | ~/.config/kitty/retro_skin.conf |---
Development
`bash
Install dependencies
pnpm installBuild
pnpm buildRun tests
pnpm testWatch mode
pnpm dev
`---
Testing
Run integration tests for all three terminals:
`bash
pnpm test
`Tests cover:
- ā
List command
- ā
Preview command (all skins + terminal-specific)
- ā
Generate command (all terminal/skin combinations)
- ā
File output with
--output flag
- ā
Dry-run with --dry-run` flag---
MIT