paperless-alfred-go is a workflow for searching paperless documents via Alfred and opening them in your browser.
The workflow fully supports the French alphabet, including accents. I suppose (without having tested) that it will support other alphabets just fine.
The trigger keyword is ppl and it expects a document search string.
If no document is found, the only result opens your search in the web UI so you can continue from there.
You can also trigger this on any file with the Cmd modifier.
The latest version is available on the GitHub release page.
After installing this workflow, you'll need to run it a first time. macOS will complain that "ppl-go cannot be verified".
This is expected, as the code of this workflow is written in Go and compiled into a binary. I don't have $99/year to spend on an Apple Developer account just for this project, so you see this popup.
Note
It may be the first time you see this warning. Don't panic, I'm not trying to steal your data. I just don't have $99/yr to spend on this.
See Apple's instructions on how to bypass this protection.
- Download and install Go version >= 1.23
- Clone this repository
make install- this will open Alfred to import the workflow- Configure the workflow in Alfred
Configuration is handled in Alfred's wizard.
Instructions to retrieve your API token are available on the Paperless documentation (3. Token authentication).
I was looking for a paperless search workflow.
I found the nice paperless-alfred by Naam.
Unfortunately, this workflow presented several issues for my use case:
- multi-word queries were broken
- queries with French accents were broken
The workflow was also quite complex, downloading files before opening them locally. It also had no tests.
I needed something simpler, so I wrote my own.
Install from sources:
make clean installRelease:
VERSION=v0.3.0
git tag -a $VERSION -m $VERSION
git push --follow-tags # goreleaser will publish a release