Paperboy is a small .pdf management utility.
I was frustrated that most PDFs have pretty useless file names.
This tool helps renaming those files without too much fuss. It will rename/move documents to a specified folder, and it even gives some filename suggestions by looking at the file content and the pdf metadata.
Paperboy aims to keep its file management dumb (no keeping files in a database or hidden library folder), so you can uninstall it at any time and your files will remain perfectly accessible.
- Open a new file import dialog with Space or Enter.
- Switch between the library and the inbox with Tab.
- Open a file from the library with Enter or Space.
- Quit the application with Esc or Ctrl + c.
Make sure you have poppler installed, which will provide both pdftotext and pdfinfo. If you are using homebrew on Mac you can do brew install poppler. On Linux, install poppler with your package manager of choice.
For now you need stack to compile Paperboy (cabal probably works too):
git clone git@github.com/2mol/pboy.git
cd pboy
stack install
This will give you an executable named pboy in your local bin folder.
For nix users:
git clone github.com/2mol/pboy
cd pboy
nix-env -f . -i pboy
Paperboy creates a .pboy.toml in your home directory. Use this to change your library and incoming folders, as well as to specify whether you want to move the imported files or just copy them.
Consider this to be beta quality right now. Nothing in this tool will break your computer, but there is not a lot of exception handling for missing folders or missing utility programs.
For large files, pdftotext can take quite a long time to parse the document, which is stupid because we're only using the first couple of lines for file name suggestions.
Feel free to open issues, fix the Readme or send pull requests against the spec file https://github.com/2mol/pboy/blob/master/SPEC.md. You're generally very welcome to share any opinions, documentation improvements, fixes, refactoring suggestions etc.
See the abovementioned document to get an idea of what some of the next priotities are, especially the section Next actionable.
The name for this tool is inspired by this atrocity, which I had for the NES and never quite mastered.