.\" Man page generated from reStructuredText. . . .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 .. .TH "kitten-quick-access-terminal" 1 "May 11, 2025" "0.42.0" "kitty" .SH Name kitten-quick-access-terminal \- A quick access terminal window that you can bring up instantly with a keypress or a command. .SH Overview .sp Added in version 0.42.0: See \fI\%here for what platforms it works on\fP\&. .sp This kitten can be used to make a quick access terminal, that appears and disappears at a key press. To do so use the following command: .INDENT 0.0 .INDENT 3.5 .sp .EX kitten quick\-access\-terminal .EE .UNINDENT .UNINDENT .sp Run this command in a terminal, and a quick access kitty window will show up at the top of your screen. Run it again, and the window will be hidden. .sp To make the terminal appear and disappear at a key press: .sp In Linux, simply assign the above command to a global shortcut in your window manager. In macOS, go to System Preferences\->Keyboard\->Keyboard Shortcuts\->Services\->General and set a shortcut for the Quick access to kitty entry. .SH Configuration .sp You can configure the appearance and behavior of the quick access window by creating a \fBquick\-access\-terminal.conf\fP file in your \fI\%kitty config folder\fP\&. In particular, you can use the \fI\%kitty_conf\fP option to change various kitty settings, just for the quick access window. .sp \fBNOTE:\fP .INDENT 0.0 .INDENT 3.5 This kitten uses the \fI\%panel kitten\fP under the hood. You can use the \fI\%techniques described there\fP for remote controlling the quick access window, remember to add \fBkitty_override allow_remote_control=socket\-only\fP and \fBkitty_override listen_on=unix:/tmp/whatever\fP to \fBquick\-access\-terminal.conf\fP\&. .UNINDENT .UNINDENT .sp See below for the supported configuration directives: .SH Window appearance .INDENT 0.0 .TP .B lines .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX lines 25 .EE .UNINDENT .UNINDENT .sp The number of lines shown in the window, when the window is along the top or bottom edges of the screen. If it has the suffix \fBpx\fP then it sets the height of the window in pixels instead of lines. .INDENT 0.0 .TP .B columns .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX columns 80 .EE .UNINDENT .UNINDENT .sp The number of columns shown in the window, when the window is along the left or right edges of the screen. If it has the suffix \fBpx\fP then it sets the width of the window in pixels instead of columns. .INDENT 0.0 .TP .B edge .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX edge top .EE .UNINDENT .UNINDENT .sp Which edge of the screen to place the window along .INDENT 0.0 .TP .B background_opacity .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX background_opacity 0.85 .EE .UNINDENT .UNINDENT .sp The background opacity of the window. This works the same as the kitty option of the same name, it is present here as it has a different default value for the quick access terminal. .INDENT 0.0 .TP .B hide_on_focus_loss .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX hide_on_focus_loss no .EE .UNINDENT .UNINDENT .sp Hide the window when it loses keyboard focus automatically. Using this option will force \fI\%focus_policy\fP to \fBon\-demand\fP\&. .INDENT 0.0 .TP .B margin_left .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX margin_left 0 .EE .UNINDENT .UNINDENT .sp Set the left margin for the window, in pixels. Has no effect for windows on the right edge of the screen. .INDENT 0.0 .TP .B margin_right .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX margin_right 0 .EE .UNINDENT .UNINDENT .sp Set the right margin for the window, in pixels. Has no effect for windows on the left edge of the screen. .INDENT 0.0 .TP .B margin_top .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX margin_top 0 .EE .UNINDENT .UNINDENT .sp Set the top margin for the window, in pixels. Has no effect for windows on the bottom edge of the screen. .INDENT 0.0 .TP .B margin_bottom .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX margin_bottom 0 .EE .UNINDENT .UNINDENT .sp Set the bottom margin for the window, in pixels. Has no effect for windows on the top edge of the screen. .INDENT 0.0 .TP .B kitty_conf .UNINDENT .sp Path to config file to use for kitty when drawing the window. Can be specified multiple times. By default, the normal kitty.conf is used. Relative paths are resolved with respect to the kitty config directory. .INDENT 0.0 .TP .B kitty_override .UNINDENT .sp Override individual kitty configuration options, can be specified multiple times. Syntax: name=value\&. For example: \fBfont_size=20\fP\&. .INDENT 0.0 .TP .B app_id .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX app_id kitty\-quick\-access .EE .UNINDENT .UNINDENT .sp The Wayland APP_ID assigned to the quick access window (Linux only) .INDENT 0.0 .TP .B start_as_hidden .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX start_as_hidden no .EE .UNINDENT .UNINDENT .sp Whether to start the quick access terminal hidden. Useful if you are starting it as part of system startup. .INDENT 0.0 .TP .B focus_policy .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX focus_policy exclusive .EE .UNINDENT .UNINDENT .sp How to manage window focus. A value of \fBexclusive\fP means prevent other windows from getting focus. However, whether this works is entirely dependent on the compositor/desktop environment. It does not have any effect on macOS and KDE, for example. Note that on sway using \fBon\-demand\fP means the compositor will not focus the window when it appears until you click on it, which is why the default is set to \fBexclusive\fP\&. .SH Source code for quick_access_terminal .sp The source code for this kitten is \X'tty: link https://github.com/kovidgoyal/kitty/tree/master/kittens/quick_access_terminal'\fI\%available on GitHub\fP\X'tty: link'\&. .SH Command line interface .INDENT 0.0 .INDENT 3.5 .sp .EX kitten quick_access_terminal [options] [cmdline\-to\-run ...] .EE .UNINDENT .UNINDENT .sp A quick access terminal window that you can bring up instantly with a keypress or a command. .SS Options .INDENT 0.0 .TP .B \-\-config , \-c Specify a path to the configuration file(s) to use. All configuration files are merged onto the builtin \fBquick\-access\-terminal.conf\fP, overriding the builtin values. This option can be specified multiple times to read multiple configuration files in sequence, which are merged. Use the special value \fBNONE\fP to not load any config file. .sp If this option is not specified, config files are searched for in the order: \fB$XDG_CONFIG_HOME/kitty/quick\-access\-terminal.conf\fP, \fB~/.config/kitty/quick\-access\-terminal.conf\fP, \fB$XDG_CONFIG_DIRS/kitty/quick\-access\-terminal.conf\fP\&. The first one that exists is used as the config file. .sp If the environment variable \fI\%KITTY_CONFIG_DIRECTORY\fP is specified, that directory is always used and the above searching does not happen. .sp If \fB/etc/xdg/kitty/quick\-access\-terminal.conf\fP exists, it is merged before (i.e. with lower priority) than any user config files. It can be used to specify system\-wide defaults for all users. You can use either \fB\-\fP or \fB/dev/stdin\fP to read the config from STDIN. .UNINDENT .INDENT 0.0 .TP .B \-\-override , \-o Override individual configuration options, can be specified multiple times. Syntax: name=value\&. For example: \-o lines=12 .UNINDENT .INDENT 0.0 .TP .B \-\-detach [=no] Detach from the controlling terminal, if any, running in an independent child process, the parent process exits immediately. .UNINDENT .INDENT 0.0 .TP .B \-\-detached\-log Path to a log file to store STDOUT/STDERR when using \fI\%\-\-detach\fP .UNINDENT .INDENT 0.0 .TP .B \-\-instance\-group The unique name of this quick access terminal Use a different name if you want multiple such terminals. Default: \fBquick\-access\fP .UNINDENT .INDENT 0.0 .TP .B \-\-debug\-rendering [=no] For debugging interactions with the compositor/window manager. .UNINDENT .SH Sample quick-access-terminal.conf .sp You can download a sample \fBquick\-access\-terminal.conf\fP file with all default settings and comments describing each setting by clicking: \fBsample quick\-access\-terminal.conf\fP\&. .SH Author Kovid Goyal .SH Copyright 2025, Kovid Goyal .\" Generated by docutils manpage writer. .