arXiv-dl

Command-line research paper downloader for papers hosted on arXiv, alphaXiv, Hugging Face, ICLR, 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, alphaXiv, Hugging Face, ICLR, 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

For regular command-line use, install with pipx:

• Prerequisite: Python 3.9 or later

pipx install arxiv-dl

If pipx is not installed:

# Debian/Ubuntu
sudo apt install pipx
pipx ensurepath

# macOS
brew install pipx
pipx ensurepath

[!NOTE] pipx installs command-line tools in isolated environments and exposes their commands on your PATH. This avoids conflicts with operating-system-managed Python installations, including Debian/Ubuntu environments that block global pip install through PEP 668.

To upgrade:

pipx upgrade arxiv-dl

If you prefer pip, install inside a virtual environment:

python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -U arxiv-dl

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 https://arxiv.org/abs/1512.03385 https://alphaxiv.org/abs/2312.16682v2

# Download from ICLR Proceedings
$ paper https://proceedings.iclr.cc/paper_files/paper/2026/hash/0021c2cb1b9b6a71ac478ea52a93b25a-Abstract-Conference.html

Supported Targets

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.