#xdg #terminal #config #desktop #portal #filepicker #termfilechooser

app xdg-termfilechooser-bridge

The bridge between xdg-desktop-portal-termfilechooser and your favorite terminal based filepicker

3 unstable releases

Uses new Rust 2024

new 0.2.0 May 5, 2025
0.1.1 May 5, 2025
0.1.0 May 3, 2025

#369 in Filesystem

Download history 54/week @ 2025-04-28

54 downloads per month

GPL-3.0-or-later

24KB
316 lines

xdg-termfilechooser-bridge

The bridge between xdg-desktop-portal-termfilechooser and your favorite terminal based filepicker

Installation

Install the application

via cargo

$ cargo install xdg-termfilechooser-bridge

Setup xdg-desktop-portal-termfilechooser

Edit $XDG_CONFIG_HOME/xdg-desktop-portal-termfilechooser/config

[filechooser]
cmd = /path/to/xdg-termfilechooser-bridge
default_dir = $HOME

Configuration

Edit $XDG_CONFIG_HOME/xdg-termfilechooser-bridge/config.toml

terminal = "ghostty"
filepicker = "yazi"
start_at_last_selected_dir = true

Supported file pickers

If your favorite terminal filepicker isn't available feel free to add it yourself or open an issue with the required invoke parameters.

Supported terminals

If your favorite terminal isn't available feel free to add it yourself or open an issue with the required invoke parameters.

Motivation

The default script of xdg-desktop-portal-termfilechooser has had several issues in the past and beyond these I wanted to customize the behaviour of it further so I wrote a tool to do so.

License

GPLv3

Dependencies

~4–14MB
~192K SLoC