Update choose files docs

This commit is contained in:
Kovid Goyal
2025-12-24 09:17:24 +05:30
parent 44efa30679
commit df32684afd
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 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] Sessions [0.43]
~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~
@@ -137,7 +152,7 @@ Detailed list of changes
0.45.0 [future] 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`) - 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 .. 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, The choose-files kitten is designed to allow you to select files, very fast,
with just a few key strokes. It operates like `fzf with just a few key strokes. It operates like `fzf
<https://github.com/junegunn/fzf/>`__ and similar fuzzy finders, except that <https://github.com/junegunn/fzf/>`__ and similar fuzzy finders, except that

View File

@@ -14,6 +14,7 @@ Extend with kittens
kittens/choose-fonts kittens/choose-fonts
kittens/hints kittens/hints
kittens/quick-access-terminal kittens/quick-access-terminal
kittens/choose-files
kittens/panel kittens/panel
kittens/remote_file kittens/remote_file
kittens/hyperlinked_grep kittens/hyperlinked_grep
@@ -63,6 +64,10 @@ Some prominent kittens:
terminal programs. terminal programs.
:doc:`Choose files <kittens/choose-files>`
Preview and select files at the speed of thought
:doc:`Remote file <kittens/remote_file>` :doc:`Remote file <kittens/remote_file>`
Edit, open, or download remote files over SSH easily, by simply clicking on Edit, open, or download remote files over SSH easily, by simply clicking on
the filename. the filename.

Binary file not shown.

After

Width:  |  Height:  |  Size: 94 KiB