Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/windsurfer1122/PSN_get_pkg_info
Extract package information from header and PARAM.SFO of PS3/PSX/PSP/PSV/PSM and PS4 packages.
https://github.com/windsurfer1122/PSN_get_pkg_info
Last synced: about 2 months ago
JSON representation
Extract package information from header and PARAM.SFO of PS3/PSX/PSP/PSV/PSM and PS4 packages.
- Host: GitHub
- URL: https://github.com/windsurfer1122/PSN_get_pkg_info
- Owner: windsurfer1122
- License: gpl-3.0
- Created: 2018-10-30T22:16:30.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2020-02-24T21:49:32.000Z (almost 5 years ago)
- Last Synced: 2024-08-03T23:05:45.963Z (5 months ago)
- Language: Python
- Size: 709 KB
- Stars: 31
- Watchers: 7
- Forks: 11
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: COPYING
Awesome Lists containing this project
- Awesome-PS4-Jailbreak - PSN_Get_Pkg_Info.py
README
# PSN_get_pkg_info.py (c) 2018-2020 by "windsurfer1122"
Extract package information from header and PARAM.SFO of PS3/PSX/PSP/PSV/PSM and PS4 packages.
## Goals
* One-for-all solution to retrieve all header data and PARAM.SFO data from PSN packages
* Decryption of PS3 encrypted data to get all data
* Support of all known package types: PS3/PSX/PSP, PSV/PSM, PS4
* Extraction of PS3/PSX/PSP/PSV/PSM packages similar to pkg2zip and pkg_dec
* pkg_dec's raw extraction, where the complete package is decrypted and again stored as a single file which keeps the package structure 1:1 (decrypted package)
* Content extraction, where the package items are decrypted and stored under their original item names
* ux0 extraction, where the package items are decrypted and stored as they would have been installed on the PS Vita file system.
* PSP: Extraction as EBOOT.PBP for [npdrm_free plugin](https://github.com/qwikrazor87/npdrm_free) on PSP or on PSV with [Adrenaline](https://github.com/TheOfficialFloW/Adrenaline).
Extraction as ISO/CSO is not supported yet, there are other tools to help out like [ISO~PBP Converter](https://sites.google.com/site/theleecherman/IsoPbpConverter) and [CISO Multi Compressor](https://sites.google.com/site/theleecherman/cisomulticompressor) plus homebrew [Takka](http://takka.tfact.net/2011/)'s [ISO Tool 1.981](https://wololo.net/downloads/index.php/download/7918) to integrate updates/patches and [Disc Change 2.6](https://www21.atwiki.jp/improper_code/pages/73.html#id_32933629) ([DL](https://www21.atwiki.jp/improper_code?cmd=upload&act=open&pageid=73&file=disc_change_2_6.zip)). And also [UMDGen](http://www.psx-place.com/resources/umd-gen-4-00.208/).
* Easy enhancement of interpreting data (=done at the very end with all data at hand)
* Support http download streaming to avoid harddisk usage
* Support multi-part packages (PS3: XML, PS4: JSON)
* Support multiple output formats
* Support multiple debug verbosity levels
* Easy to maintain and no compiler necessary (=interpreter language)
Unfortunately the cryptographic modules may need a compiler for some operating system (see [Requirements](#Requirements) )
* Cross platform support
* Decision: Python 3
* Compatible with Python 2 (target version 2.7, but not thoroughly tested anymore)
* Identical output
* Forward-compatible solutions preferred
* Modular and flexible code for easy enhancement and/or extensions (of course there's always something hard-coded left)
## Execution
For available options execute: `PSN_get_pkg_info.py -h`
It is recommended to place `--` before the package sources, to avoid them being used as targets, e.g. `PSN_get_pkg_info.py --raw -- 01.pkg 02.pkg` will never kill the 01.pkg!
Use at your own risk!
If you state URLs then only the necessary bytes are downloaded into memory. Note that the "--raw" option downloads the complete package once without storing the original data on the file system.
Also see [Path Pattern Examples](#Path-Pattern-Examples-for-`--content`-Extraction) and [RIF/RAP/DevKLic Handling](#RIF/RAP/DevKLic-Handling).
## Contributions welcome
* Especially information about how to interpret data is needed, e.g. content types
* See TODO.md what is still left to do
## Requirements
* Python Modules
* [pycryptodomex](https://www.pycryptodome.org/) >= 3.7.2 (note the X at the end of the module name)
https://www.pycryptodome.org/en/latest/src/installation.html
* [cryptography](https://cryptography.io/) (optional if pycryptodomex 3.7.2+ is not available)
* [requests](http://python-requests.org/)
* [aenum](https://bitbucket.org/stoneleaf/aenum)
* [fastxor](https://github.com/davidfischer-ch/python-fastxor)
* [packaging](https://github.com/pypa/packaging)
* [ecdsa](https://github.com/warner/python-ecdsa)
### Installing on Debian
1. Python 3, which is the recommended version, and most modules can be installed via apt.
Install Python 3 and some modules via the following apt packages: `python3 python3-pip python3-requests`.
1. Python 2 is the default on Debian, but comes with an outdated pip version until Debian 8.
Note that with Python 2 ZRIF support is not possible at all.
__Starting with Debian 9 "Stretch"__ install Python 2 modules via the following apt packages: `python-pip python-future python-requests`.
For __Debian up to 8 "Jessie"__ use the pip version from the original [PyPi](https://pypi.org/project/pip/) source:
```
apt-get purge python-pip python-dev python-future
apt-get autoremove
wget https://bootstrap.pypa.io/get-pip.py
python2 get-pip.py
pip2 install --upgrade future
```
1. Install further necessary Python modules via pip.
* Install pycryptodomex module:
https://www.pycryptodome.org/en/latest/src/installation.html
* Python 3: `pip3 install --upgrade pycryptodomex`
* Python 2: `pip2 install --upgrade pycryptodomex`
* Install cryptography module:
* Optional: `apt-get install `
* Python 3: `pip3 install --upgrade cryptography`
* Python 2: `pip2 install --upgrade cryptography`
* Install aenum module:
* Python 3: `pip3 install --upgrade aenum`
* Python 2: `pip2 install --upgrade aenum`
* Install fastxor module:
* Python 3: `pip3 install --upgrade fastxor`
* Python 2: `pip2 install --upgrade fastxor`
* Install packaging module:
* Python 3: `pip3 install --upgrade packaging`
* Python 2: `pip2 install --upgrade packaging`
* Install ecdsa module:
* Optional: `apt-get install `
* Python 3: `pip3 install --upgrade ecdsa`
* Python 2: `pip2 install --upgrade ecdsa`
### Installing on Windows
1. Install Python
Checked with Python 3.7 x64 on Windows 10 x64 Version 1803.
* Get it from the [Python homepage](https://www.python.org/)
* Install launcher for all users
* Add Python to PATH
Adds %ProgramFiles%\Python37 + \Scripts to PATH
* __Use Customize Installation (!!! necessary for advanced options !!!)__
* Advanced Options
* Install for all users
1. Install necessary Python modules via pip.
* Start an __elevated(!!!)__ Command Prompt (Run As Admin via Right Click)
* Update PIP itself first: `python -m pip install --upgrade pip`
* Install pycryptodomex module: `pip install --upgrade pycryptodomex`
https://www.pycryptodome.org/en/latest/src/installation.html
* Install cryptography module: `pip install --upgrade cryptography`
* Install requests module: `pip install --upgrade requests`
* Install aenum module: `pip install --upgrade aenum`
* Install fastxor module: `pip install --upgrade fastxor`
* Install packaging module: `pip install --upgrade packaging`
* Install ecdsa module: `pip install --upgrade ecdsa`
* Exit Command Prompt: `exit`
Executing python scripts can be done via Windows Explorer or a Command Prompt. Normally no elevation is necessary for script execution, except when the python script wants to change something in the system internals.
## Using a HTTP Proxy with Python
* Linux: `export HTTP_PROXY="http://192.168.0.1:3128"; export HTTPS_PROXY="http://192.168.0.1:1080";`
## Path Pattern Examples for `--content` Extraction
* eboot.bin: `--pathpattern '^(USRDIR/EBOOT\.BIN|(contents/runtime/){0,1}eboot\.bin)$'`
* *.edat: `--pathpattern '\.(edat|EDAT)$'`
## RIF/RAP/DevKLic Handling
* RIF/RAP Conversion: `-f 50 --rapkey ... --rifkey ... -- dummy`
* Verification: `-f <0|2|99> [-f 50] --rapkey ... --rifkey ... --devklickey ... -- `
There can be multiple results for a package file with different EDAT files.
* "NOT REQUIRED" = Either SDAT via header hash or EDAT via Dev KLicensee key
* False = no supplied RAP/RIF or Dev KLicensee key worked
* Otherwise the result is the working RAP or Dev KLicensee key
## Original Source
git master repository at https://github.com/windsurfer1122
## License
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .
## Additional Credits for Ideas and Several Details
* [AnalogMan1511](https://github.com/AnalogMan151) - initial idea
* https://playstationdev.wiki/ (previously https://vitadevwiki.com/ & https://www.pspdevwiki.com/)
* http://www.psdevwiki.com/
* [lusid1](https://github.com/lusid1/) - enhanced pkg2zip
* [mmozeiko](https://github.com/mmozeiko/) - original pkg2zip
* [st4rk](https://github.com/st4rk/) -PkgDecrypt (pkg_dec)
* [qwikrazor87](https://github.com/qwikrazor87/) - pkgrip
* [JK3Y](https://github.com/JK3Y/pkg-getinfo) - TypeScript/JavaScript/Node.js version of PSN_get_pkg_info
* SSL and zecoxao