CLI Tools for investigating game files and extracting known packages
Project description
Game Extraction Toolbox
CLI Tools for investigating game files and extracting known packages
Requirements
- Python 3.7+
- PIPx
Installation
Quick (if Python and Pipx are already installed)
pipx install game-extraction-toolbox
Full
Python 3.7+
Should by on Linux and MacOSX by default; for Windows, I recommend Digital Ocean's tutorial
PIPX
Windows
py -m pip install --user pipx
py -m pipx ensurepath
Linux
py -m pip install --user pipx
py -m pipx ensurepath
MacOSX
brew install pipx
pipx ensurepath
Usage
gametoolbox --help
You can get --help on any command or subcommand, for example:
gametoolbox file --help
FAQ
Why make this?
I want to get ROMs legally, or as legally as possible. I've bought cart readers, but these 'official' ROMs are often different or for platforms that aren't viable for cartridge dumping. I want this to be feasible for others as well.
Why are you reimplementing others? Why Python?
Many solutions so far are written in Bash, Powershell, and Batch, none of which are well suited to binary file manipulation. My ideal is that this CLI is useful for reasearching these packages and extracting them, and that common library improvements make this very possible.
Is this legal?
I am not a lawyer, but any good lawyer would probably tell you that 'It depends'. That said, this is an effort to be as legal as possible; this code doesn't download things you don't own, and I intend to leave decryption (bypassing copyright protection devices) out, which would be illegal under the DMCA. This is also at a weird intersection of older law, such as Fair Use, which generally - in most jurisdictions - has some protections for format-shifting. That's largely the point of this - ROMs are flexible and can be played on $20 cheap handhelds, phones, Steam Decks, PCs, tablets, Chromebooks, web pages, etc.
Why not just play the official release?
I prefer not to be artificially locked to specific platforms - why play a 25 year old arcade title on my Steam PC that my phone can easily handle? Furthermore, some official releases are... not great. Subpar emulation on lower-end PCs, slow loading and menus, older MAME runtimes with known issues - we can do better.
Why not just download the ROMs?
It is illegal. One can discuss economic moral implications all day, but at the end of the day, it's theft. As a software developer myself, I don't want my code stolen - so I can't claim a moral high ground there. Equally importantly, showing classic game owners that the market will support rereleases increases the liklihood of rereleases, and I want people who can't/won't download ROMs to enjoy these titles as well.
Collections
Collection | Status | Notes |
---|---|---|
Capcom Arcade Stadium 1 | 95% | Requires Steam depot downloading, a couple shaky ROMs |
Capcom Beat 'Em Up Bundle | 95% | 6/7 playable on some version of MAME, but wof/wofj missing audiocpu data |
Capcom Fighting Collection | 90% | CPS2 is semi-standard. No Enc keys present. CP3 game is a curveball! |
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for game-extraction-toolbox-0.0.16.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4cb37addcfa5c49082f8e7675c12147d3839bebdc542d5740281a5ae357bb31e |
|
MD5 | b57f0cf0d901ee2777354e8faf87cd40 |
|
BLAKE2b-256 | 27c4e73e929bd3d2cb060ac018964d6c00c315caa56d83292fcb97c47459c203 |
Hashes for game_extraction_toolbox-0.0.16-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 60084e89fe8401eecf50a8b75350b3e5398a7ff85a0be5d9890dba04ad84bdb7 |
|
MD5 | 9ce4757548b20f682399773fcb984d2d |
|
BLAKE2b-256 | 856e8afdaff3cca09d3b34d04be8865416b39b25d7e7474c26800e0772e4fd20 |