Quickly rename downloaded PDF files based on metadata and content with Paperboy (console)

Newsboy Is a small, simple command line PDF management utility written in Haskell, designed to help download PDF documents without correct / recognizable file names. The tool uses PDF metadata and content to provide suggestions for quickly renaming files, while also allowing you to open the PDF to check its contents before renaming. It works on Linux and macOS.

Paperboy can rename PDF files from the Downloads folder based on metadata and content and use the interactive command line user interface to move them to the folder you set. This is especially useful for files that have a large number of PDF documents in the Downloads folder, whose names do not contain any meaning, such as “3325_56545.pdf”, names that include only some PDF titles, and so on.
To add, with Paperboy, the renaming is still done manually (you have to choose a name from Paperboy suggestions), because the purpose of the command line tool is very simple, only for one purpose, without a database or database. Background observation.
The Paperboy Terminal User Interface (TUI) contains 2 screens: the inbox, which displays all PDF documents in the inbox by default. Downloads Catalog and library screens (~/papers By default), it shows PDFs (imported and renamed PDF documents) in the library folder. Use to switch between these two screens Tab You might also like: How to edit PDF metadata tags using GUI or command line on Linux

Quickly rename downloaded PDF files based on metadata and content with Paperboy (console)
Paperboy import dialog with new file name suggestions

To import a PDF and rename it using the suggestions provided by Paperboy, select a PDF from the Inbox screen and press Enter Either Space (Either r), View and select one of the Paperboy file name suggestions, then press Enter key. In the import screen, you can also press Ctrl-o Open the current file using the default PDF viewer and check its contents before renaming.
You can see all Paperboy keyboard shortcuts by pressing the button below h:Newsboy help

The inbox and library folders and some other settings are configurable. When running Paperboy for the first time, it will ask if you want to create a profile in ~/.config/pboy/pboy.ini -Select to create this profile, then you can edit this file to make changes:

  • Inbox folder, the folder where Paperboy checks for new PDF documents to import (default is Downloads; It can be a path relative to your home directory, such as “Download”, or the full path to a folder)
  • Library folder, this is where Paperboy places it after renaming imported PDF documents (~/papers by default)
  • Choose whether to move the imported PDF document or leave the original document intact (set to true by default)
  • Word separator; this is used to separate words in the filename of the PDF document (default is _)

You might also be interested in: rga: search for text in PDFs, eBooks, Office documents, archives, etc. (ripgrep packaging)

Download and install Paperboy

On Linux, download the pboy linux.tar.gz file, unzip it, and install the unzipped file. pboy From your binary to the directory $PATH. For example, install it in /usr/local/bin Use (run this command from the folder where you unzipped the files pboy Binary):

sudo install pboy /usr/local/bin