81 lines
2.0 KiB
Markdown
81 lines
2.0 KiB
Markdown
# 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.:
|
|
|
|
```sh
|
|
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:
|
|
|
|
```sh
|
|
# 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
|
|
|
|
```sh
|
|
cargo build --release
|
|
```
|
|
|
|
## Configuration
|
|
|
|
Use the DFMD_*_PROGRAM environment variables. `%ARGS%` is substituted with a
|
|
list of input files.
|
|
|
|
### Default handler programs
|
|
|
|
```sh
|
|
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
|
|
```
|