Tokyo Night Tmux

A clean, dark Tmux theme inspired by the lights of Tokyo at night. Adapted from the Tokyo Night VS Code theme — the perfect companion for tokyonight-vim.

Preview

Terminal: Kitty · Font: SFMono Nerd Font Ligaturized

Quick start

1. Install dependencies

Nerd Fonts v3+ and Bash 4.2+ are required.

brew install --cask font-monaspace-nerd-font font-noto-sans-symbols-2
brew install bash bc coreutils gawk gh glab gsed jq nowplaying-cli

pacman -Sy bash bc coreutils git jq playerctl

apt-get install bash bc coreutils gawk git jq playerctl

apk add bash bc coreutils gawk git jq playerctl sed

→ Full dependency list: user_docs/installation.md

2. Install the plugin

Add to ~/.tmux.conf and press prefix + I to install:

set -g @plugin "janoamaral/tokyo-night-tmux"

3. Pick a theme (optional)

set -g @tokyo-night-tmux_theme night   # night (default) | storm | moon | day
set -g @tokyo-night-tmux_transparent 1 # transparent background

4. Enable widgets (optional)

set -g @tokyo-night-tmux_show_git 1             # local git status
set -g @tokyo-night-tmux_show_wbg 1             # GitHub / GitLab stats
set -g @tokyo-night-tmux_show_netspeed 1        # network speed
set -g @tokyo-night-tmux_show_battery_widget 1  # battery level
set -g @tokyo-night-tmux_show_music 1           # now playing
set -g @tokyo-night-tmux_show_path 1            # current path
set -g @tokyo-night-tmux_show_hostname 1        # machine hostname

Reload your config: tmux source ~/.tmux.conf

Features

Documentation

Contributing

Important

Please read the contribution guide before opening a PR.

Feel free to open an issue or pull request with suggestions or improvements. Ensure your editor follows .editorconfig. pre-commit hooks are provided for code consistency and will run against all PRs.