Oracle/LibRay
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Push 0.10.0

Browse source
This commit is contained in:
Oracle 2026-05-18 16:31:58 +02:00
parent 266f3fc76d
commit 12c05afa57
Signed by: Oracle
SSH key fingerprint: SHA256:x4/RtnjUyuHkdvmwNDsWSfcfF1V5PNr3OpriZqOvCX8
25 changed files with 2016 additions and 645 deletions
Download patch file Download diff file Expand all files Collapse all files

44
README.md
View file

@ -1,14 +1,12 @@
# LibRay
# Libray
LibRay: A portmanteau of Libre and Blu-Ray
Libray: A portmanteau of Libre and Blu-Ray
LibRay aims to be a Libre (FLOSS) Python application for unencrypting,
Libray aims to be a Libre (FLOSS) Python application for unencrypting,
extracting, repackaging, and encrypting PS3 ISOs.
A hackable, crossplatform, alternative to ISOTools and ISO-Rebuilder.
**Note: this is still a very beta project, report any bug you see!**
## How to install
Note: You will need Python 3, so you might want to use `python3` and `pip3` instead of `python` and `pip` depending on your system.
@ -35,6 +33,10 @@ Then you will need to run the appropriate install command for that AUR helper us
This will essentially automatically do the manual method for you.
### With pipx:
- PyPi version: `pipx install libray`
### Done!
`libray` is now installed to your path.
@ -42,22 +44,27 @@ This will essentially automatically do the manual method for you.
## How do I use it?
```
usage: libray [-h] -i ISO [-o OUTPUT] [-k IRD] [-d DECRYPTION_KEY] [-v] [-q] [-r]
usage: libray [-h] (-i ISO | -k IRD) [-o OUTPUT] [-d DECRYPTION_KEY] [-v] [-q] [-r] [-c] [-t CHECKSUM_TIMEOUT] [--info]
A Libre (FLOSS) Python application for unencrypting, extracting, repackaging, and encrypting PS3 ISOs
required arguments:
options:
-h, --help show this help message and exit
-i ISO, --iso ISO Path to .iso file or stream
-k IRD, --ird IRD Path to .ird file
optional arguments:
-o OUTPUT, --output OUTPUT
Output filename
-k IRD, --ird IRD Path to .ird file
-d DECRYPTION_KEY, --decryption-key DECRYPTION_KEY
Manually specify key
-v, --verbose Increase verbosity
-q, --quiet Quiet mode, only prints on error
-r, --re-encrypt Re-encrypt .iso
-c, --checksum Allow fallback to CRC32 checksum (disabled by default)
-t CHECKSUM_TIMEOUT, --checksum-timeout CHECKSUM_TIMEOUT
How many seconds to wait for CRC32 checksum (default 15)
--info Print info about .iso or .ird, then quit.
```
First off, even before you install libray, you will need a compatible Blu-Ray drive that can read PS3 discs.
@ -98,9 +105,24 @@ Then, if you want to feed it into RPCS3 just extract the contents of the .ISO:
7z x nfs_ps3_decrypted.iso
```
And move the resulting folders into a folder named after the game ID into the appropriate folder for RPCS3:
And move the resulting folders into a folder named after the game ID into the appropriate folder for RPCS3, for example:
- Linux: /home/username/.config/rpcs3/dev_hdd0/disc/BLUS0000
- macOS: ~/Library/Application Support/rpcs3/dev_hdd0/disc/BLUS0000
### 3. (Optional) Print info about .iso or .ird:
Get info from .iso without decrypting
```
libray -i ps3_game.iso --info
```
Get info from .ird
```
libray -k game_ird_file.ird --info
```
## License
@ -108,7 +130,7 @@ This project is Free, Libre, and Open Source Software; FLOSS, licensed under the
See also COPYING or LICENSE.txt
Copyright © 2018 - 2021 Nichlas Severinsen
Copyright © 2018 - 2024 Nichlas Severinsen
## Error!
@ -144,7 +166,7 @@ clp = compressed length prefix
## Tests
`python -m unittest discover`
`python -m unittest discover -b`
## Deployment