Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .github/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
dump.bin.changelog.txt
dump.bin

../dist/
../PyPS3checker/__pycache__
52 changes: 52 additions & 0 deletions .github/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
# PyPS3tools

A suite of Python tools for validating, manipulating, and re-building PS3 flash memory dump files (NOR/NAND/EMMC).

## Disclaimer
> [!WARNING]
> COMPATIBLE WITH PYTHON 3.
>
> **ALL THESE SOFTWARES ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.**
> USE THEM AT YOUR OWN RISK. The author accepts no responsibility for the consequences of your use of them.

## Installation & Usage

### Linux / macOS

**Requirements:**
- Python 3.x
- Tkinter (usually included, but can be installed via `sudo apt-get install python3-tk`)

**Running the GUI:**
1. Open a terminal in the tool's directory
2. Run the following command:
```bash
python3 checker_gui.py
```
*(Or make it executable with `chmod +x checker_gui.py` and run `./checker_gui.py`)*

**Running CLI Tools:**
Pass the dump file as an argument:
```bash
python3 checker_py3.py dump.bin
```

### Windows

**Method 1: Drag & Drop (Easiest for CLI)**
For the command-line scripts, you can simply **drag and drop your `.bin` dump file onto the corresponding `drag&drop_your_dump_here.bat` file**

**Method 2: Graphical Interface**
To use the new GUI:
1. Ensure Python 3 is installed.
2. Open a terminal in the tool's directory
3. Run the following command:
```bash
python3 checker_gui.py
```

## Credits
- Thanks to the entire PS3 dev community.
- Special thanks to LS beta testers.

[![Star History Chart](https://api.star-history.com/svg?repos=littlebalup/PyPS3tools&type=date&legend=top-left)](https://www.star-history.com/#littlebalup/PyPS3tools&type=date&legend=top-left)
104 changes: 104 additions & 0 deletions PyPS3checker.changelog.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
PyPS3checker - Python checker script for PS3 flash memory dump files
Copyright (C) 2015 littlebalup@gmail.com
-------------------------------------------------------------------

v0.11.4, (09 March 2024) :
Added 4.92 hashes.

v0.11.3, (11 March 2024) :
Added 4.91 hashes.

v0.11.2, (05 March 2023) :
Added 4.90 hashes.

v0.11.1, (16 May 2022) :
Added 4.89 hashes.
Introduction of a Python 3 version of the script (Jan 16 2022. Credits to Vinh Quang Tran)
Some improvements in check entries.

v0.11.0, (22 Aug 2021) :
Improvements for refurbished consoles.

v0.10.4, (08 Jun 2021) :
Added 4.88 hashes.
Some improvements in check entries.

v0.10.3, (16 Dec 2020) :
Added 4.87 hashes.
Some improvements in check entries.

v0.10.2, (02 Apr 2020) :
Added 4.86 hashes.
Some improvements in check entries.

v0.10.1, (12 Sept 2019) :
Added 4.85 hashes.
Some improvements in check entries.

v0.10.0, (19 Apr 2019) :
Added some SKU entries for 4K dumps.
updated the "Notice" message to be less agressive...

v0.9.3, (03 Mar 2018) :
Added 4.84 hashs

v0.9.2, (19 Dec 2018) :
Added metldr rev key as parameter for a better SKU detection (minver vs metldr version enforced).
Checklist overal cleaning.

v0.9.1, (16 Oct 2018) :
Added 4.83 hashs
Created a "Standalone Package" edition bypassing python installation need for Windows users.

v0.9.0, (19 Jul 2018) :
Added a drag and drop batch file for Windows (noob) users.
Added checklog cleanup code to remove crappy colorama generated characters.

v0.8.0, (03 feb 2018) :
Changed the way to get and display flash type.
Added more 3k/4k entries.

v0.7.0, (13 Jan 2018) :
Added 239MB EMMC dump support (PS3Xploit).
Note: 4k checks still under development.

v0.6.0, (09 Jan 2018) :
Added 239MB NAND dump support (PS3Xploit).

v0.5.1, (15 nov 2017) :
Added 4.82 hashs recognition.

v0.5.0, (29 nov 2016) :
Added CFW and DEX OFW ROS hashs recognition (thanks to baileyscream and all CFW devs).
Added trvk_prg hash check.
Added "Additional information" field (HDD, MAC address...).
Added some colored strings (optional, requires "Colorama" python module).
Plus some additional minor improvements.

v0.4.0, (15 nov 2016) :
Fixed CELL_EXTNOR_AREA 0x00 Filled Area 3 and 6.

v0.3.4, (02 nov 2016) :
Added patched 4.81 ROS hashs to hashlist.

v0.3.3, (30 may 2016) :
Added patched 4.80 ROS hashs to hashlist.

v0.3.2, (24 jan 2016) :
Added patched 4.78 ROS hashs to hashlist.

v0.3.1, (20 jan 2016) :
Added OFW 4.78 ROS hashs to hashlist.

v0.3, (03 nov 2015) :
Fixed bug displaying the whole dump data in console if reversed check fails.
Added alternate conditions to determine if dump is reversed or not.
Various minor wording corrections.
Added one CECHBxx SKU check entry (NAND).
Added none-wifi machines entry in cISD2 check (NOR & NAND).

v0.2.1, (06 sept 2015) :
Added 4.76 ROS hashs to hashlist.

v0.2 (14 jun 2015) :
Initial public release
Loading