usage.txt

Usage: kitty-control [-adefhuv] [back <color>] [-c command] [dark]
                     [diff [opts] <path1> <path2>] [font [num]] [fore <color>]
                     [-i /path/to/image] [icat [opts] <image>] [-k] [layout <name>]
                     [load [subdir|file]] [ls|list [self|colors|tabs|windows]] [-m|t <match>]
                     [man] [menu] [fetch] [-o doc] [-s /path/to/socket] [term] [theme] [tools]
                     [title <title>] [transparent [opacity]] [unicode] [upgrade] [-v]
Where:
    'back color' Sets the background color to 'color'
           If 'color' is 'reset' restores foreground and background to startup value
    'dark' Sets the Kitty background opacity to 1.0 (fully opaque)
           Can use 'dark' or 'opaque'
    'diff [opts] <file1|dir1> <file2|dir2>' Displays differences using the 'diff' kitten
           Enclose [opts] and <file1/dir1> in quotes if [opts] are provided
           See https://sw.kovidgoyal.net/kitty/kittens/diff/#options
    'fetch' Displays system information with fastfetch/neofetch
    'font num' Sets the font pointsize to 'num'
           Can use 'font', 'fontsize', 'fontminus', or 'fontplus'
           The second argument specifies the font size, either absolute, +, or -
           e.g. 'kitty-control fontsize 24' would set the font size to 24 points
                'kitty-control font +2' would increase the font size by 2 points
                'kitty-control font' without argument resets the font size to default
    'fore color' Sets the foreground color to 'color'
           If 'color' is 'reset' restores foreground and background to startup value
    'icat [opts] <image>' Displays <image> using the Kitty 'icat' kitten
           Enclose [opts] and <image> in quotes if [opts] are provided
           To remove all images currently displayed on the screen:
               kitty-control icat --clear
           See https://sw.kovidgoyal.net/kitty/kittens/icat/#options
    'list|ls [self|colors|tabs|windows]' Displays info on Kitty tabs/windows/colors
        'list' displays full info, 'ls' abbreviated info
        'self' Indicates display info for this Kitty window
        'colors' Indicates display the names of the supported Kitty colors
        'tabs|windows' Indicates display info on Kitty tabs or windows
    'layout <name>'
        Sets the Kitty window layout to '<name>' where '<name>' can be one of:
          Previous Fat Grid Horizontal Splits Stack Tall Vertical
    'load [subdir|file]' Reloads the Kitty configuration in ~/.config/kitty/kitty.conf
           Can use 'load' or 'reload'
           Specify a second argument to load ~/.config/kitty/<subdir>/kitty.conf
           e.g. 'kitty-control load tv' would load ~/.config/kitty/tv/kitty.conf
           This argument can also be the path to a Kitty configuration file to load
           'kitty-control load default' loads the ~/.config/kitty/kitty.conf config
           'kitty-control load --help' displays a help message for the load command
    'man' Displays the kitty-control manual
    'menu' Displays the kitty-control interactive menu system
    'size w h' Increases/decreases the window size 'w' and 'h' cells
           The 'w' argument specifies the window width adjustment in cells
           The 'h' argument specifies the window height adjustment in cells
           'kitty-control size 4 3' increases the window width by 4 cells and height by 3 cells
    'term' Displays information about the terminal using the query_terminal kitten
    'theme' Displays the interactive theme selection kitten
    'title <tab title>' Sets the Kitty tab title to "tab title"
          Quote tab titles which contain spaces, e.g. "This Is My Tab Title"
          Use '-m <match>' to specify the tab to match
    'tools' Installs 'figlet' 'jq' 'lolcat' 'fastfetch' and 'ranger' if not already present
    'tran [opacity]' Sets the Kitty background opacity to 0.8
           Can use 'tran', 'opacity', 'trans' or 'transparent'
           Specify a second argument to set a custom background opacity:
           e.g. 'kitty-control transparent 0.9'
    'unicode' Displays the Unicode input kitten
    'upgrade' Upgrades Kitty, Fastfetch, Fzf, and kitty-control if needed
    '-a' Indicates modify all windows rather than just the currently active OS window
    '-c command' specifies a Kitty command to run (enclose command and arguments in quotes)
        Can be used to run arbitrary commands, e.g. 'kitty-control -c get-colors'
    '-d' Debug mode - display commands when executed
    '-e' Displays several example invocations and exits
    '-f' Indicates toggle fullscreen
    '-h' Displays a full usage message and exits
    '-i /path/to/image' sets the background image for the specified Kitty windows
        If /path/to/image is 'none' then any existing image will be removed
    '-k' Indicates skip version checks and upgrade menu options
    '-m <match>' Specifies the window to match
    '-t <match>' Specifies the tab to match
        Window/Tab matching can be used in conjunction with most kitty-control commands
        If <match> is '--help' the Kitty documentation URL for matching will be displayed
    '-o doc' Opens the specified Kitty documentation in a browser
        'doc' can be one of:
            'conf' 'faq' 'remote' 'diff' 'icat' 'layout' 'ssh' 'themes' 'unicode' or 'man'
    '-s /path/to/socket' Specifies the socket Kitty is listening on if enabled
        If /path/to/socket is '--help' some help on configuring a Kitty socket is provided
        '-s /path/...' can be used to send commands to Kitty from another terminal
    '-u' Displays a brief usage message and exits
    '-v' Displays the kitty-control, fastfetch, fzf, and kitty versions then exits

Without any arguments 'kitty-control' displays an interactive menu system
Adjusting the background opacity or font size requires the original kitty.conf
that was used for this instance of Kitty to have enabled the following:
    'dynamic_background_opacity yes' and 'allow_remote_control yes'
See https://sw.kovidgoyal.net/kitty/remote-control/#control-kitty-from-scripts