Skip to main content

Overview

papers-dl is a command line application for downloading scientific papers.

Usage

# parse DOI identifiers from a file:
papers-dl parse -m doi --path pages/my-paper.html

# parse ISBN identifiers from a file, output matches as CSV:
papers-dl parse -m isbn --path pages/my-paper.html -f csv

# fetch paper with given identifier from any known provider:
papers-dl fetch "10.1016/j.cub.2019.11.030"

# fetch paper from any known Sci-Hub URL with verbose logging on, and store in "papers" directory:
papers-dl -v fetch -p "scihub" -o "papers" "10.1107/s0907444905036693"

# fetch paper from specific Sci-Hub URL:
papers-dl fetch -p "sci-hub.ee" "10.1107/s0907444905036693"

# fetch paper from SciDB (Anna's Archive):
papers-dl fetch -p "scidb" "10.1107/s0907444905036693"

About

papers-dl attempts to be a comprehensive tool for gathering research papers from popular open libraries. There are other solutions for this (see "Other tools" below), but papers-dl is trying to fill its own niche:

  • comprehensive: other tools usually work with a single library, while papers-dl is trying to support a collection of popular libraries.
  • performant: papers-dl tries to improve search and retrieval times by making use of concurrency where possible.

That said, papers-dl may not be the best choice for your specific use case right now. For example, if you require features supported by a specific library, one of the more mature and specialized tools listed below may be a better option.

papers-dl was initially created to serve as an extractor for ArchiveBox, a powerful solution for self-hosted web archiving.

This project started as a fork of scihub.py.

Other tools

Roadmap

papers-dl's CLI is not yet stable.

Short-term roadmap:

parsing

  • add support for parsing more identifier types like PMID and ISSN

fetching

  • add support for downloading formats other than PDFs, like HTML or epub

searching

  • add a CLI command for searching libraries for papers and metadata

Metadata

Release files for papers-dl 0.0.25

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for papers-dl 0.0.25
File Size Uploaded
papers_dl-0.0.25.tar.gz 12.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for papers-dl 0.0.25
File Interpreter ABI Platform
papers_dl-0.0.25-py3-none-any.whl Python 3 none any Details

Total release size: 25.1 kB

Release files / papers_dl-0.0.25.tar.gz

Download URL papers_dl-0.0.25.tar.gz
Size 12.6 kB
Tags Source
SHA-256 checksum
How to use checksums
3d1399d3bd487594214a774164df3d612da81cb977e056e2a99ea50db6190b78
BLAKE2b-256 checksum
How to use checksums
dd8ab8a913e4f23bf9481f40a9dc9d44610754d278271e73cff7ac039c6f0634
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release files / papers_dl-0.0.25-py3-none-any.whl

Download URL papers_dl-0.0.25-py3-none-any.whl
Size 12.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4aff4ba556c4525f631b9d0ff8800a44c31bdf2f0339debfbb619b0b1d5a1850
BLAKE2b-256 checksum
How to use checksums
b36d815c8b5ca33782f5ef91ea4e95e961c219abdb71b6ec3f64b85e8027ef27
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release history Release notifications | RSS feed

This release

0.0.25 This release

2 release files

0.0.24

2 release files

0.0.22

2 release files

0.0.21

2 release files

0.0.20

2 release files

0.0.13

2 release files

0.0.12

2 release files

0.0.11

2 release files

0.0.9

2 release files

0.0.8

2 release files

0.0.7

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page