Skip to content

Tmux plugin that enables displaying process indicators in the tmux status line.

License

Notifications You must be signed in to change notification settings

alexanderjeurissen/tmux-process-indicator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 

Repository files navigation

tmux-process-indicator

Tmux plugin that enables displaying process indicators whenever a process is running.

Introduces a new #{process_indicators} format.

This plugin is useful if:

  • You run cronjobs or scheduled background processes that you want to monitor.
  • You want to keep track if essential processes are still running

Tested and working on OSX, but should also work on Linux and Cygwin.

Usage

  1. Add #{process_indicators} format string to your existing status-right tmux option.

The template / text that is shown in the statusbar is configurable. It defaults to #[bold] PROCESS_NAME #[nobold]. The template needs to be specified per process. To specify a template set the appropriate global option in your tmux configuration in the format of: @PROCESS_NAME_process_template. You can use the constant PROCESS_NAME if you want to print out the process name in the status line.

Example configuration for showing if mbsync is running:

set -g @monitor_process 'mbsync'
set -g @mbsync_process_template '#[bold] PROCESS_NAME is running #[nobold]'

set-option -g status-right "#[bg=blue, fg=black] #{process_indicators} "

In this case we set the option @mbsync_process_template to set the template solely used to denote if mbsync is running.

There is no limit on the number of processes that can be included this way (except from screen real estate ;) )

Installation with Tmux Plugin Manager (recommended)

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

set -g @plugin 'alexanderjeurissen/tmux-process-indicator'

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

#{process_indicators} interpolation should now work.

Manual Installation

Clone the repo:

$ git clone https://github.com/alexanderjeurissen/tmux-process-indicator ~/clone/path

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

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

Reload TMUX environment:

# type this in terminal
$ tmux source-file ~/.tmux.conf

#{process_indicators} interpolation should now work.

About

Tmux plugin that enables displaying process indicators in the tmux status line.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published

Languages