diff options
| author | Danilo M. <danix@danix.xyz> | 2026-09-20 19:23:10 +0200 |
|---|---|---|
| committer | Danilo M. <danix@danix.xyz> | 2026-09-20 19:23:10 +0200 |
| commit | d66c02f386708aef56f7ee2cd73422d2bed04f32 (patch) | |
| tree | 63835b08f615777f471b00442af038e6c279c81e /README.md | |
| parent | b548bf2f89e5d6f23b6ff2c4838e2f31e6010848 (diff) | |
| download | pput-master.tar.gz pput-master.zip | |
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 <noreply@anthropic.com>
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 17 |
1 files changed, 17 insertions, 0 deletions
@@ -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) |