explaingit

ltczding-gif/ref-downloader

Analysis updated 2026-05-18

74PythonAudience · researcherComplexity · 3/5LicenseSetup · moderate

TLDR

ref-downloader takes a paper's DOI or PDF and automatically downloads every reference it cites as a PDF, using your own institutional login through Microsoft Edge.

Mindmap

mindmap
  root((ref-downloader))
    What it does
      Takes DOI or PDF input
      Fetches refs via Crossref
      Downloads reference PDFs
      Per-ref status report
    Tech stack
      Python
      Playwright
      Microsoft Edge
      PyMuPDF
    Key traits
      Uses your own login
      Not a paywall bypass
      Resumable runs
      Agent skill install
    Audience
      Academic researchers
      Literature reviewers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Batch download every reference PDF cited in a paper during a literature review.

USE CASE 2

Resume an interrupted download run without redownloading already fetched references.

USE CASE 3

Install it as a skill so an AI coding agent like Claude Code can fetch references on request.

USE CASE 4

Get a per-reference status report showing which downloads succeeded, need manual follow-up, or failed.

What is it built with?

PythonPlaywrightCrossref APIPyMuPDF

How does it compare?

ltczding-gif/ref-downloaderwasasquatch/comfyui_viewer_openreel_extensionhumanmllm/swim
Stars747475
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity3/54/55/5
Audienceresearcherdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Currently verified only on Windows with Microsoft Edge, requires closing all Edge windows so the tool can use your browser profile.

MIT license, free to use, modify, and distribute including for commercial purposes.

In plain English

ref-downloader solves a very specific pain for academic researchers: when you read a paper and want to download all of its cited references as PDFs, doing so by hand means clicking through dozens of publisher websites one at a time, often hitting login walls. This tool automates that whole process. You give it a DOI, a unique identifier for an academic paper, or a PDF file, and it automatically fetches the reference list through Crossref, a scholarly metadata service, then attempts to download each referenced paper as a PDF. What makes it different from generic scrapers is that it drives your actual Microsoft Edge browser session. If your university already has a subscription to a journal, your login credentials stored in Edge carry through automatically, so papers you legitimately have access to can be downloaded without any extra setup. It is explicit that this is not a paywall bypass, references your institution does not subscribe to become manual_pending for you to chase by hand. It handles 17 or more publisher specific download paths, because each publisher such as Wiley, Elsevier, or AIP structures their download pages differently. After each run, it produces a report showing which papers downloaded successfully, which ones hit a paywall your institution does not cover, and which ones failed due to a technical issue. The tool also remembers progress per project, so rerunning it after a crash or dropped connection skips already downloaded references and retries only the failures. You would use this during a literature review when you need to read all the papers cited in a key publication. It runs on Python 3.11 or newer, currently only verified on Windows with Microsoft Edge, and it can also be installed as a skill for AI coding agents like Claude Code or Codex CLI.

Copy-paste prompts

Prompt 1
Set up ref-downloader as a Claude Code skill and configure config.local.toml with my Crossref mailto address.
Prompt 2
Run ref-downloader against this DOI and explain what a manual_pending status in the download report means.
Prompt 3
Walk me through installing Playwright's Edge browser so ref-downloader can use my institutional login session.
Prompt 4
How does ref-downloader decide which of the 17+ publisher-specific download paths to use for a given reference?

Frequently asked questions

What is ref-downloader?

ref-downloader takes a paper's DOI or PDF and automatically downloads every reference it cites as a PDF, using your own institutional login through Microsoft Edge.

What language is ref-downloader written in?

Mainly Python. The stack also includes Python, Playwright, Crossref API.

What license does ref-downloader use?

MIT license, free to use, modify, and distribute including for commercial purposes.

How hard is ref-downloader to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ref-downloader for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.