Termix - Terminal Theme Manager

Terminal style demo

Real dashboard look for docs and releases

Use this visual preview in GitHub Pages, README screenshots, or release notes so users can see the terminal style before installing Termix.

Termix terminal UI with theme preview, activity log, and footer

Open SVG Fix font warning

TUI style system

Consistent terminal surfaces

TERMIX v0.2.13Dark

Navigation

› Themes

Fonts

Real PreviewOh My Posh

Prompt

Admin~/workspace

main

READY rendered by Oh My Posh

FontsFallback

Font Manager

MesloLGM active

I installs, Enter saves

Theme Gallery

Preview 120+ Oh My Posh themes

Termix includes a growing gallery of 120+ terminal themes. Browse, preview, and choose the perfect prompt style for PowerShell, Git Bash, WSL, and more.

Select a theme -

Click a theme thumbnail below to see its full preview.

Install

Install Termix without Go

Normal users do not need to clone the repository or install Go. Use the installer script from GitHub Pages. The script downloads the latest Termix binary from GitHub Releases, asks before replacing an existing install, then bootstraps Oh My Posh, MesloLGM Nerd Font, official Oh My Posh themes, and terminal/VS Code font settings. Close and reopen your terminal after install so the font profile setting is loaded by the terminal app.

Windows PowerShell

