PaperNym
FreeOpen source · for researchers

Stop renaming papers by hand.

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.

Windows 10 & 11 Ubuntu & Debian macOS (via pip)
5scholarly sources checked
15name formats, or your own
0files uploaded, ever
1 clickto undo any rename
Features

Set it up once. Every paper after that names itself.

A small tray app that does one job carefully: give every paper a name you can sort, search and cite from.

Hands-off

Lives in the tray and renames new PDFs as soon as they land in Downloads or your papers folder.

Verified, not guessed

Every match from Crossref, doi.org, OpenAlex, Semantic Scholar or arXiv is checked against the PDF's own text. No confident match, no rename.

Undo anything

Every rename is recorded. Undo the last one, a whole batch, or any single file from History.

Your format, your rules

15 ready-made styles, from 2025_Smith_Title to Zotero-style and citekeys, or a template of your own.

Works offline

No connection? Papers are named from the PDF alone, marked _CHECK, and corrected once you are back online.

Your names win

Rename a file by hand and PaperNym never touches it again. Files are only renamed in place: never moved, edited or deleted.

Preview first

Dry runs show old → new with checkboxes, so you see every name before anything changes.

Tray app and command line

One install gives you both, sharing the same settings and history. Script it, or never open a terminal.

Pleasant to live with

Light and dark themes, keyboard friendly, batched notifications, and Start at login.

How it works

Careful by design: a wrong name is worse than no name.

PaperNym tries the most reliable evidence first and stops at the first answer it can verify.

DOI

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.

arXiv ID

Preprints are identified from the text or the file name and looked up in arXiv and Semantic Scholar.

Title search

Accepted only if the title matches closely and the first author's surname is printed on page one. You can turn this off.

Left alone

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.

Terminal — a real dry run on 12 downloaded papers
$ 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
Name formats

One paper. Fifteen ways to name it.

Pick the style your field (or your supervisor) likes. Change it any time, and rename earlier papers to match with one command.

Preview

Smith, Jones & Lee (2025), “Deep learning for crash severity prediction models”, Accid Anal Prev

In the app: Settings → Naming, with the same live preview. On the command line: papernym set-format, then papernym reformat to update earlier renames.

Safety & privacy

Your papers stay on your computer.

No account, no analytics, no telemetry. PaperNym only ever renames, and it tells you exactly what leaves your machine.

Safe with your files

Built so that nothing can be lost.

  • Files are only renamed in place: never moved, overwritten, edited or deleted.
  • Every rename is recorded in History before it counts, and can be undone.
  • A name you give a file by hand is respected from then on.
  • Downloads in progress are waited for; locked files are retried later.
  • The tray app and the command line never rename at the same time.

What leaves your computer

Only identifiers needed for a lookup.

SentWhen
DOIs and arXiv IDs found in your PDFsEvery lookup, to the scholarly services
Paper titlesOnly while “Search by title” is on
Your emailOnly if you set one, as Crossref's polite-pool contact
Version numberOnce a day to GitHub to check for updates; can be turned off

File contents and file names are never sent.

Download

Free for everyone. Install in a minute.

Open source under the MIT licence. Latest version: 0.1.4 · what's new

  1. Download the installer.
  2. Run it. If Windows shows “Windows protected your PC”, click More info → Run anyway. The installer is not code-signed yet.
  3. PaperNym appears in the tray, and a short setup asks which folders to watch.

Windows 10 or 11, 64-bit. Installs for your user only, no administrator rights needed. Includes the papernym command line.

FAQ

Questions

Is it really free?

Yes. PaperNym is open source under the MIT licence, with no account, no subscription and no ads.

Does it upload my PDFs?

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.

What if it gets a name wrong?

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.

Does it work with Zotero, Mendeley or my reference manager?

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.

Which papers does it recognise?

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.

Can I rename papers I already have?

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.

Does it work offline?

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.

Your next download names itself.

Install PaperNym, choose your folders, and get back to reading.