arXiv Papers

arXiv Papers retrieves and imports research papers into Obsidian. It queries the arXiv API to download PDFs and save metadata directly into your vault, with a built-in OpenAlex fallback for when arXiv rate-limits your IP (common on VPNs).

https://github.com/user-attachments/assets/12d1b2d4-46f9-416d-b1c7-95e07fae14b3

Usage

Papers has one key function: search for a paper, then create a new note with its metadata. The search query can either be

1. arXiv URL: A direct link to the paper (e.g., https://arxiv.org/abs/1706.03762).
2. Title: The paper title, which is used to fuzzy search arXiv and prompt the user to choose among results.

The resulting note metadata includes paper title, authors, publication year, URL, and an alphaxiv.org conversation link. We can download the PDF and embed it in the note as well.

Upgrading from 1.0.3

1.0.4 adds an {{ALPHAXIV}} template placeholder that renders to https://www.alphaxiv.org/abs/<id> (or empty for non-arXiv URLs). New installs get it by default. If you customised the template in Settings → arXiv Papers → Note template, add this line under url: {{URL}} to enable the link:

alphaxiv: {{ALPHAXIV}}

Install / Build

The plugin isn't in the Obsidian Community catalog yet, so install it manually from source:

git clone https://github.com/Ar4l/obsidian-papers.git
cd obsidian-papers
npm install
npm run build

That produces main.js. Copy three files into your vault's plugin folder:

cp main.js manifest.json styles.css \
   /path/to/your/vault/.obsidian/plugins/arxiv-papers/

Then in Obsidian: Settings → Community plugins, toggle "arXiv Papers" off and on (or reload Obsidian). Your existing data.json (settings) is untouched.

Optional: contact email for the OpenAlex fallback

When arXiv rate-limits your IP (common on VPNs — arXiv throttles per-IP via Fastly, so a shared egress IP can put you in penalty), the plugin falls back to OpenAlex for paper metadata. Setting your email in Settings → arXiv Papers → Contact email routes you through OpenAlex's polite pool with a higher quota.

Run the tests

node tools/test-arxiv.mjs

Exercises the rate limiter, timeout, 429 retry, OpenAlex fallback, polite User-Agent, note-title generation, and title-conflict resolution against live arXiv + OpenAlex. Requires network access.

Credits

Originally written by William Liang.