git404hub

what is ref-downloader fr?

ltczding-gif/ref-downloader — explained in plain English

Analysis updated 2026-05-18

74PythonAudience · researcherComplexity · 3/5LicenseSetup · moderate

tl;dr

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.

vibe map

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 make with this?

VIBE 1

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

VIBE 2

Resume an interrupted download run without redownloading already fetched references.

VIBE 3

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

VIBE 4

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

what's the stack?

PythonPlaywrightCrossref APIPyMuPDF

how it stacks up fr

ltczding-gif/ref-downloadersimonw/micropython-wasmsomnusochi/vlm-autoyolo
Stars747474
LanguagePythonPythonPython
Setup difficultymoderateeasyhard
Complexity3/53/54/5
Audienceresearcherdeveloperdeveloper

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

how do i run it?

Difficulty · moderate time til it works · 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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.