readme.md

⚡ shifter

A minimalist, versatile and opinionated theme for tmux.

⚠️ Work in Progress: This project is actively evolving. Expect updates and changes. Please use cautiously, and feel free to contribute or suggest features through GitHub issues.

Features

• Opinionated UI with sane defaults 💡
• Support for popular themes like nord and catppuccin 🎨

Check the list of supported themes here.

Installing

Using tpm, add this to your tmux.conf

set -g @plugin 'bettervim/shifter'
set -g @shifter_theme 'nord'

Options

Shifter, while incorporating some opinionated defaults, offers flexibility through customizable global options. To tailor the behavior of Shifter to your specific needs, simply include the desired options after declaring the plugin in your tmux.conf file.

🔗 You can check this tmux conf as a guide.

Setting a theme

set -g @shifter_theme '<theme-name>'

💡 Check the list of available themes.

Window modules

set -g @shifter_theme '<layout>'
# For example:
set -g @shifter_theme '#number: #name'

Available window modules are:

• #number
• #name

💡 You can use any char of your preference as a separator/prefix/sufix inside of '...'

Aside modules

set -g @shifter_aside_modules '<layout>'
# For example:
set -g @shifter_aside_modules '#clock #session-name'

Available aside modules are:

• #clock
• #session-name
• #hostname

💡 You can use any char of your preference as a separator/prefix/sufix inside of '...'

Aside separator

set -g @shifter_aside_separator '<'

Supported themes

• nord
• everforest
• poimandres
• catppuccin

Work in progress, will be released soon ⚙️

• ayu
• dracula
• tokyonight

License

MIT