Skip to content

Team-Resurgent/Repackinator

Repository files navigation

Team Resurgent Presents, Repackinator

A Modern ISO Manager for Original Xbox

License: GPL v3 .NET Discord

ko-fi Patreon

Download

Repackinator was designed to be a modern all-in-one ISO management tool for the Original Xbox.

It provides you the ability to convert your OG Xbox ISO dumps into full working split ISO images, as well as optionally replacing padding for even greater compression. Repackinator can also create reduced size ISO images by trimming the unused space, if desired. Additionally, the ability to create playable compressed ISO images was introduced to dovetail the newly released CCI (Cerbios Compressed Image) compression method; this after being written from scratch, in collaboration with Team Cerbios.

Programmed for the very specific task of compressing original Xbox ISO structures, all while removing unused and or wasted space, Cerbios Compressed Images are the gold standard of Xbox ISO compression. The smallest file sizes all while maintaining maximum playability is the name of the game.

                    [ Program ..................................... Repackinator V2.1.0 ]
                    [ Type ................................................ Iso Manager ]
                    [ Patreon ....................https://www.patreon.com/teamresurgent ]

                    [                           Team Members:                           ]
                    [ EqUiNoX ......................................... Lead Programmer ]
                    [ HoRnEyDvL ............................... Tester/ Project Manager ]
                    [ Hazeno ................................................... Tester ]

System Requirements

Minimum

  • OS: Windows 7+ x64, x86-64 Linux, or MacOS (verified on Big Sur, should run from High Sierra onwards, please report any findings). 32-bit is not supported.
    • Repackinator can be ran in a virtual machine with GPU passthrough. (Virtual GPU must be disabled)
  • RAM: 8GiB of RAM for proper operation.

Prerequisites

Core Features & Functionality

Repackinator will extract Certs, Title ID & Title Image (.tbn) from the XBE located inside the ISO Dump. It will then generate a new default.xbe, which will be used to load the ISO on ISO Enabled softmods and BIOSs, such as Cerbios (Native ISO Support), iND-BiOS (Patched), EvoX M8+ (Patched).

The generated default.xbe will use the XBE Title Column as the new Title Name. This is the name of the game which is displayed on your favorite dashboard.

Please note that the region shown in Repackinator is calculated based on the region that is extracted from the game's original XBE. These regions are:

  • GLO = (Global) USA,PAL,JPN
  • JPN = (Japan/Asia) JPN
  • PAL = (Europe/Australia) PAL
  • USA = (USA) USA
  • USA-JPN = (USA,Japan/Asia) USA,JPN
  • USA-PAL = (USA,Europe/Australia) USA,PAL

Current database contains 1044 games. The info shown has been compiled by extracting the Title Name, Region, Version & Title ID from the default.xbe of each game. This contains all USA Region Games, PAL Only Exclusives & JPN Only Exclusives. Remaining Xbox library available in the alternative database. JSON file can be edited to include missing titles if desired.

Also included, is the ability to easily update legacy Attacher (default.xbe) created by tools like DVD2Xbox with new improved Cerbios Attacher (default.xbe).

Install Notes

  • Repackinator consists of two executables:
    • Repackinator.exe - GUI application for managing and processing Xbox disk images
    • repackinator.shell.exe - Command-line interface for all operations
  • Windows Only Run repackinator.shell.exe -a=register as administrator to enable context menu. The application will automatically prompt for elevation if needed. Use repackinator.shell.exe -a=unregister to remove context menu.

Known Issues

  • XBMC based FTP programs are known to "trim" files that get too close to the FATX limit. Repackinator is designed to be aware of this limit and will never produce a file larger than 4,290,735,312 bytes. We have had issues reported from this scenario. **This will manifest as a black screen when trying to launch your game. If you transfer to Xbox with FTP and experience this, verify your .1.cci or .1.iso file size matches what is on your computer.

    • UNVERIFIED EvolutionX FTP has been reported to work properly for this use.
  • We only recommend FATXplorer by Eaton Works officially at this time. This is to ensure no problems transferring files to and from your Xbox hard drive. Recommendation may be updated as more tools are tested in the future.

GUI Functionality

GUI

Per title:

  • Process: must be selected for titles you desire to be processed. Deselects after title have been processed

Options:

  • Grouping Selection: creates grouped folders in the output directory. Default = no grouping
  • Use Uppercase: output file/folder names with all UPPERCASE characters.
  • Compress: apply CCI compression to the output. CCI is currently only supported by Cerbios
  • Scrub: replace padding with zeros for greater compression.
  • TrimScrub: scrub & trim the padding at the end of the data partition. Similar to XISO
  • Traverse Input Subdir's: look for files to process inside any additional directories within your selected input folder.
  • Do not split ISO: no spliting of ISO output. ≥4GiB titles will not fit FATX size limit
  • Input Folder: (Path to your Redump .ZIP/.7Z/.RAR/.CCI or .ISO Files) SHOULD NOT INCLUDE REPACKINATOR'S ROOT, ANY SYSTEM FILES, OR BE A CHILD OF 'OUTPUT'
  • Output Folder: (Path to where you want to save your processed games)
  • Unpack Folder: (Optional path to where to temporarily extract .ZIP/.7Z/.RAR archives)

Actions:

  • Save Game Data: save changes to title information in database.
  • Save Selected: export data from selected titles.
  • Scan Output: scan titles in output folder.
  • Attach Update: update attach files in output folder.
  • Process: start processing.

Command Line Use

Repackinator provides a cross-platform command-line interface via repackinator.shell.exe. All command-line operations are performed through this executable.

Available Actions

  • Pack - Pack a folder into ISO or CCI format
  • Repack - Repackinate a collection of Xbox disk images
  • Convert - Convert one Xbox disk image format to another
  • Extract - Extract files from Xbox disk image
  • Compare - Compare two Xbox disk images
  • Info - Show Xbox disk data sector information
  • Checksum - Calculate checksum of Xbox disk image sectors
  • XbeInfo - Extract XBE certificate information from disk image
  • Register - Register context menu (Windows, requires admin)
  • Unregister - Unregister context menu (Windows, requires admin)

Getting Help

  • Run repackinator.shell.exe -h to view all available actions
  • Run repackinator.shell.exe -a=<action> -h to view detailed help for a specific action

Example: Repack Action

Run repackinator.shell.exe -a=repack along with the following options:

  -i, --input=VALUE          Input folder
  -o, --output=VALUE         Output folder
  -p, --unpack=VALUE         Unpack folder (optional)
  -g, --grouping=VALUE       Grouping (None *default*, Region, Letter,
 	                                   RegionLetter, LetterRegion)
  -u, --uppercase            Uppercase
  -r, --recurse              Recurse (Traverse Sub Dirs)
  -c, --compress             Compress (CCI)
  -s, --scrub                Scrub
  -t, --trimscrub            TrimScrub
  -l, --log=VALUE            log file
  -h, --help                 show help
  -w, --wait                 Wait on exit

Example: Pack Action

Pack a folder to ISO or CCI format:

  -i, --input=VALUE          Input folder (required)
  -o, --output=VALUE         Output file path (required)
  -c, --compress             Compress to CCI format (default: ISO)
  -s, --scrub                Scrub padding
  -t, --trimscrub            TrimScrub padding
  -n, --nosplit              Do not split at 4GB (not recommended)
  -h, --help                 show help
  -w, --wait                 Wait on exit

Context Menu

After Repackinator context menu has been registered, it will be available for supported file types and folders.

contextMenu

CONTEXT MENU OPTIONS WILL NOT CREATE default.xbe OR default.tbn FILES!

For ISO/CCI Files:

  • .ISO files can be split, as well as .CCI files can be decompressed using the Convert to ISO functions.
  • .ISO files can be compressed to various types of .CCI using the Convert to CCI functions.
  • Compatible files can be cryptographically compared by selecting Compare Set First on initial file, then Compare First With on the second file.
  • XBE Info will display XBE certificate information from the disk image.
  • Info will print the sector data.
  • Checksum will calculate and display the SHA256 checksum.
  • Extract will create a HDD ready file from any supported input type.

For Folders:

  • Pack To ISO will pack the folder contents into a split ISO image (automatically splits at 4GB).
  • Pack To CCI will pack the folder contents into a split CCI compressed image (automatically splits at 4GB).

Acknowledgments

  • First, we would like to thank all of our Patreon supporters! You are the reason we can continue to advance our open source vision of the Xbox Scene!
  • We can't thank Team Cerbios enough for their amazing BIOS, as well as their continued contributions of features to a decades old gaming console. This program began as a collaboration with their team to modernize the Original Xbox. They also provided the modernized ISO Attach (default.xbe) with bug fixes and improvements. Thank you again!
  • We want to thank all the Original Xbox devs for bringing us the awesome applications, dashboards and emulators we have grown to love and for kickstarting the scene back in the day.
  • Thanks to the team at Xbox-Scene Discord - Haguero, AmyGrrl, CrunchBite, Derf, Risk, Sn34K, ngrst183
  • Huge Shout-out to Kekule, Ryzee119, & ChimericSystems for all the time & effort they have put towards reverse engineering & creation of new hardware mods.
  • To all the people behind projects such as xemu and Insignia. Keep up the amazing work! We can't wait for your final product releases.
  • Greetz to the following scene people, in no particular order - Milenko, Iriez, Mattie, ODB718, ILTB, HoZy, IceKiller, Rowdy360, Lantus, Kl0wn, nghtshd, Redline99, The_Mad_M, Und3ad, HermesConrad, Rocky5, xbox7887, tuxuser, Masonly, manderson, InsaneNutter, IDC, Fyb3roptik, Bucko, Aut0botKilla, headph0ne,Xer0 449, hazardous774, rusjr1908, Octal450, Gunz4Hire, Dai, bluemeanie23, T3, ToniHC, Emaxx, Incursion64, empyreal96, Fredr1kh, Natetronn, braxtron

GitHub contributors GitHub repo file count Lines of code GitHub repo size GitHub all releases

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages