gnsfujiwara / minimal-tmux-status

A simple minimal tmux theme that does shows prefix key status.

Tmux Status Theme

Introduction

Welcome to the Tmux Status Theme project! This theme was created with a focus on minimalism and essential elements, ensuring a clean and distraction-free Tmux status bar. Whether you're an experienced Tmux user or just getting started, this theme offers a seamless experience with support for the prefix key press.

Features

• Minimalistic Design: Enjoy a clutter-free Tmux status bar that only displays relevant information.
• Prefix Key Support: Easily distinguish between Tmux's standard and prefix modes.

Previews

Without Prefix

With Prefix

GIF

Usage

Installation via Tmux Plugin Manager (TPM)

I recommend using Tmux Plugin Manager (TPM) for easy installation:

1. Add the theme to your list of TPM plugins in your ~/.tmux.conf:

   set -g @plugin 'niksingh710/minimal-tmux-status'

2. Press prefix + I (capital "i", as in Install) to fetch and install the plugin.

3. Reload your Tmux configuration:

   tmux source-file ~/.tmux.conf

That's it! Your Tmux Status Theme is now installed and ready to use.

Tip

Add this line in your tmux config so that you can easily toggle tmux status bar with one keymap.

bind-key b set-option status

Now pressing prefix+b will toggle status bar

Contributing

If you believe this theme can benefit from additional features or improvements without compromising its minimalism, I welcome your contributions. Please create a pull request with your changes, and we'll be happy to review and merge if they align with the project's goals.

Feedback

I value your feedback and suggestions. If you have any ideas for improving this theme or encounter any issues, please don't hesitate to open an issue on GitHub.

License

This project is licensed under the MIT License.

Thank you for considering the Tmux Status Theme for your Tmux setup. I hope it enhances your Tmux experience with its minimalist design and efficient use of screen real estate. Happy coding! 😊👍