Mirrors/itch-dl
2
0
Fork 0
mirror of https://github.com/DragoonAethis/itch-dl.git synced 2024-12-20 18:11:52 +01:00
Code Issues Packages Projects Releases Wiki Activity
Download all games from a public Itch.io Game Jam
6 Commits 2 Branches 11 Tags 129 KiB
Python 100%
9183c01779
Go to file
Ryszard Knop 9183c01779 Pass credentials for file downloads too 
This didn't actually pull private games - now it works.
2021-10-03 13:33:40 +02:00
.gitignore Initial commit 2021-10-02 01:45:43 +02:00
downloader.py Pass credentials for file downloads too 2021-10-03 13:33:40 +02:00
LICENSE Initial commit 2021-10-02 01:45:43 +02:00
README.md Trial The Second: Make leafo happy by not murdering his servers 2021-10-03 03:51:07 +02:00
requirements.txt Trial The Second: Make leafo happy by not murdering his servers 2021-10-03 03:51:07 +02:00

README.md

Itch Jam Downloader

Downloads all games from a public Itch.io Game Jam.

What you'll need:

  • Python 3.8+
  • pip install -r requirements.txt
  • For site mirroring, wget in your PATH.

On Arch, pacman -S wget python python-requests python-slugify works.

How to use this:

  • 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 ViewJam something something.)
  • Download https://itch.io/jam/NUMBER/entries.json (replacing NUMBER with what you wrote down)
  • Generate a new API key on your user account page: https://itch.io/user/settings/api-keys
  • Run the downloader: python downloader.py --api-key <KEY> entries.json
  • 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.

It's expected that the downloader output will not be complete - logs are stupidly verbose and it prints a report on successful/failed downloads, so you must manually grab whatever was not handled for you automatically for some reason.

The downloader also grabs the entry page HTML, which usually comes with controls and such. It does not download images, external assets and so on, just the text - if the Itch page dies, so will most elements on those downloaded pages. Controls should survive, though.

(There's a pedantic mirroring toggle in the script, if you know what you're doing though.)