arxiv-dl 1.3.0

Command-line Papers Downloader. Citation extraction and PDF naming automation.

arXiv-dl

Command-line research paper downloader for papers hosted on arXiv, NeurIPS, CVF Open Access (CVPR, ICCV, WACV), and ECVA (ECCV).

Disclaimer: This is an opinionated command-line tool for downloading papers. It prioritizes ease of use for researchers and is not an official arXiv project.

What does it do?

• Downloads papers from arXiv, NeurIPS, CVPR, ICCV, WACV, and ECCV with a simple CLI.
• Speeds up downloads with aria2 when available.
• Retrieves paper metadata:
  • Title, abstract, and year
  • Authors
  • Comments and conference acceptance info
  • Repository URLs when available
  • BibTeX citation
• Maintains a list of local papers and their metadata in a JSON file.
• Lets you configure the download destination with an environment variable or command-line option.
• Saves downloaded papers with standardized filenames.

Why?

• Save time downloading and organizing papers.
• Use multiple parallel connections for faster downloads.
• Keep a local paper list for lookup, notes, and citations.

Installation

Install with pip:

• Prerequisite: Python 3.9 or later

python3 -m pip install -U arxiv-dl

[!NOTE] After installation, make sure the Python script installation directory is on your PATH. If the paper command is not found, see this PATH setup note or the Python Packaging guide for installing stand-alone command-line tools.

Optionally, install aria2c for multi-connection downloads.

• macOS: brew install aria2
• Linux: sudo snap install aria2c

Usage

After installation, use paper in your shell to download papers. The legacy commands arxiv-dl and getpaper are equivalent to paper.

paper [OPTIONS] TARGET(s)

Shell examples

# Download a single target
$ paper 1512.03385

# Download multiple targets
$ paper 2103.15538 2304.04415 https://arxiv.org/abs/1512.03385

Supported Targets

Click to expand

✅ Supported, 🚧 Not Yet Supported, ❌ Not Supported

• ArXiv
  • ✅ ArXiv ID: 1512.03385 or arXiv:1512.03385
  • ✅ Legacy ArXiv ID: alg-geom/9708001 or cs/0002001, etc.
  • ✅ ArXiv Abstract Page URL: https://arxiv.org/abs/1512.03385
  • ✅ ArXiv PDF Page URL: https://arxiv.org/pdf/1512.03385.pdf
  • ✅ ArXiv HTML Page URL: https://arxiv.org/html/2506.15442
• CVF Open Access (CVPR, ICCV, WACV)
  • ✅ CVF Abstract Page URL: https://openaccess.thecvf.com/content/**/html/**/*.html
  • ✅ CVF PDF Page URL: https://openaccess.thecvf.com/content/**/papers/**/*.pdf
• ECVA (ECCV)
  • ✅ ECVA Abstract Page URL: https://www.ecva.net/html/**/*.php
  • ❌ ECVA PDF Page URL: https://www.ecva.net/papers/**/*.pdf
• NeurIPS / NIPS
  • ✅ NeurIPS Abstract Page URL: https://proceedings.neurips.cc/paper_files/paper/**/hash/**/*.html
  • ✅ NeurIPS PDF Page URL: https://proceedings.neurips.cc/paper_files/paper/**/file/**/*.pdf
  • ✅ NIPS mirror Abstract Page URL: https://papers.nips.cc/paper_files/paper/**/hash/**/*.html
  • ✅ NIPS mirror PDF Page URL: https://papers.nips.cc/paper_files/paper/**/file/**/*.pdf
• OpenReview
  • 🚧 TODO

Common Options

• -v, --verbose: Print full details.
• -d, --download-dir: Set the download directory for this run. This overrides both the default path and ARXIV_DOWNLOAD_FOLDER.
• -n, --n-threads: Set the number of parallel download connections used by aria2.

[!TIP] Run paper -h to see all options.

Python API

from arxiv_dl import download_paper

download_paper(target="1512.03385", download_dir=".", set_verbose_level="silent")

Configuration

Default Download Destination

• By default, papers are downloaded to $HOME/Downloads/ArXiv_Papers.

Custom Download Destination

Set ARXIV_DOWNLOAD_FOLDER to choose a persistent download destination. Add this to your .bashrc or .zshrc:

export ARXIV_DOWNLOAD_FOLDER="YOUR/PATH/TO/ANY/FOLDER"

• Download destination priority:
  1. Command-line option -d (highest priority)
  2. Environment variable ARXIV_DOWNLOAD_FOLDER
  3. Default download destination (lowest priority)

Custom Command Alias

• You can define aliases to rename the command or add default options:

  alias dp="paper"
  alias dpv="paper -v -d '~/Documents/Papers'"
  

Contributing

Development, testing, build, and publishing notes are in DEVELOPMENT.md.

License

This project is licensed under the MIT License.
© Mark H. Huang. All rights reserved.