Home

Awesome

Tokyo Night Tmux

example workflow

A clean, dark Tmux theme that celebrates the lights of Downtown Tokyo at night. The perfect companion for tokyonight-vim Adapted from the original, Visual Studio Code theme. The old version (deprecated) is still available in the legacy branch.

<a href="https://www.buymeacoffee.com/jano" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" ></a>

About this theme

This is a very opinionated project, as I am a Tech Lead, this theme is very developer-focused.

Requirements

This theme has the following hard requirements:

The following are recommended for full support of all widgets and features:

macOS

macOS still ships with bash 3.2 so you must provide a newer version. You can easily install all dependencies via Homebrew:

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

Linux

Alpine Linux

apk add bash bc coreutils gawk git jq playerctl sed

Arch Linux

pacman -Sy bash bc coreutils git jq playerctl

Ubuntu

apt-get install bash bc coreutils gawk git jq playerctl

Check documentation for installing on other operating systems.

Installation using TPM

In your tmux.conf:

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

Configuration

Number styles

Run these commands in your terminal:

tmux set @tokyo-night-tmux_window_id_style digital
tmux set @tokyo-night-tmux_pane_id_style hsquare
tmux set @tokyo-night-tmux_zoom_id_style dsquare

Alternatively, add these lines to your .tmux.conf:

set -g @tokyo-night-tmux_window_id_style digital
set -g @tokyo-night-tmux_pane_id_style hsquare
set -g @tokyo-night-tmux_zoom_id_style dsquare

Widgets

For widgets add following lines in you .tmux.conf

Date and Time widget

This widget is enabled by default. To disable it:

set -g @tokyo-night-tmux_show_datetime 0
set -g @tokyo-night-tmux_date_format MYD
set -g @tokyo-night-tmux_time_format 12H
Available Options

Now Playing widget

set -g @tokyo-night-tmux_show_music 1

Netspeed widget

Snap netspeed

set -g @tokyo-night-tmux_show_netspeed 1
set -g @tokyo-night-tmux_netspeed_iface "wlan0" # Detected via default route
set -g @tokyo-night-tmux_netspeed_showip 1      # Display IPv4 address (default 0)
set -g @tokyo-night-tmux_netspeed_refresh 1     # Update interval in seconds (default 1)

Path Widget

set -g @tokyo-night-tmux_show_path 1
set -g @tokyo-night-tmux_path_format relative # 'relative' or 'full'

Battery Widget

set -g @tokyo-night-tmux_show_battery_widget 1
set -g @tokyo-night-tmux_battery_name "BAT1"  # some linux distro have 'BAT0'
set -g @tokyo-night-tmux_battery_low_threshold 21 # default

Set variable value 0 to disable the widget. Remember to restart tmux after changing values.

Styles

New tokyonight Highlights ⚡

Everything works out the box now. No need to modify anything and colors are hardcoded, so it's independent of terminal theme.

TODO

Demo

https://github.com/janoamaral/tokyo-night-tmux/assets/10008708/59ecd814-bc2b-47f2-82b1-ffdbfbc54fbf

Snapshots

Snap 5

Legacy tokyo-night

Snap 4

Contributing

[!IMPORTANT]
Please read the contribution guide first.

Feel free to open an issue or pull request with any suggestions or improvements.

Ensure your editor follows the style guide provided by .editorconfig. pre-commit hooks are also provided to ensure code consistency, and will be run against any raised PRs.