Skip to content

dvelton/terminal-profile-studio

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Terminal Profile Studio

CLI is everyone's new home. Let's spruce it up.

You spend 8+ hours a day staring at monospaced text on a colored rectangle. That rectangle deserves better than the default profile it shipped with in 2009. This tool lets you craft the terminal aesthetic you didn't know you needed — pick your colors, tweak your fonts, slide your opacity to "just transparent enough to see your desktop wallpaper but not enough to actually read it" — and export a ready-to-import profile for whatever terminal app you're running.

Terminal Profile Studio

Pick a preset, tweak to taste, export to your terminal. Here are a few of the 24 built-in presets:

Copilot Northern Lights Frosted Mint
Copilot Northern Lights Frosted Mint
Arcade Cabinet BBS 1994 Tokyo Drift
Arcade Cabinet BBS 1994 Tokyo Drift
Cherry Blossom Desert Oasis Espresso Shot
Cherry Blossom Desert Oasis Espresso Shot

What This Does

An interactive, browser-based terminal profile designer with:

  • Live preview that updates as you tweak — see real terminal output (git status, ls, error messages) rendered in your chosen palette
  • Preset themes to start from — Copilot, GitHub Dark, GitHub Light, Security, and more
  • Full color control — background, foreground, cursor, selection, bold text, and all 16 ANSI colors
  • Beyond colors — font family, font size, cursor style, cursor blink, window dimensions, background opacity
  • Contrast checker — real-time WCAG contrast ratios so your "aesthetic" choices don't render your terminal unreadable
  • Multi-format export — generates downloadable profiles for macOS Terminal (.terminal), iTerm2 (.itermcolors), Windows Terminal (JSON), and Alacritty (TOML)
  • Shareable URLs — your entire config is encoded in the URL fragment, so you can share your creation (or inflict it on a coworker)

How To Use It

  1. Visit the live site
  2. Pick a preset or start from scratch
  3. Adjust colors, fonts, and settings to taste
  4. Watch the live preview update in real-time
  5. Export to your terminal format of choice
  6. Import the file using the instructions below
  7. Bask in the mass compliments about your terminal

Importing Your Profile

macOS Terminal (.terminal)

macOS Gatekeeper will warn you about the downloaded file because it came from a web browser. This is normal — it happens with any file downloaded from the internet, not just this tool. To get past it:

  1. Right-click the downloaded .terminal file and select Open, or
  2. Run this in Terminal first to remove the quarantine flag:
    xattr -d com.apple.quarantine ~/Downloads/Terminal\ Studio\ Profile.terminal
    
  3. Double-click the file — it opens a preview window and adds the profile to Terminal > Settings > Profiles
  4. Set it as your default from the Profiles list if you want it to stick

iTerm2 (.itermcolors)

  1. Open iTerm2 > Settings > Profiles
  2. Select the profile you want to modify (or create a new one)
  3. Go to the Colors tab
  4. Click the Color Presets dropdown at the bottom right
  5. Select Import and choose the downloaded .itermcolors file
  6. Select the imported preset from the same dropdown to apply it

Font, cursor, and window settings need to be set manually in iTerm2's profile settings — the .itermcolors format only carries color data.

Windows Terminal (.json)

The export gives you a JSON file with a color scheme and profile settings. To apply it:

  1. Open Windows Terminal > Settings > Open JSON file (or press Ctrl+Shift+,)
  2. Copy the schemes array entry from the downloaded file and paste it into your settings.json under the "schemes" key
  3. Copy the profile settings and merge them into your profile under "profiles" > "defaults" (or a specific profile)
  4. Save the file — Windows Terminal picks up changes immediately

Alacritty (.toml)

The export gives you a TOML config snippet. To apply it:

  1. Open your Alacritty config file:
    • macOS: ~/.config/alacritty/alacritty.toml
    • Linux: ~/.config/alacritty/alacritty.toml
    • Windows: %APPDATA%\alacritty\alacritty.toml
  2. Paste the contents of the downloaded file into your config (or replace the relevant sections)
  3. Save — Alacritty hot-reloads the config automatically

No Server Required

The entire app runs client-side. No data leaves your browser. The export files are generated in JavaScript and downloaded directly. The shareable URLs encode your config in the URL hash: no backend, no database, no cookies, no tracking.

Running Locally

It's a static site. Open index.html in a browser. That's it.


Built with questionable taste and zero npm packages.

About

We're all living in the terminal now, might as well do some interior design

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors