Mirrors/itch-dl
2
0
Fork 0
mirror of https://github.com/DragoonAethis/itch-dl.git synced 2024-12-21 02:21:52 +01:00
Code Issues Packages Projects Releases Wiki Activity
Download all games from a public Itch.io Game Jam
22 Commits 2 Branches 11 Tags 129 KiB
Python 100%
0.3.0
Go to file
Ryszard Knop 90346f579a Bump to 0.3.0, bump deps, misc cleanups and type corrections 
Some of the misc issues were found with mypy. Not adding it to dev deps
for now as it complains about missing types in libraries and does not
honor noqa where we need it (non-literal TypedDict keys).
2022-06-12 19:31:25 +02:00
.idea Trial The Third: Start rewriting the thing 2022-05-15 02:02:45 +02:00
itch_dl Bump to 0.3.0, bump deps, misc cleanups and type corrections 2022-06-12 19:31:25 +02:00
.gitignore Add PyCharm IDE files 2021-10-13 15:33:17 +02:00
LICENSE Trial The Third: Start rewriting the thing 2022-05-15 02:02:45 +02:00
pyproject.toml Bump to 0.3.0, bump deps, misc cleanups and type corrections 2022-06-12 19:31:25 +02:00
README.md Implement infobox parsing, misc bugfixes, version bump 2022-05-15 20:10:32 +02:00

README.md

itch-dl

Bulk download games from itch.io.

  • Can download game jams, browse pages (popular, newest, browse by tag...) and individual games.
  • Requires Python 3.8+, grab it from PyPI: pip install itch-dl
  • For development, use Poetry.

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.
  • Check out which flags you can toggle: itch-dl --help
  • Run the downloader: itch-dl --api-key <KEY> https://itch.io/jam/yourjamhere
  • Wait. This is going to take a while.

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

The input URL can be any "Browse" page (top, popular, newest, filtered by tags, etc) or any game jam. The input can also be a path to a itch.io JSON file with game jam entries, or just 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!