Update choose files docs

This commit is contained in:
Kovid Goyal 2025-12-24 09:17:24 +05:30
parent 44efa30679
commit df32684afd
No known key found for this signature in database
GPG key ID: 06BC317B515ACE7C
4 changed files with 29 additions and 1 deletions

View file

@ -9,6 +9,21 @@ To update |kitty|, :doc:`follow the instructions <binary>`.
Recent major new features
---------------------------
Choose files, fast [0.45]
~~~~~~~~~~~~~~~~~~~~~~~~~~~
A new :doc:`kitten to select files at the speed of thought
</kittens/choose-files>` 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 <https://github.com/junegunn/fzf/>`__ operate, but with designed for
files in particular.
On Linux it can even be used as a :doc:`drop in replacement </kittens/desktop-ui>`
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 </kittens/choose-files>` 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 </kittens/choose-files>` 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 <https://rockorager.dev/misc/bracketed-paste-mime/>`__ (:iss:`9183`)

View file

@ -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
<https://github.com/junegunn/fzf/>`__ and similar fuzzy finders, except that

View file

@ -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 <kittens/choose-files>`
Preview and select files at the speed of thought
:doc:`Remote file <kittens/remote_file>`
Edit, open, or download remote files over SSH easily, by simply clicking on
the filename.

Binary file not shown.

After

Width:  |  Height:  |  Size: 94 KiB