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
a552bb2393
itch-dl/README.md

34 lines
1.5 KiB
Markdown
Raw Normal View History

Trial The First: Maybe It Works This Time
2021-10-02 03:05:29 +02:00
# 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`
Trial The Second: Make leafo happy by not murdering his servers Drop Selenium and clicking around itch - use the API instead. Pulls HTML5 games, is way faster, uses less resources on both ends.
2021-10-03 03:49:49 +02:00
- For site mirroring, [wget](https://www.gnu.org/software/wget/) in your PATH.
Trial The First: Maybe It Works This Time
2021-10-02 03:05:29 +02:00
Trial The Second: Make leafo happy by not murdering his servers Drop Selenium and clicking around itch - use the API instead. Pulls HTML5 games, is way faster, uses less resources on both ends.
2021-10-03 03:49:49 +02:00
On Arch, `pacman -S wget python python-requests python-slugify` works.
Trial The First: Maybe It Works This Time
2021-10-02 03:05:29 +02:00
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.
Trial The Second: Make leafo happy by not murdering his servers Drop Selenium and clicking around itch - use the API instead. Pulls HTML5 games, is way faster, uses less resources on both ends.
2021-10-03 03:49:49 +02:00
- (It you found it multiple times, grab the one after ViewJam something something.)
Trial The First: Maybe It Works This Time
2021-10-02 03:05:29 +02:00
- Download https://itch.io/jam/NUMBER/entries.json (replacing NUMBER with what you wrote down)
Trial The Second: Make leafo happy by not murdering his servers Drop Selenium and clicking around itch - use the API instead. Pulls HTML5 games, is way faster, uses less resources on both ends.
2021-10-03 03:49:49 +02:00
- 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`
Trial The First: Maybe It Works This Time
2021-10-02 03:05:29 +02:00
- Wait. This is going to take a while.
Trial The Second: Make leafo happy by not murdering his servers Drop Selenium and clicking around itch - use the API instead. Pulls HTML5 games, is way faster, uses less resources on both ends.
2021-10-03 03:49:49 +02:00
The downloader is able to grab more or less everything you can download via the itch app.
Trial The First: Maybe It Works This Time
2021-10-02 03:05:29 +02:00
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.
Trial The Second: Make leafo happy by not murdering his servers Drop Selenium and clicking around itch - use the API instead. Pulls HTML5 games, is way faster, uses less resources on both ends.
2021-10-03 03:49:49 +02:00
(There's a pedantic mirroring toggle in the script, if you know what you're doing though.)
Reference in New Issue Copy Permalink