& ([scriptblock]::Create((irm https://muyleanging.github.io/Termix-Tui/install.ps1)))

termix setup
termix-tui

Pin a release or skip the update prompt with -Version v0.2.13 -Yes.

macOS / Linux

curl -fsSL https://muyleanging.github.io/Termix-Tui/install.sh | bash

termix setup
termix-tui

Pin a release or skip the update prompt with bash -s -- --version v0.2.13 --yes.

Manual download

GitHub Releases

You can also download Termix manually from GitHub Releases:

Download latest release

Developer build

Build from source

This is only for contributors or developers.

Windows developer build

go mod tidy
go test ./...
go build -o bin/termix.exe .
.\bin\termix.exe tui

macOS / Linux developer build

go mod tidy
go test ./...
go build -o bin/termix .
./bin/termix tui

Setup and recovery

Clean setup, repair, reinstall, and uninstall

Termix keeps theme files, cache metadata, shell profile blocks, and font settings separate. That means broken cache can be cleared without deleting themes, and shell profile integration can be repaired without duplicating Oh My Posh commands.

First-time setup

termix setup
termix-tui

Picks the target shell profile, verifies official themes, and applies the default Termix font/theme.

Clean reinstall

termix reinstall
termix reinstall --dry-run

Clears cache metadata, rebuilds official theme cache, repairs the managed profile block, saves config, and runs with fallback fonts.

Repair broken state

termix repair
termix profile repair "PowerShell 7"

Fixes CONFIG NOT FOUND, missing theme paths, duplicate profile blocks, and stale cache references.

Theme source and cache

termix themes update
termix cache rebuild
termix cache clear

Official themes come from Oh My Posh themes. Clearing cache removes metadata only; downloaded theme files stay available.

Safe profile block

# BEGIN TERMIX THEME
oh-my-posh init pwsh --config "FULL_THEME_PATH" | Invoke-Expression
# END TERMIX THEME

Termix backs up profile files and replaces only its managed block, so repeated apply commands do not create duplicates.

Uninstall

termix uninstall
termix uninstall profile
termix uninstall cache
termix uninstall downloaded-themes
termix uninstall config

Bare uninstall asks for confirmation, then removes Termix-managed profile blocks, config, cache, downloaded themes, external tools, and the executable. Component commands remove only that part.

CLI

Common commands

Command	Purpose
`termix`	Show CLI help and available commands.
`termix tui` or `termix-tui`	Launch the dashboard.
`termix setup`	Run first-time profile, font, and theme setup.
`termix repair --dry-run`	Preview profile, cache, theme, and font repairs without writing files.
`termix reinstall`	Clean broken cache, rebuild official themes, repair profile integration, save config, and mark setup complete.
`termix themes`	List discovered Oh My Posh theme files.
`termix themes update`	Download official Oh My Posh themes and rebuild cache.
`termix themes apply catppuccin_mocha --profile "PowerShell 7"`	Write or replace the managed Oh My Posh block in the selected profile.
`termix cache rebuild`	Rebuild cache from real theme files. If none exist, Termix imports official themes.
`termix doctor`	Check terminal, shell, Unicode, WSL, and Oh My Posh health.
`termix fonts list`	Show recommended fonts and installed/missing status.
`termix fonts apply "MesloLGM Nerd Font"`	Save the font in Termix and apply it to supported terminal settings with backups.
`termix fonts install "MesloLGM Nerd Font" --yes`	Install a supported Nerd Font only after explicit confirmation.

Docs

How Termix works

Termix separates terminal design into three parts: the shell profile, the Oh My Posh prompt theme, and the terminal font. This keeps profile setup predictable and makes it easier to preview safely before writing profile files.

Select the profile you want to design.
Import and preview themes.
Pick a Nerd Font that supports prompt glyphs.
Confirm the target profile before applying.
Use Doctor to check missing tools.
Use termix repair for CONFIG NOT FOUND, stale theme cache, or duplicate profile blocks.
Use ? or h for Termix help. Termix does not use F1.

Fonts

Install, choose, and customize fonts

Termix uses Meslo through Oh My Posh for prompt icons. Fonts are installed on the host system and selected by the terminal app, not by the shell profile. That means WSL and containers must use the font configured in Windows Terminal, VS Code, Apple Terminal, or the host terminal emulator.

Recommended font

MesloLGM Nerd Font.

Fallback stack

MesloLGM Nerd Font, monospace.

Fonts page controls

I installs Meslo. Enter saves it in Termix. W applies it to Windows Terminal, Apple Terminal, and VS Code where supported. R rescans.

Windows install

oh-my-posh font install meslo
termix fonts apply "MesloLGM Nerd Font"

macOS install

oh-my-posh font install meslo
termix fonts apply "MesloLGM Nerd Font"

Apple Terminal uses MesloLGM Nerd Font Mono. Termix applies that face through AppleScript when available, or prints the manual setting to choose.

Linux install

oh-my-posh font install meslo
termix fonts apply "MesloLGM Nerd Font"

If your terminal emulator cannot be edited automatically, choose MesloLGM Nerd Font in its preferences.

Task	Steps
Fix missing font warning	Open `termix`, go to Fonts, install a recommended Nerd Font with `I`, press `R` to rescan, then press `Enter` to save it in Termix.
Install Nerd Font	Highlight `MesloLGM Nerd Font`, press `I`, confirm with `Y`, then press `R` to rescan. Termix uses `oh-my-posh font install meslo`.
Add custom font	Termix is Meslo-first. Use `termix fonts apply "MesloLGM Nerd Font"` for the supported automatic setup.
Manual macOS terminal setup	Open `Terminal > Settings > Profiles > Text > Font`, choose `MesloLGM Nerd Font Mono`, then restart Terminal. Termix also tries to apply this through AppleScript.
Manual Windows Terminal setup	Run `termix fonts apply "MesloLGM Nerd Font"` or open Windows Terminal settings and set the default profile font face to `MesloLGM Nerd Font`.

Why do icons show boxes or question marks?

A Nerd Font may be installed but the current terminal profile is still using another font. Run termix fonts apply "MesloLGM Nerd Font", then close every terminal tab and open a new terminal. For WSL or containers, install and configure the font on the host terminal app.

Windows Terminal font setting

{
  "profiles": {
    "defaults": {
      "font": {
        "face": "MesloLGM Nerd Font"
      }
    }
  }
}

VS Code terminal font setting

"terminal.integrated.fontFamily": "MesloLGM Nerd Font"

Restart the integrated terminal after changing this setting.

Apple Terminal font setting

Open Terminal > Settings > Profiles > Text > Font, select the active profile, choose MesloLGM Nerd Font Mono, then restart Terminal.

osascript -e 'tell application "Terminal" to set font of settings set "Basic" to "MesloLGM Nerd Font Mono"'

Themes only show the small starter set

Run termix install themes, then termix cache rebuild, and reopen termix-tui. The installer also runs the official theme download during the 75% bootstrap step.

The installer font step failed

Run oh-my-posh font install meslo, then termix fonts apply "MesloLGM Nerd Font". Font install failures do not stop the Termix binary or official themes from installing.

Keyboard

Windows Terminal F1 popup

Termix does not depend on the Windows Terminal F1 help shortcut. If Windows Terminal still opens its Help/About popup before Termix receives keyboard input, unbind F1 in Windows Terminal settings.json:

{
  "command": "unbound",
  "keys": "f1"
}

Troubleshooting

Common fixes

Problem	Fix
CONFIG NOT FOUND	Run `termix repair`, then apply a theme with `termix themes apply catppuccin_mocha --profile "PowerShell 7"`.
Theme cache empty	Run `termix themes update` or `termix cache rebuild`. Cache rebuild never deletes downloaded themes.
Missing MesloLGM Nerd Font	Run `oh-my-posh font install meslo`, then `termix fonts apply "MesloLGM Nerd Font"`. Missing Nerd Font is a warning, not a startup failure.
PowerShell prompt did not change	Run `termix profile repair "PowerShell 7"`, restart the terminal, or reload the PowerShell profile.
Duplicate profile commands	Run `termix repair`. Termix replaces one managed block instead of appending duplicates.

Contribute

Open source project

Report issues

Include your OS, shell, terminal app, Termix version, and the command or TUI screen where the issue happened.

Request updates

Suggest new shells, font providers, theme sources, preview improvements, or setup workflow changes.

Contribute code

Run go test ./... before opening a pull request. Keep changes scoped and easy to review.

Founder and contact

Ing Muyleang

Founder & Maintainer of Termix

Termix is an open-source project founded and maintained by Ing Muyleang. I build tools that make developer terminals easier to customize, repair, and manage across Windows, macOS, Linux, PowerShell, Git Bash, and WSL.

Visit Website Send Feedback Report Issue Request Feature