BATMAN(1) General Commands Manual BATMAN(1)

batman - Read system manual pages (man) using bat as the manual page formatter.

Gone are the days of losing your place while reading through monotone manual pages. With bat and batman, you can read man ifconfig with beautiful 24-bit color and syntax higlighting.

If you have fzf installed, you can even use batman to search through manual pages!


batman [SECTION] [ENTRY]

With bash:

bash
eval "$(batman --export-env)"

With fish:

fish
batman --export-env | source

Variable Description
MANPAGER Changes the pager used for batman. This is treated like BAT_PAGER, but only affects this command.

You can change the syntax highlighting theme for batman by setting the BAT_THEME environment variable before calling batman. The following wrapper function will change the theme to Solarized (dark) without affecting any other bat command.

bash
batman() {
BAT_THEME="Solarized (dark)" batman "$@"
return $?
}

Flags aren't highlighted:

- This happens when you change bat's theme through bat's config file or the BAT_THEME environment variable. Not all themes provide colours for flags, and it's a known issue.
- You can overriding the theme for batman by wrapping it in a function that sets BAT_THEME.
- The following themes support manpage highlighting:
- Monokai Extended / Monokai Extended Light
- Solarized (dark) / Solarized (light)

Thanks to @sharkdp and @LunarLambda for debugging how to make this work properly in certain environments.