diff --git a/docs/changelog.rst b/docs/changelog.rst index 42aa729b5..51fe857a1 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -8,7 +8,7 @@ To update |kitty|, :doc:`follow the instructions `. ---------------------- - A new :doc:`themes kitten ` to easily change kitty themes. - Choose from over two hundred themes in the `kitty themes repository + Choose from almost two hundred themes in the `kitty themes repository `_ - A new style for the tab bar that makes tabs looks like the tabs in a physical diff --git a/docs/kittens/themes.rst b/docs/kittens/themes.rst index b040d3895..0e51bbf98 100644 --- a/docs/kittens/themes.rst +++ b/docs/kittens/themes.rst @@ -2,7 +2,7 @@ Changing kitty colors ======================== The themes kitten allows you to easily change color themes, from a collection -of over two hundred pre-built themes available at `kitty-themes +of almost two hundred pre-built themes available at `kitty-themes `_. To use it, simply run:: kitty +kitten themes @@ -16,6 +16,9 @@ The kitten maintains a list of recently used themes to allow quick switching. If you want to restore the colors to default, you can do so by choosing the ``Default`` theme. +.. versionadded:: 0.23.0 + The themes kitten + How it works ---------------- @@ -48,4 +51,16 @@ asking to add your contributions to the repository. Use the file :download:`template.conf ` as a template when creating your theme. + +Changing the theme non-interactively +--------------------------------------- + +You can specify the theme name as an argument when invoking the kitten +to have it change to that theme instantly. For example:: + + kitty +kitten theme --reload-in=all Dimmed Monokai + +Will change the theme to ``Dimmed Monokai`` in all running kitty +instances. See below for more details on non-interactive operation. + .. include:: ../generated/cli-kitten-themes.rst