A minimal and clean Base16 colorscheme for tmux.

• tmux >= 3.4 (not tested on earlier versions)

Add this plugin to the list of TPM plugins in .tmux.conf:

set -g @plugin "loichyan/tmux-base16"

Clone the repo:

git clone https://github.com/loichyan/tmux-base16 ~/clone/path

Add this line to the bottom of .tmux.conf:

run ~/clone/path/base16.tmux

Reload tmux environment with tmux source-file ~/.tmux.conf. You should now be able to use the plugin.

Default: #{@base16-palettes}/gruvbox.conf

Description: Path to the base16 palette.

This option is expanded as a FORMAT before it takes effect. Therefore, you can use palettes under @base16-palettes, which is set to the palettes directory included in this plugin.

Default: dark

Description: Which background to use, dark or light.

This option itself does not affect the appearance; instead, palette should be responsible for it value.

Default: rouned

Description: Default border lines for popup windows and menus.

Default: off

Description: Whether to remove backgrounds for most UI elements.

Default: on

Description: Whether to configure tmux's statusline.

Default: #{window_name}#{window_flags}

Description: Content displayed in window tabs when @base16-statusline is enabled.

A command is an executable shell script exported by this plugin, which you can bind keys to.

Description: Toggles the current background between light and dark. You may explicitly specify the desired background as the only argument.

Requirements: Python >= 3.10

Description: A useful script to build palette from configurations. For the structure of the configurations, see palettes/gruvbox.ini.

This plugin also sets several variables that can be used in FORMATs.

From @base00 to @base0F are sixteen palette variables loaded from the provided palette file.

@base16_fg and @base16_bg represent the default foreground and background colors, respectively, depending on your configurations.

This plugin aims to provide a minimal theme that overrides tmux's default colors, so third-party integrations won't be included. Additionally, it comes with a opinionated statusline, but if it doesn’t suit your taste, you can create your own using the exported theme variables.

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.