Hands-off
Lives in the tray and renames new PDFs as soon as they land in Downloads or your papers folder.
PaperNym watches your Downloads and names every research paper PDF from its real publication metadata, the moment it lands. No more main (2).pdf: just year, author and title, ready to sort, search and cite.
Say it PAY-per-nim.
A small tray app that does one job carefully: give every paper a name you can sort, search and cite from.
Lives in the tray and renames new PDFs as soon as they land in Downloads or your papers folder.
Every match from Crossref, doi.org, OpenAlex, Semantic Scholar or arXiv is checked against the PDF's own text. No confident match, no rename.
Every rename is recorded. Undo the last one, a whole batch, or any single file from History.
15 ready-made styles, from 2025_Smith_Title to Zotero-style and citekeys, or a template of your own.
No connection? Papers are named from the PDF alone, marked _CHECK, and corrected once you are back online.
Rename a file by hand and PaperNym never touches it again. Files are only renamed in place: never moved, edited or deleted.
Dry runs show old → new with checkboxes, so you see every name before anything changes.
One install gives you both, sharing the same settings and history. Script it, or never open a terminal.
Light and dark themes, keyboard friendly, batched notifications, and Start at login.
PaperNym tries the most reliable evidence first and stops at the first answer it can verify.
DOIs from the PDF's properties and text are looked up in Crossref, doi.org, OpenAlex and Semantic Scholar. A DOI that belongs to a cited reference is rejected.
Preprints are identified from the text or the file name and looked up in arXiv and Semantic Scholar.
Accepted only if the title matches closely and the first author's surname is printed on page one. You can turn this off.
Nothing verified? The file is not touched. It waits under Needs attention, where you can paste the DOI yourself.
Invoices, slides and forms are recognised and skipped. Files still downloading are waited for, files open in another program are retried later, and each paper is looked up once, then cached.
$ papernym scan ~/Downloads --dry-run
[preview] dry run: nothing will be renamed
Scanning 12 PDFs...
[preview] 1-s2.0-S0001457517300842-main.pdf -> 2019_Imprialou_Crash_data_quality_for_road_safety_research_Current_state_and_future_directions.pdf
[preview] 1-s2.0-S0957417426008080-main-2 (2).pdf -> 2026_Bermudez_Supervised_clustering_using_SOM_for_severity-based_pattern_detection_in_urban_traffic_crashes.pdf
[preview] 97770f42-85cc-4285-b189-98a823efa6b1.pdf -> 2024_Gao_Uncertainty-aware_probabilistic_graph_neural_networks_for_road-level_traffic_crash_prediction.pdf
[preview] s41598-026-74874-w_reference.pdf -> 2026_Islam_Multidimensional_analysis_of_e-scooter_crash_severity_using_cluster_correspondence_and_explainable_AI.pdf
… 8 more
Summary: 12 PDFs, 12 would be renamed
$ papernym scan ~/Downloads # do it for real
$ papernym undo # changed your mind? the whole batch goes back
Pick the style your field (or your supervisor) likes. Change it any time, and rename earlier papers to match with one command.
In the app: Settings → Naming, with the same live preview. On the command line: papernym set-format, then papernym reformat to update earlier renames.
No account, no analytics, no telemetry. PaperNym only ever renames, and it tells you exactly what leaves your machine.
Built so that nothing can be lost.
Only identifiers needed for a lookup.
| Sent | When |
|---|---|
| DOIs and arXiv IDs found in your PDFs | Every lookup, to the scholarly services |
| Paper titles | Only while “Search by title” is on |
| Your email | Only if you set one, as Crossref's polite-pool contact |
| Version number | Once a day to GitHub to check for updates; can be turned off |
File contents and file names are never sent.
Open source under the MIT licence. Latest version: 0.1.4 · what's new
Windows 10 or 11, 64-bit. Installs for your user only, no administrator rights needed. Includes the papernym command line.
apt also installs the few system libraries it needs:
sudo apt install ./papernym_*_amd64.debpapernym.Ubuntu 22.04 or newer, Debian 12 or newer (64-bit). No Python needed. On stock GNOME without a tray, PaperNym keeps its window open instead.
python3 --version in Terminal). If not, get it from python.org.python3 -m pip install "papernym[gui]"papernym-guiIf pip reports externally-managed-environment (Homebrew Python), use brew install pipx and pipx install "papernym[gui]" instead.
New macOS support passes the automated tests but has not yet been tried on a real Mac. Tell us how it goes.
pip install "papernym[gui]"pip install papernympipx install "papernym[gui]"Python 3.10 or newer. Start the tray app with papernym-gui; the command line is papernym. On PyPI.
Yes. PaperNym is open source under the MIT licence, with no account, no subscription and no ads.
No. Only the DOI or arXiv ID found in a PDF (and, if you allow it, the paper title) is sent to look up the metadata. File contents and file names never leave your computer.
It is built to rather skip a file than guess: every result is checked against the PDF's own text. If a name is still not what you want, undo it from History or rename the file yourself, and PaperNym will leave it alone from then on.
PaperNym only renames files in the folders you choose, so it works alongside any reference manager. Point it at your Downloads, not at a folder your reference manager manages itself. There is a Zotero-style name format if you like that look.
Anything with a DOI or an arXiv ID, which covers most journal articles, conference papers and preprints. Papers without either can be found by title search. Invoices, slides and other non-papers are skipped.
Yes. Run a dry run on any folder to preview the names (papernym scan FOLDER --dry-run, or Preview in the app), then apply it. Changing the format later renames earlier papers to match.
Yes. Without a connection, papers are named from the PDF alone and marked _CHECK; they are corrected automatically once the services can be reached again.
Install PaperNym, choose your folders, and get back to reading.