itch-downloader

A command-line tool for downloading and managing your purchased assets from itch.io using the itch.io API.

Features

• 🗜️ Auto-extract: Automatically unzip downloaded files
• 🔍 Filtering: Filter assets by author or title
• ⚡ Parallel downloads: Download multiple assets concurrently

Note: due to itch.io's pretty heavy rate limiting we only download 3 packages at once by default and use pretty heavy sleeping in-between downloading (should still be faster than doing this manually).

Installation

From Releases

Check out the tab https://github.com/BraedonWooding/itch-downloader/releases to find all the release binaries that you can just download immediately.

Just copy that into your path!

From Source

1. Make sure you have Rust installed. If not, install it from rustup.rs
2. Clone this repository:

   git clone <repository-url>
   cd itch-downloader
   

3. Build and install:

   cargo install --path .
   

Usage

Authentication

You need an itch.io API key to use this tool. You can get one from your itch.io account settings.

You can provide the API key in two ways:

1. Command line flag: --api-key YOUR_API_KEY
2. Environment variable: Set ITCH_API_KEY=YOUR_API_KEY

Commands

List Assets (ls)

List all your purchased assets:

# List all assets
itch-downloader ls

# List assets with API key
itch-downloader ls --api-key YOUR_API_KEY

# Filter by author
itch-downloader ls --author "Krishna" --title "Creature"

Download Assets (dl)

Download your purchased assets:

# Download all assets
itch-downloader dl

# Download to specific directory
itch-downloader dl --output ./my-assets

# Download and automatically unzip
itch-downloader dl --unzip

# Download with custom concurrency (default: 16)
itch-downloader dl --max-concurrent 5

# Download specific assets by filter
itch-downloader dl --author "Krishna" --unzip

# Download assets matching title
itch-downloader dl --title "Minifantasy" --output ./minifantasy

Command Options

Global Options

• --api-key, -a: Your itch.io API key (or set ITCH_API_KEY environment variable)

Filtering Options (available for both ls and dl)

• --author: Filter by author username or display name (contains match)
• --title: Filter by game title (contains match)

Download Options (for dl command)

• --output, -o: Output directory for downloads (default: current directory)
• --max-concurrent: Maximum number of concurrent downloads (default: 16)
• --unzip: Automatically extract downloaded ZIP files

Output Format

List Command

The ls command displays assets in a table format:

ID       Author               Title
-------- -------------------- ----------------------------------------
3690241  Krishna Palacio      Minifantasy👤Portrait Generator
3545506  Krishna Palacio      Minifantasy 🐍 Temple Of The Snake...
3626565  Krishna Palacio      Minifantasy🪄Spell Effects II
3507103  Krishna Palacio      Minifantasy 😈 True Villains I
3462664  Krishna Palacio      Minifantasy 📲 UI Overhaul
3379634  Krishna Palacio      Minifantasy 🌀 Warp Lands
3290995  Krishna Palacio      Minifantasy⚔️True Heroes IV

Download Command

The dl command shows:

• Progress for fetching your game library
• Individual progress bars for each download
• Extraction progress when using --unzip
• Summary of completed downloads

File Organization

When using the --unzip option, assets are organized as follows:

output-directory/
├── Game Title 1/
│   ├── extracted files...
├── Game Title 2/
│   ├── extracted files...
└── ...

ZIP files are automatically removed after successful extraction.

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer

This tool is not officially affiliated with itch.io. It uses the public itch.io API to access your purchased assets. Please use responsibly and in accordance with itch.io's terms of service.

This tool was written pretty heavily using AI and while I have verified and written parts of it, it could possibly contain bugs and other issues.