Skip to content

A script to extract the original Xbox's redump archives.

License

Notifications You must be signed in to change notification settings

rizaumami/redump2x

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

redump2x

redump2x is a Bash script to convert ogxbox redump archive into xdvdfs (xiso).

Features:

  • convert redump iso or archive to xiso format.
  • copy game's certificate to attach.xbe.
  • sanitize xiso filename (to conform FATX limitations).
  • split xiso into two equal size.
  • add game cover to be displayed on UnleashX dashboard.
  • join splitted xisos.
  • update attacher, artwork, filename, and directory name.
  • batch processing.

How to

Install

  • Install dependencies

    sudo apt install coreutils p7zip-full grep xxd
  • Clone this repo

    git clone https://github.com/rizaumami/redump2x

Use

  • Go to redump2x folder an then execute redump2x script.

    cd redump2x
    ./redump2x -h
    redump2x is a Bash script to convert ogxbox redump archive into xdvdfs (xiso).
    
    Usage: redump2x OPTION
    
    OPTION:
      -a    Install artworks (game cover) from Rocky5's Xbox Artwork Installer.
      -b    Create xiso folder to be booted from disk.
            Need either Cerbios, driveimageutils, xiso patched M8+ BIOS, or LithiumX
            dashboard to launch the folder.
      -D    Delete the input file after processing.
      -d    Use dd instead of xdvdfs.
            This will only remove the redump's video partition, so the output
            will be quite big. Mostly around ~7 GB.
      -h    Print this help text and exit.
      -i    Input file or directory (default to /home/iza).
            If input is a directory, files inside it will be batch processed.
      -j    Join splitted xisos.
      -n    Do not split Xiso.
            Script is default to no splitting, but when -b is used it will always
            splitting the xiso if its size is bigger than 4 GB.
            With this option, xiso wont be splitted even when -b is used.
      -o    Output directory (default to /home/iza).
      -p    Password to extract encrypted archive.
            Script will exit on wrong password.
            If the archives protected with different passwords, it's better to not
            use this option and input password manually when asked.
      -s    Always split output xiso into two equal size.
      -u    Update attach.xbe, thumbnail, filename, and directory name.
      -v    Print version information and exit.
    
    Example:
      - Install artwork.
        redump2x -a -i 'Xbox Artwork Installer.zip'
    
      - Convert CoolGame.iso and save it into /tmp/xiso directory.
        redump2x -i /home/iza/CoolGame.iso -o /tmp/xiso
    
      - Convert game isos in Redump directory and save it into /tmp/xiso.
        redump2x -i /home/iza/Redump -o /tmp/xiso
    
      - Convert CoolGame.iso to bootable from disk format.
        redump2x -bi /home/iza/CoolGame.iso
    
      - Convert CoolGame.iso and split the output into two equal size ISOs.
        redump2x -si /home/iza/CoolGame.iso
    
      - Provide password for password protected archive.
        redump2x -p secretpassword -bi /home/iza/CoolGame.7z
    

Notes

  • If you want to build xdvdfs:

    sudo apt install cargo
    git clone https://github.com/antangelo/xdvdfs
    cd xdvdfs
    cargo build --release

    Copy the binary to bin redump2x's folder, or include $HOME/.cargo/bin to your $PATH.

  • This script uses attach.xbe from driveimageutils and tested on EvoX M8+ BIOS hardmodded ogxbox.
    Compatibility on another systems or configurations are not yet tested.

  • Script default to no splitting. But when -b is used, it will always split the xiso if its size is bigger than FATX limit.
    Use -n to keep the xiso unsplitted even when -b is in use.

  • Wrong password on protected archive will stop the script.
    Only use -p option if the archives using the same password.

  • Game cover (artwork) is taken from Rocky5' Xbox Artwork Installer.
    Get it from here and install it using following command:

    redump2x -ai 'Xbox Artwork Installer.zip'

    Now, Icon.jpg will automatically created during xiso preparation.

  • These Icon.jpg or Icon.png artworks will only be displayed in UnleashX.

LICENSE

  • redump2x script is licensed as stated inside the script and LICENSE file.
  • The files inside bin folder has their own licenses and are excluded from the scope of this repo's license.
    I have a plan to remove the binaries and replaced it with its submodules in future release.