.\" Man page generated from reStructuredText.
.
.TH "FISH_KEY_READER" "1" "Apr 29, 2020" "3.1" "fish-shell"
.SH NAME
fish_key_reader \- explore what characters keyboard keys send
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
fish_key_reader [OPTIONS]
.ft P
.fi
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
\fBfish_key_reader\fP is used to study input received from the terminal and can help with key binds. The program is interactive and works on standard input. Individual characters themselves and their hexadecimal values are displayed.
.sp
The tool will write an example \fBbind\fP command matching the character sequence captured to stdout. If the character sequence matches a special key name (see \fBbind \-\-key\-names\fP),  both \fBbind CHARS ...\fP and \fBbind \-k KEYNAME ...\fP usage will be shown. Additional details about the characters received, such as the delay between chars, are written to stderr.
.sp
The following options are available:
.INDENT 0.0
.IP \(bu 2
\fB\-c\fP or \fB\-\-continuous\fP begins a session where multiple key sequences can be inspected. By default the program exits after capturing a single key sequence.
.IP \(bu 2
\fB\-d\fP or \fB\-\-debug=CATEGORY_GLOB\fP enables debug output and specifies a glob for matching debug categories (like \fBfish \-d\fP). Defaults to empty.
.IP \(bu 2
\fB\-D\fP or \fB\-\-debug\-stack\-frames=DEBUG_LEVEL\fP specify how many stack frames to display when debug messages are written. The default is zero. A value of 3 or 4 is usually sufficient to gain insight into how a given debug call was reached but you can specify a value up to 128.
.IP \(bu 2
\fB\-h\fP or \fB\-\-help\fP prints usage information.
.IP \(bu 2
\fB\-v\fP or \fB\-\-version\fP prints fish_key_reader\(aqs version and exits.
.UNINDENT
.SH USAGE NOTES
.sp
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 \fBfish_escape_delay_ms\fP setting or learn the amount of lag introduced by tools like \fBssh\fP, \fBmosh\fP or \fBtmux\fP\&.
.sp
\fBfish_key_reader\fP intentionally disables handling of many signals. To terminate \fBfish_key_reader\fP in \fB\-\-continuous\fP mode do:
.INDENT 0.0
.IP \(bu 2
press \fBCtrl\-C\fP twice, or
.IP \(bu 2
press \fBCtrl\-D\fP twice, or
.IP \(bu 2
type \fBexit\fP, or
.IP \(bu 2
type \fBquit\fP
.UNINDENT
.SH COPYRIGHT
2019, fish-shell developers
.\" Generated by docutils manpage writer.
.