From d66c02f386708aef56f7ee2cd73422d2bed04f32 Mon Sep 17 00:00:00 2001 From: "Danilo M." Date: Sun, 20 Sep 2026 19:23:10 +0200 Subject: feat: add file-manager right-click action for PDFs pput.desktop is a DES-EMA action exposing "Upload to Paperless" on the context menu for application/pdf, using %F so a whole selection uploads in one click, not just a single file. It runs pput-gui rather than pput directly: a click has no terminal, so the wrapper reports the outcome through notify-send, falling back to zenity. It also sets PINENTRY_USER_DATA, since pass(1) needs a GUI pinentry when there is no controlling terminal. Exec= calls pput-gui by name rather than by absolute path, matching the other actions in this format and keeping a user's home out of the file. Co-Authored-By: Claude Opus 5 --- README.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index 5ada7b2..cc45e7d 100644 --- a/README.md +++ b/README.md @@ -32,6 +32,23 @@ pput scan.pdf && rm scan.pdf Paperless rejects re-uploads of identical content, reported as `duplicate of doc N`. +## File manager integration + +`pput.desktop` adds an "Upload to Paperless" entry to the right-click menu for +PDFs, for file managers that read the DES-EMA actions format (pcmanfm-qt, +Caja, Nemo). It runs `pput-gui`, a wrapper that reports the result as a +desktop notification, since a click has no terminal to print to. One file or a +whole selection both work. + +```bash +ln -s "$PWD/pput-gui" ~/bin/pput-gui +ln -s "$PWD/pput.desktop" ~/.local/share/file-manager/actions/pput.desktop +``` + +`Exec=` calls `pput-gui` by name, so it must be on the `PATH` your desktop +session exports; use an absolute path there instead if it is not. Restart the +file manager to pick up a new action. + ## Requirements - `bash`, `curl`, `python3` (stdlib only) -- cgit v1.2.3