Xbox:Repackinator

From ConsoleMods Wiki
Revision as of 02:27, 6 September 2024 by Nadaman (talk | contribs) (Initial page creation)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Repackinator

Repackinator.png

Information
Founder(s) Team Resurgent
Contribution(s) Team Resurgent
Purpose Xbox ISO Manager
GitHub https://github.com/Team-Resurgent/Repackinator/


Repackinator is an Xbox ISO management tool developed by Team Resurgent that features various compression and trimming options, along side the ability to split ISOs with an attacher .xbe in order to play them on an Xbox HDD.

Information for this page has been provided from the official GitHub repository.

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

  • Run Repackinator.exe first time as administrator.
    • First run must be as administrator to enable context menu under Windows, CLI included.

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

Per title:

  • Process: must be selected for titles you desire to be processed. Deselects after title have been processed
  • Scrub: replace the padding with zeros, for greater compression.

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/CSO compression to the output. CCI is currently only supported by Cerbios, CSO only by StellarOS
  • Trim Scrub: remove all unused data at the end of 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/.CSO 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)

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

Windows Only

  • Must run Repackinator.exe -a=register as admin to enable context menu use. Use Repackinator.exe -a=unregister as admin to remove context menu.
  • Run Repackinator.exe -a=repack -h to view possible commands in CLI.
  • Run Repackinator.exe -a=repack along with the following options, based on your intended results.

-i, --input=VALUE Input folder -o, --output=VALUE Output folder -g, --grouping=VALUE Grouping (None *default*, Region, Letter, RegionLetter, LetterRegion) -u, --upperCase Upper Case -r, --recurse Recurse (Traverse Sub Dirs) -c, --compress=VALUE Compress (None *default*, CCi, CSO) -t, --trimmedScrub Trimmed Scrub -l, --log=VALUE log file -h, --help show help -w, --wait Wait on exit

Context Menu

After Repackinator has been ran as admin the first time, the context menu will populate.

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

  • .ISO files can be split, as well as .CCI/.CSO files can be decompressed using the Convert To ISO functions.
  • .ISO/.CSO files can be compressed to various types of .CCI using the Convert To CCI functions.
  • .ISO/.CCI files can be compressed to various types of .CSO using the Convert To CSO functions.
  • Compatible files can be cryptographically compared by selecting Compare Set First on initial file, then Compare First With on the second file.
  • Info will print the sector data.
  • Extract will create a HDD ready file from any supported input type.