kitty - kitty Documentation
kitty [options] [program-to-run ...]
Run the kitty terminal emulator. You can also specify the program to run inside kitty as normal arguments following the options. For example: kitty /bin/sh
For comprehensive documentation for kitty, please see: https://sw.kovidgoyal.net/kitty
- --class <CLS>
- Set the class part of the WM_CLASS window property Default: kitty
- --name <NAME>
- Set the name part of the WM_CLASS property (defaults to using the value from kitty --class)
- --title <TITLE>, -T <TITLE>
- Set the window title. This will override any title set by the program running inside kitty. So only use this if you are running a program that does not set titles.
- --config <CONFIG>, -c <CONFIG>
- Specify a path to the configuration file(s) to use. All configuration
files are merged onto the builtin kitty.conf, 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
NONE to not load a config file.
If this option is not specified, config files are searched for in the order: $XDG_CONFIG_HOME/kitty/kitty.conf, ~/.config/kitty/kitty.conf, $XDG_CONFIG_DIRS/kitty/kitty.conf. The first one that exists is used as the config file.
If the environment variable KITTY_CONFIG_DIRECTORY is specified, that directory is always used and the above searching does not happen.
If /etc/xdg/kitty/kitty.conf 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.
- --override <OVERRIDE>, -o <OVERRIDE>
- Override individual configuration options, can be specified multiple times. Syntax: name=value. For example: kitty -o font_size=20
- --directory <DIRECTORY>, -d <DIRECTORY>
- Change to the specified directory when launching Default: .
- Detach from the controlling terminal, if any
- --session <SESSION>
- Path to a file containing the startup session (tabs, windows, layout, programs). See the README file for details and an example.
- Remain open after child process exits. Note that this only affects the first window. You can quit by either using the close window shortcut or Ctrl+d.
- --single-instance, -1
- If specified only a single instance of kitty will run. New invocations will instead create a new top-level window in the existing kitty instance. This allows kitty to share a single sprite cache on the GPU and also reduces startup time. You can also have separate groups of kitty instances by using the kitty --instance-group option
- --instance-group <INSTANCE_GROUP>
- Used in combination with the kitty --single-instance option. All kitty invocations with the same kitty --instance-group will result in new windows being created in the first kitty instance within that group
- Normally, when using --single-instance, kitty will open a new window in an existing instance and quit immediately. With this option, it will not quit till the newly opened window is closed. Note that if no previous instance is found, then kitty will wait anyway, regardless of this option.
- --listen-on <LISTEN_ON>
- Tell kitty to listen on the specified address for control messages. For example, kitty --listen-on=unix:/tmp/mykitty or kitty --listen-on=tcp:localhost:12345. On Linux systems, you can also use abstract UNIX sockets, not associated with a file, like this: kitty --listen-on=unix:@mykitty. To control kitty, you can send it commands with kitty @ using the kitty @ --to option to specify this address. Note that this option will be ignored, unless you set allow_remote_control to yes in kitty.conf.
- --version, -v
- The current kitty version
- Output commands received from child process to stdout
- --replay-commands <REPLAY_COMMANDS>
- Replay previously dumped commands. Specify the path to a dump file previously created by --dump-commands. You can open a new kitty window to replay the commands with:
kitty sh -c "kitty --replay-commands /path/to/dump/file; read"
- --dump-bytes <DUMP_BYTES>
- Path to file in which to store the raw bytes received from the child process
- Debug OpenGL commands. This will cause all OpenGL calls to check for errors instead of ignoring them. Useful when debugging rendering problems
- This option will cause kitty to print out key events as they are received
- Print out information about the selection of fallback fonts for characters not present in the main font.
- Print out information about the system and kitty configuration.
2018, Kovid Goyal
|July 4, 2018||0.11.2|