dfmd/README.md

54 lines
1.3 KiB
Markdown
Raw Normal View History

2024-02-03 16:03:43 +00:00
# dfmd
A small utility daemon to handle "open containing folder" activities in various
software.
🦊
2024-02-03 16:45:32 +00:00
## 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`.
`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"`
2024-02-03 16:03:43 +00:00
## 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 " " -I {} sh -c 'p="{}"; echo "${p%/*}"' | 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
```