LibRay aims to be a Libre (FLOSS) Python application for unencrypting, extracting, repackaging, and encrypting PS3 ISOs.

Nichlas Severinsen ae4f21fcce Update 4 months ago
docs 8661a20622 Add section on packagin and dependencies to specification 1 year ago
libray 8a65a09a03 Add --info flag 4 months ago
tests c34a1cee8c Add new tests for ISO lookup logic 5 months ago
tools 88d1b48167 Release 0.0.8 2 years ago
.editorconfig d669116cf0 Added editorconfig 3 years ago
.gitignore 928ff3128f Fix bundled search for titles with ™ and ® in them 2 years ago 266f3fc76d Release 0.0.9 2 years ago
COPYING 16a5e95777 Initial commit 6 years ago
LICENSE.txt b70b129467 Preparing for PyPi 5 years ago ae4f21fcce Update 4 months ago
app.yaml 56e9beaa20 Some tidying 5 years ago
requirements.txt 79f303be57 Update requirement versions and allow compatible versions to be used 2 years ago
setup.cfg b70b129467 Preparing for PyPi 5 years ago 266f3fc76d Release 0.0.9 2 years ago


LibRay: A portmanteau of Libre and Blu-Ray

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.

From PyPi:

  1. sudo pip install libray


  1. Clone this repository git clone

  2. Install dependencies with sudo pip install -r requirements.txt

  3. Run sudo python install

From AUR:

For Arch or Arch-based GNU/Linux distributions there's an option to install libray from the AUR (Arch User Repository).

You will need an AUR helper (of which there are many).

Then you will need to run the appropriate install command for that AUR helper using libray as package name.

This will essentially automatically do the manual method for you.


libray is now installed to your path.

How do I use it?

usage: libray [-h] -i ISO [-o OUTPUT] [-k IRD] [-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:
  -i ISO, --iso ISO     Path to .iso file or stream

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)
                        How many seconds to wait for CRC32 checksum (default 15)
  --info                Print info about .iso, then quit.

First off, even before you install libray, you will need a compatible Blu-Ray drive that can read PS3 discs.

There's a compiled list of compatible drives here: (archive) (see "Compatible Blu-ray disc drives section").

1. Decrypt

On some systems (eg. Linux), you can decrypt directly from the disc:

libray -i /dev/sr0 -o ps3_game_decrypted.iso

Libray is bundled with redump keys and will automatically try to decrypt the .iso if it finds a compatible key. If not, it will try to download an IRD decryption file for your iso. If you don't have internet connection, but you do have an .ird file you can specify that:

libray -i /dev/sr0 -k game_ird_file.ird -o ps3_game_decrypted.iso

Alternatively, you can first rip the disc to an ISO file and then decrypt from the ISO file:

libray -i ps3_game.iso -o ps3_game_decrypted.iso

If libray is unable to download an .ird for your game, you could manually give it the key, if you have it:

libray -i ps3_game.iso -d DECRYPTION_KEY -o ps3_game_decrypted.iso

2. Extract decrypted ISO

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:

  • Linux: /home/username/.config/rpcs3/dev_hdd0/disc/BLUS0000


This project is Free, Libre, and Open Source Software; FLOSS, licensed under the GNU General Public License version 3. GPLv3.

See also COPYING or LICENSE.txt

Copyright © 2018 - 2021 Nichlas Severinsen


Help! I get

ImportError: No module named Crypto.Cipher


ImportError: cannot import name 'byte_string' from 'Crypto.Util.py3compat' (/usr/lib/python3.7/site-packages/Crypto/Util/

This is due to multiple similarly named python crypto packages, one way to fix it is:

sudo pip uninstall crypto
sudo pip uninstall pycrypto
sudo pip install pycryptodome

If you get any other errors, or have any other problem with libray, please create an issue!


Bluray disc encryption (

.SFO (

TITLE_ID for Physical Media (

7bit encoded int / RLE / CLP

clp = compressed length prefix


python -m unittest discover


  1. pip3 install wheel twine
  2. Place redump keys in tools/keys and .dat in tools/
  3. Run, ensure it made a file in libray/data/keys.db
  4. Run python3 sdist bdist_wheel
  5. Run twine upload dist/*


  • Extract ISO (currently doable with 7z x output.iso)
  • Repackage (unextract) iso
  • Test .irds with version < 9
  • Custom command to backup all irds available
  • Unit tests
  • Download .irds from
  • Parallelization?