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

demo.mp4

Terminal: Kitty · Font: SFMono Nerd Font Ligaturized

---

Quick start

1. Install dependencies

Nerd Fonts v3+ and Bash 4.2+ are required.

macOS

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

Arch Linux

pacman -Sy bash bc coreutils git jq playerctl

Ubuntu / Debian

apt-get install bash bc coreutils gawk git jq playerctl

Alpine Linux

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

Feature	Description
4 color themes	Night, Storm, Moon, Day — plus transparent background
Local git status	Branch, changes, push/pull sync indicator
GitHub / GitLab widget	Open PRs, pending reviews, assigned issues
Netspeed	Upload/download speed with interface detection
Now Playing	Track info via playerctl (Linux) or nowplaying-cli (macOS)
Battery	Level and charge state with contextual icons
Date & Time	Configurable format (YMD/MDY/DMY, 12H/24H)
Path widget	Current pane path (relative or absolute)
Hostname	Machine hostname in the status bar
Number styles	8 styles for window/pane IDs (digital, roman, squares, …)
SSH indicator	Automatic icon change for SSH sessions
Prefix highlight	Visual indicator when tmux prefix is active
Zoom indicator	Separate style for zoomed panes

---

Documentation

Topic	Link
Installation & dependencies	user_docs/installation.md
Color themes & transparency	user_docs/themes.md
Status bar widgets	user_docs/widgets.md
Number styles & window icons	user_docs/customization.md

---

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.