fish_key_reader - Man Page

explore what characters keyboard keys send


fish_key_reader [OPTIONS]


fish_key_reader is used to explain how you would bind a certain key sequence. By default, it prints the bind command for one key sequence read interactively over standard input.

If the character sequence matches a special key name (see bind --key-names),  both bind CHARS ... and bind -k KEYNAME ... usage will be shown. In verbose mode (enabled by passing --verbose), additional details about the characters received, such as the delay between chars, are written to stderr.

The following options are available:

Usage Notes

In verbose mode, the delay in milliseconds since the previous character was received is included in the diagnostic information written to stderr. This information may be useful to determine the optimal fish_escape_delay_ms setting or learn the amount of lag introduced by tools like ssh, mosh or tmux.

fish_key_reader intentionally disables handling of many signals. To terminate fish_key_reader in --continuous mode do:


> fish_key_reader
Press a key:
# press up-arrow
bind \e\[A 'do something'

> fish_key_reader --verbose
Press a key:
# press alt+enter
           hex:   1B  char: \c[  (or \e)
(  0.027 ms)  hex:    D  char: \cM  (or \r)
bind \e\r 'do something'


Dec 29, 2021 3.3 fish-shell