← Downloads

citewright

Headless academic paper renamer. On Mac, Citewrite is the product.

v0.1.1 PyPI dry-run first

Install

PyPI pip install citewright

Related: reference-renamer for simpler filename standardization.

citewright pdf ~/papers
citewright pdf ~/papers --execute

Features

Free APIs first

Crossref, arXiv, Semantic Scholar, PubMed, OpenLibrary, and Unpaywall before anything that costs money.

Identifier extraction

Pull DOIs, arXiv IDs, and ISBNs out of the text when the filename is useless.

Civilized names

Output looks like Author_Year_Title.ext instead of smith_et_al_2008_full.pdf(2).

BibTeX sidekick

Keep a BibTeX database so the rename is not a one-off dead end.

Optional LLM tier

When open APIs miss, you can bring Ollama or a cloud key. Not required for the common path.

Safe by default

Dry run first. Logs everything. Asks before destructive renames.