kitten-choose-files(1) kitty kitten-choose-files(1) (NAME) kitten-choose-files - Kitty (OVERVIEW) 0.45.0. choose-files . fzf % (fuzzy finders) . . ( ) (GUI) . desktop-ui %<> . : kitten choose-files . Enter . Tab . Shift+Tab . ctrl+shift+p>c %<#shortcut-kitty.Insert-chosen-file> ctrl+shift+p>d %<# shortcut-kitty.Insert-chosen-directory> . : some-command $(kitten choose-file) / tty . : . ffmpeg % calibre % . / (Creating shortcuts to favorite/frequently used directories) choose-files.conf . : map ctrl+t cd /tmp map alt+p cd ~/my/project (Selecting multiple files) --mode=files . Enter Shift+Enter . Ctrl . Alt ( Shift+click ). Enter . . Shift+Enter . (Hidden and ignored files) ( ) . . .gitignore .ignore . . .gitignore .git . .gitignore . choose-files.conf . ( ) (Selecting non-existent files (save file names)) << >> --mode=save-file. ( Tab) Ctrl+Enter . Alt+Enter . (Selecting directories) << >> --mode=dir. Ctrl+Enter . Enter . (Selecting files or directories) --mode=all . Enter . Tab Ctrl+Enter . (Editing the search text) / Emacs Ctrl+A/Ctrl+E / Ctrl+Left/Ctrl+Right Ctrl+K/Ctrl+U / Ctrl+W/Alt+D / . Home End Ctrl+Home Ctrl+End . ( ) choose-files.conf : +---------------------------+-----------------------------+ | (Action) | | | | | | | | +---------------------------+-----------------------------+ |edit_cursor_left | | | | | | | | | | | +---------------------------+-----------------------------+ |edit_cursor_right | | | | | | | | | | | | | | +---------------------------+-----------------------------+ |edit_start_of_line | | | | | | | | | | | +---------------------------+-----------------------------+ |edit_end_of_line | | | | | | | | | | | +---------------------------+-----------------------------+ |edit_start_of_document | | | | edit_start_of_line | | | | | | | | | | | | | | | | | | | +---------------------------+-----------------------------+ |edit_end_of_document | | | | edit_end_of_line | | | | | | | | | | | | | | | | | | | +---------------------------+-----------------------------+ |edit_forward_word | | | | | | | | | | | | | | +---------------------------+-----------------------------+ |edit_backward_word | | | | | | | | | | | | | | +---------------------------+-----------------------------+ |edit_backspace | | | | | | | | +---------------------------+-----------------------------+ |edit_delete | | | | | | | | +---------------------------+-----------------------------+ |edit_kill_to_start_of_line | | | | | | | | | | | | | | +---------------------------+-----------------------------+ |edit_kill_to_end_of_line | | | | | | | | | | | | | | +---------------------------+-----------------------------+ |edit_kill_word_left | | | | | | | | +---------------------------+-----------------------------+ |edit_kill_word_right | | | | | | | | +---------------------------+-----------------------------+ |edit_yank | | | | | | | | +---------------------------+-----------------------------+ Home End : map left edit_cursor_left map right edit_cursor_right map home edit_start_of_line map end edit_end_of_line map ctrl+home edit_start_of_document map ctrl+end edit_end_of_document Up Down . Backspace Delete Ctrl+K Ctrl+W . (CONFIGURATION) choose-files.conf kitty %<#confloc> . . (Filesystem scanning) show_hidden show_hidden last . last . (toggle). sort_by_last_modified sort_by_last_modified last . . . last . . respect_ignores respect_ignores last gitignore. ignore. ignore. last . . ignore . .gitignore ( man gitignore ). (Anchored) . . . (Appearance) show_preview show_preview last / . last . . pygments_style pygments_style default pygments (syntax highlighting) . pygments % . dark_pygments_style . dark_pygments_style dark_pygments_style github-dark pygments . pygments % . pygments_style . cache_size cache_size 0.5 () . . syntax_aliases syntax_aliases pyj:py pyi:py recipe:py . file.xyz file.abc xyz:abc . . video_preview video_preview width=480 fps=10 duration=5 . width . duration . --clear-cache . previewer . : pattern program arguments... pattern MIME . : name:*.doc .doc . mime:image/* . program PATH . . . . . JSON STDOUT : { "lines": ["line1", "line2", "..."], "image": "absolute path to generated image preview", "title_extra": "some text to show on the first line", } SGR . JPEG PNG GIF WEBP APNG . (Keyboard shortcuts) (Quit) map esc quit map ctrl+c quit (Accept current result) map enter accept (Select current result) map shift+enter select . Ctrl . Alt . (Type file name) map ctrl+enter typename / . . . ( ) . (Modify file name) map alt+enter modifyname . . ( ) . (Next result) map down next 1 (Previous result) map up next -1 (Left result) map left next left (Right result) map right next right (First result on screen) map home next first_on_screen map ctrl+home next first (Last result on screen) map end next last_on_screen map ctrl+end next last (Change to currently selected dir) map tab cd . (Change to parent directory) map shift+tab cd .. (Change to root directory) map ctrl+/ cd / (Change to home directory) map ctrl+~ cd ~ map ctrl+` cd ~ map ctrl+shift+` cd ~ (Change to temp directory) map --allow-fallback=shifted,ascii ctrl+t cd /tmp (Next filter) map --allow-fallback=shifted,ascii ctrl+f 1 (Previous filter) map --allow-fallback=shifted,ascii alt+f -1 (Toggle showing dotfiles) map --allow-fallback=shifted,ascii alt+h toggle dotfiles (Toggle showing ignored files) map --allow-fallback=shifted,ascii alt+i toggle ignorefiles (Toggle sorting by dates) map --allow-fallback=shifted,ascii alt+d toggle sort_by_dates (Toggle showing preview) map --allow-fallback=shifted,ascii alt+p toggle preview choose_files (Source code for choose_files) % . (Command line interface) kitten choose_files [] [ ] . Enter . Tab . %<> . (OPTIONS) --mode () : file : all, dir, dirs, file, files, save-dir, save-file, save-files --file-filter . MIME glob . . type:expression:Descriptive Name . : mime:image/png:Images mime:image/gif:Images glob:*.[tT][xX][Tt]:Text files. glob . MIME glob mime:text/* . . glob:*:All . . --suggested-save-file-name . --suggested-save-file-path . --title <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>. --display-title [=no] <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>. --override <OVERRIDE>, -o <OVERRIDE> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?><?>: name=value. --config <CONFIG> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>(<?><?><?>) <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> choose-files.conf <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?> <?><?><?><?><?> <?><?><?><?> NONE <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>: $XDG_CONFIG_HOME/kitty/choose-files.conf<?> ~/.config/kitty/choose-files.conf<?> $XDG_CONFIG_DIRS/kitty/choose-files.conf. <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?><?> KITTY_CONFIG_DIRECTORY %<#envvar-KITTY_CONFIG_DIRECTORY> <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>. <?><?><?> /etc/xdg/kitty/choose-files.conf <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> (<?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>) <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>. <?><?><?><?><?><?><?><?><?> <?><?> - <?><?> /dev/stdin <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> STDIN <?><?><?><?><?><?><?> <?><?><?><?>. --write-output-to <WRITE_OUTPUT_TO> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> STDOUT <?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>. --output-format <OUTPUT_FORMAT> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> text <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?> <?><?> <?><?> <?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> shell <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> shell-relative <?><?><?><?><?> shell <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> (mapping)<?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?> text <?><?> shell <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>. <?><?><?><?><?><?><?>: text <?><?><?><?><?><?><?><?><?>: json, shell, shell-relative, text --write-pid-to <WRITE_PID_TO> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> (PID) <?><?><?> <?><?><?><?><?><?> <?><?> <?><?>. --clear-cache [=no] <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> (<?><?>) <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?> (AUTHOR) Kovid Goyal <?><?> <?><?><?> (COPYRIGHT) 2026, Kovid Goyal 0.48.2 July 30, 2026 kitten-choose-files(1)