Skip to main content

itch.io bulk game downloader

Project description

itch-dl

PyPI

Bulk download games from itch.io

[!WARNING] This tool does not let you download paid games for free. To download paid games, you must have them attached in your library.

How to use

  • Log into itch.io with the account you'd like to use for downloading.
  • Generate a new API key on your user account page.
  • Optional: Save the API key in the itch-dl configuration file.
  • Run the downloader: itch-dl https://itch.io/jam/yourjamhere (add --api-key <KEY> if you did not save the API key).
  • Wait. This is going to take a while.

More arguments are available - check them out with itch-dl --help.

The downloader is able to grab more or less everything you can download via the itch app.

The input URL can be one of the supported link formats listed above, a path to a itch.io JSON file with game jam entries, a list of itch.io game URLs (not browse/jam pages!) to download.

It's expected that the downloader output will not be complete - logs are stupidly verbose and it prints a report on failed downloads and external URLs (links to files that are not on itch.io itself, but rather on an external host like Google Drive, Dropbox, etc), so you must manually grab whatever was not handled for you automatically.

The downloader also grabs the entry page HTML, which usually comes with controls and such. By default, it does not download images, assets and so on, just the text - use --mirror-web to try and download these as well. This does not work very well yet, but gets the basics done.

Game Jam Entries JSON

Downloader can parse and download games from a game jam entries JSON file if you need it. (The script basically automates the steps below, so if it's not able to do the same, please create an issue!)

  • Go to your jam's page, ex. https://itch.io/jam/gbcompo21 and right-click -> View Source.
  • Ctrl-F for "id": - it should find that text once, followed by a number. Write it down.
  • (It you found it multiple times, grab the one after I.ViewJam something something.)
  • Download https://itch.io/jam/ID/entries.json (replacing ID with what you wrote down).
  • Feed that to itch-dl!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

itch_dl-0.4.3.tar.gz (16.3 kB view details)

Uploaded Source

Built Distribution

itch_dl-0.4.3-py3-none-any.whl (18.4 kB view details)

Uploaded Python 3

File details

Details for the file itch_dl-0.4.3.tar.gz.

File metadata

  • Download URL: itch_dl-0.4.3.tar.gz
  • Upload date:
  • Size: 16.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.12.7 Linux/6.11.6-zen1-1-zen

File hashes

Hashes for itch_dl-0.4.3.tar.gz
Algorithm Hash digest
SHA256 40952ffce6903a54b9243ad1a5233a8f30a6e844cc9ed7830af6f83b1a4362dc
MD5 aeb426b8ae6f14ab75efc4726ce3dd1e
BLAKE2b-256 4a24664930b3419734412e56a3935a471bf293bc24fe47ef847974260e4f556a

See more details on using hashes here.

File details

Details for the file itch_dl-0.4.3-py3-none-any.whl.

File metadata

  • Download URL: itch_dl-0.4.3-py3-none-any.whl
  • Upload date:
  • Size: 18.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.12.7 Linux/6.11.6-zen1-1-zen

File hashes

Hashes for itch_dl-0.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 9f618d111242a0c13dc1af89bfa227baecac91bef3c19109a31c2839f75528dc
MD5 82571d3a2be73642f50f1060e2aed515
BLAKE2b-256 0ceb6750eb98ca7fcb46ee74cc792e40479d2e35a1d0f9b7a26b085069c12f84

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page