tmux-fingers/docs/health-check.md

Health check troubleshooting

tmux-fingers performs a health check on startup to ensure that your system has all dependencies needed to run smoothly.

They are not much, and in most GNU/linux environments these are the defaults anyway.

gawk not found

Install gawk package.

OSX

$ brew install gawk

Linux

• Ubuntu: $ sudo aptitude install gawk
• Arch linux: $ sudo pacman -S install gawk

bash version is too old

This probably means you are running OSX, which ships with bash 3. In order to upgrade to bash 4 you need need to run:

$ brew install bash

tmux version is too old

You can install latest tmux from source, check https://github.com/tmux/tmux

How to skip the check

If can't skip this check by adding the following in your .tmux.conf file:

set -g @fingers-skip-health-check '1'

Wrong $TERM value

Tmux fingers works better with proper 256 support. Set @default-terminal to either screen-256color or xterm-256color.

set -g @default-terminal "screen-256color"