All Projects → kristijanhusak → tmux-simple-git-status

kristijanhusak / tmux-simple-git-status

Licence: MIT license
Add simple git status to your tmux statusline.

Programming Languages

shell
77523 projects

Tmux simple git status

Prints current pane git branch and uncommitted changes (if available).

screenshot

Installation

Installation with Tmux Plugin Manager (recommended)

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

set -g @plugin 'kristijanhusak/tmux-simple-git-status'

Add #{simple_git_status} to your status-left or status-right tmux option:

set -g status-left "#{simple_git_status}"

Hit prefix + I to fetch the plugin and source it.

Manual Installation

Clone the repo:

$ git clone https://github.com/kristijanhusak/tmux-simple-git-status ~/clone/path

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

run-shell ~/clone/path/simple_git_status.tmux

Add #{simple_git_status} to your status-left or status-right tmux option:

set -g status-left "#{simple_git_status}"

Reload TMUX environment:

$ tmux source-file ~/.tmux.conf

FAQ

Q: Status is not updating in real time.

A: Frequency of update depends on tmux status-interval option. To refresh the status every 5 seconds, add set -g status-interval 5 to your .tmux.conf

Q: There is a space before and after the status.

A: Those are added in order to allow easier styling and highlighting (like on screenshot). If you would add an empty space by yourself, you would get empty blocks in your statusline that doesn't hold anything. If you really want it to be removed, please file an issue.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].