2.0 KiB

Raw Blame History

dfmd

A small utility daemon to handle "open containing folder" activities in various software.

🦊

Quick installation

AUR package: dfmd-git

If some other handler takes precedence over this one, try copying the DBus service file into your user directory. Also make sure no other service is running while executing dfmd.

Bash et al.:

mkdir -p "${XDG_DATA_HOME:-"$HOME/.local/share"}/dbus-1/services"
cp /usr/share/dbus-1/services/sh.natty.FileManager1.service "${XDG_DATA_HOME:-"$HOME/.local/share"}/dbus-1/services/org.freedesktop.FileManager1.service"

Fish:

# Fallback universal variable in case XDG_DATA_HOME is not set
set -U XDG_DATA_HOME ~/.local/share
mkdir -p "$XDG_DATA_HOME/dbus-1/services"
cp /usr/share/dbus-1/services/sh.natty.FileManager1.service "$XDG_DATA_HOME/dbus-1/services/org.freedesktop.FileManager1.service"

Dependencies

DBus
xdg-open as the default handler

Building

cargo build --release

Configuration

Use the DFMD_*_PROGRAM environment variables. %ARGS% is substituted with a list of input files.

Default handler programs

DFMD_FOLDER_PROGRAM="echo %ARGS% | xargs -n1 xdg-open"
DFMD_ITEMS_PROGRAM="echo %ARGS% | xargs -d ' ' -r -n1 dirname | xargs -n1 xdg-open"
DFMD_PROPERTIES_PROGRAM="echo %ARGS% | xargs -n1 xdg-open"

Autostart

Create a DBus service in $XDG_DATA_HOME/dbus-1/services/org.freedesktop.FileManager1.service.

(The default directory for XDG_DATA_HOME is $HOME/.local/share/)

[D-BUS Service]
Name=org.freedesktop.FileManager1
Exec=path/to/dfmd

Overriding defaults in D-Bus service files

Since D-Bus service files do not understand environment variables, the actions can be overridden using env:

(Theoretical example where showing a file sends a desktop notification)

[D-BUS Service]
Name=org.freedesktop.FileManager1
Exec=env DFMD_ITEMS_PROGRAM="echo %ARGS% | xargs -d ' ' -r -n1 dirname | xargs -n1 notify-send 'File opened'" /usr/bin/dfmd

2.0 KiB Raw Blame History