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-dlis trying to support a collection of popular libraries. - performant:
papers-dltries 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)
| File | Size | Uploaded | |
|---|---|---|---|
| papers_dl-0.0.25.tar.gz | 12.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|