diff --git a/docs/changelog.rst b/docs/changelog.rst index 0e283b7f3..5e0409121 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -9,6 +9,21 @@ To update |kitty|, :doc:`follow the instructions `. Recent major new features --------------------------- +Choose files, fast [0.45] +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +A new :doc:`kitten to select files at the speed of thought +` with a keyboard first interface and support for +content previews of text file with syntax highlighting, images, videos, e-books +and more. Allows you to select files for use at the shell prompt or other +terminal workflows with just a few keystrokes, similar to how fuzzy finders +like `fzf `__ operate, but with designed for +files in particular. + +On Linux it can even be used as a :doc:`drop in replacement ` +for the File Open/Save dialog boxes in GUI replacements. + + Sessions [0.43] ~~~~~~~~~~~~~~~~ @@ -137,7 +152,7 @@ Detailed list of changes 0.45.0 [future] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- A new :doc:`kitten to select files at the speed of light ` with a keyboard firs tinterface and support for content previews of text file with syntax highlighting, images, videos, e-books and more (:iss:`9263`) +- A new :doc:`kitten to select files at the speed of thought ` with a keyboard first interface and support for content previews of text file with syntax highlighting, images, videos, e-books and more (:iss:`9263`) - Add support for the `paste events protocol `__ (:iss:`9183`) diff --git a/docs/kittens/choose-files.rst b/docs/kittens/choose-files.rst index f3c566314..e4c45a850 100644 --- a/docs/kittens/choose-files.rst +++ b/docs/kittens/choose-files.rst @@ -8,6 +8,14 @@ Selecting files, fast .. versionadded:: 0.45.0 +.. only:: not man + + .. figure:: /screenshots/choose-files.webp + :alt: The choose files kitten, showing metadata and title from an e-book file + :align: center + :width: 100% + + The choose-files kitten is designed to allow you to select files, very fast, with just a few key strokes. It operates like `fzf `__ and similar fuzzy finders, except that diff --git a/docs/kittens_intro.rst b/docs/kittens_intro.rst index 2b21646f7..daa908116 100644 --- a/docs/kittens_intro.rst +++ b/docs/kittens_intro.rst @@ -14,6 +14,7 @@ Extend with kittens kittens/choose-fonts kittens/hints kittens/quick-access-terminal + kittens/choose-files kittens/panel kittens/remote_file kittens/hyperlinked_grep @@ -63,6 +64,10 @@ Some prominent kittens: terminal programs. +:doc:`Choose files ` + Preview and select files at the speed of thought + + :doc:`Remote file ` Edit, open, or download remote files over SSH easily, by simply clicking on the filename. diff --git a/docs/screenshots/choose-files.webp b/docs/screenshots/choose-files.webp new file mode 100644 index 000000000..31e42a34a Binary files /dev/null and b/docs/screenshots/choose-files.webp differ