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

Configuration

By default the tool will try to determine your terminal and filepicker automatically by checking if you have one of the supported ones installed, if you want to use a specific one please edit $XDG_CONFIG_HOME/xdg-termfilechooser-bridge/config.toml

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

Supported file pickers

• yazi

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

• alacritty
• foot
• ghostty
• kitty
• xterm

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