.. program:: kitty +kitten hints


.. highlight:: sh
.. code-block:: sh

  kitty +kitten hints [options] 

Select text from the screen using the keyboard. Defaults to searching for URLs.

Options
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. option:: --program <PROGRAM>

    What program to use to open matched text. Defaults to the default open program for the operating system.  Use a value of :file:`-` to paste the match into the terminal window instead. A value of :file:`@` will copy the match to the clipboard.
    Default: :code:`default`

.. option:: --type <TYPE>

    The type of text to search for.
    Default: :code:`url`
    Choices: :code:`hash, line, path, regex, url, word`

.. option:: --regex <REGEX>

    The regular expression to use when :option:`kitty +kitten hints --type`:code:`=regex`. If you specify a group in the regular expression only the group will be matched. This allow you to match text ignoring a prefix/suffix, as needed. The default expression matches lines.
    Default: :code:`(?m)^\s*(.+)\s*$`

.. option:: --url-prefixes <URL_PREFIXES>

    Comma separated list of recognized URL prefixes.
    Default: :code:`file,ftp,http,https`

.. option:: --word-characters <WORD_CHARACTERS>

    Characters to consider as part of a word. In addition, all characters marked as alpha-numeric in the unicode database will be considered as word characters. Defaults to the select_by_word_characters setting from kitty.conf.

.. option:: --minimum-match-length <MINIMUM_MATCH_LENGTH>

    The minimum number of characters to consider a match.
    Default: :code:`3`

.. option:: --multiple

    Select multiple matches and perform the action on all of them together at the end. In this mode, press :kbd:`Esc` to finish selecting.

