NAME

       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/

OPTIONS

       --class <CLS>
              Set the class part of the WM_CLASS window property. On Wayland, it sets the app id.
              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. If combined with kitty --session the title will be  used  for  all  windows
              created by the session, that do not set their own 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
              Detach from the controlling terminal, if any

       --session <SESSION>
              Path  to  a  file containing the startup session (tabs, windows, layout, programs).
              Use - to read from STDIN. See the README file for details and an example.

       --hold 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

       --wait-for-single-instance-window-close
              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. This
              option will be ignored, unless you set allow_remote_control to yes  in  kitty.conf.
              Note that if you run kitty @ within a kitty window, there is no need to specify the
              --to option as it is read automatically from the environment.

       --start-as <START_AS>
              Control how  the  initial  kitty  window  is  created.   Default:  normal  Choices:
              fullscreen, maximized, minimized, normal

   Debugging options
       --version, -v
              The current kitty version

       --dump-commands
              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-gl
              Debug OpenGL commands. This will cause all OpenGL calls to check for errors instead
              of ignoring them. Useful when debugging rendering problems

       --debug-keyboard
              This option will cause kitty to print out key events as they are received

       --debug-font-fallback
              Print out information about the selection of  fallback  fonts  for  characters  not
              present in the main font.

       --debug-config
              Print out information about the system and kitty configuration.

AUTHOR

       Kovid Goyal

COPYRIGHT

       2022, Kovid Goyal