From 91ea87f26c2bbd4c852a0cf0ac2fd39e46ee3183 Mon Sep 17 00:00:00 2001 From: EqUiNoX Date: Fri, 19 Dec 2025 18:20:13 -0700 Subject: [PATCH] Update: readme's --- README.md | 50 +++++++++++++++++++++++--- Repackinator.nfo | 91 +++++++++++++++++++++++++++++++++--------------- 2 files changed, 107 insertions(+), 34 deletions(-) diff --git a/README.md b/README.md index e8a45af..a7ad574 100644 --- a/README.md +++ b/README.md @@ -58,7 +58,10 @@ Current database contains 1044 games. The info shown has been compiled by extrac 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.*** +* 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.*** @@ -93,9 +96,26 @@ Actions: * **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. +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= -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 @@ -111,22 +131,42 @@ Actions: -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 has been ran as admin the first time, the context menu will populate. +After Repackinator context menu has been registered, it will be available for supported file types and folders. ![contextMenu](readmeStuff/contextMenu.png?raw=true) ***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! diff --git a/Repackinator.nfo b/Repackinator.nfo index d94e1ee..2195b05 100644 --- a/Repackinator.nfo +++ b/Repackinator.nfo @@ -1,25 +1,25 @@ -ÜÜÛÛÛÛÛ²²ÛÛÛÛÛ ÜÜÜ ÛÛÛÜ ÜÛÛÛ² ÛÛßÛÛÛ ²ÛÛÛÛÛ ÛÛÛÛÛÛ Û ÛÛ ÛÛßÛÛÛ ÜÛÛÛÛ ²ÛÛÛÛÛ ÛÛÛÜ Û ÜÜÜÛÛÛÛÛ² -² ÛÛ± ²±²Û ß±ÛÛÛÛÜ ²ÛÛ±ßÛß ÛÛ± ²ÛÛ ± ÛÛ±²Û ß ±ÛÛ ± ÛÛ ²ÛÛ±²ÛÛ ± ÛÛ± ÛÛ± ßÛ±²Û ß ÛÛ ßÛ Û ² ÛÛ± ²± -± ²ÛÛ° ±°±ÛÛÛ ±ÛÛ ßÛÜ ²ÛÛ ²ÛÛ° ²ÛÛ °ÜÛ ±±ÛÛÛ ° ²ÛÛÜ ²ÛÛ ±ÛÛ°²ÛÛ °ÜÛ ±±ÛÛ°ÜÜÜ°±ÛÛÛ ²ÛÛ ßÛ ÛÛ±± ²ÛÛ° ±° -° ²ÛÛ² ° ±²Û Ü°ÛÛÜÜÜÜÛÛ±ÛÛ ±ÛÛ ±ÛÛßßÛÜ ±²Û Ü ± ÛÛ±²²Û °ÛÛ°±ÛÛßßÛÜ °²Û ÛÛ²±²Û ܲÛÛ± ÞÝÛÛ±° ²ÛÛ² ° - ±ÛÛ± ° °±ÛÛÛÛ±²Û ²ÛÛ±ÛÛ± °ÛÛ± °ÛÛ² ±ÛÛ±°±ÛÛÛÛ±±ÛÛÛÛÛÛ±±±±ÛÛÛÛÛ² °ÛÛ² ±ÛÛ±°±²ÛÛÛß±°±ÛÛÛÛ±ÛÛ° ²ÛÛ° ±ÛÛ± ° - ± °° °° ±° °±± ²±Û° ±° ° ° ° ±² °±²°°° ±° °± ±²± ± °°±²± ± ± ° ±² °±²° °± ± °° ±° ° ±° ± ± ± °° - ° ° ° ° ± ±± ° ° ° °± ° ±° ° ° °° °± ° °°°±° ° ° °± ° ±° ° ° ° ° ° °° ° ±° ° - ° ° ° ± ° ° °° ° ° ° ° ° °°° ° ° °° ° ° ° ° ° ° ° ° ° - ° ° ° ° ° ° ° ° ° ° ° ° ° ° ° +������۲������ ��� ���� ���۲ ������ ������ ������ � �� ������ ����� ������ ���� � �������۲ +� �۱ ���� ߱����� ��۱��� �۱ ��� � �۱�� � ��� � �� ��۱��� � �۱ �۱ �۱�� � �� �� � � �۱ �� +� ��۰ ������ ��� ��� ��� ��۰ ��� ��� ����� � ���� ��� ��۰��� ��� ���۰��ܰ���� ��� �� �۱� ��۰ �� +� ��۲ � ��� ܰ�������۱�� ��� ������� ��� � � �۱��� ��۰������� ��� �۲��� ܲ�۱ ���۱� ��۲ � + ��۱ � �����۱�� ��۱�۱ ��۱ ��۲ ��۱�����۱������۱�������۲ ��۲ ��۱������߱�����۱�۰ ��۰ ��۱ � + � �� �� �� ��� ��۰ �� � � � �� ������ �� �� ��� � ����� � � � �� ���� �� � �� �� � �� � � � �� + � � � � � �� � � � �� � �� � � �� �� � ����� � � �� � �� � � � � � �� � �� � + � � � � � � �� � � � � � ��� � � �� � � � � � � � � � + � � � � � � � � � � � � � � � Team Resurgent - [ Program ..................................... Repackinator V2.0.1 ] - [ Type ................................................ Iso Manager ] - [ Platform .................................... Windows, Linux, OSX ] - [ OS Architecture ............................................. X64 ] - [ By ............................................... Team Resurgent ] - [ Homepage ..........https://github.com/Team-Resurgent/Repackinator ] - [ Patreon ....................https://www.patreon.com/teamresurgent ] + [ Program ..................................... Repackinator V2.0.4 ] + [ Type ................................................ Iso Manager ] + [ Platform .................................... Windows, Linux, OSX ] + [ OS Architecture ............................................. X64 ] + [ By ............................................... Team Resurgent ] + [ Homepage ..........https://github.com/Team-Resurgent/Repackinator ] + [ Patreon ....................https://www.patreon.com/teamresurgent ] [ Release date ......................................... 25.09.2022 ] [ Team Members: ] @@ -35,6 +35,20 @@ /// /// /// ----------------------------------------------------------------------- /// /// /// +/// Release: V2.0.4 /// +/// ----------------------------------------------------------------------- /// +/// 1. Separated GUI and CLI into distinct executables /// +/// 2. Added Pack action to pack folders to ISO/CCI format /// +/// 3. Added XbeInfo action to extract XBE certificate information /// +/// 4. Improved context menu with folder support (Pack To ISO/CCI) /// +/// 5. Enhanced command-line help system with action-specific help /// +/// 6. Added automatic admin elevation for register/unregister actions /// +/// 7. Added progress indicators to all console actions /// +/// 8. Removed Xbox360 support (Xbox Original only) /// +/// 9. Improved error handling and user feedback /// +/// /// +/// ----------------------------------------------------------------------- /// +/// /// /// Release: V1.0.1 /// /// ----------------------------------------------------------------------- /// /// 1. Added native support for Linux & OSX /// @@ -78,18 +92,23 @@ /// /// /// What is Repackinator? /// /// /// -/// Repackinator was designed to be a AIO ISO Management tool which will /// -/// provide you the ability to convert your full OG Xbox Iso Dumps into /// -/// Split ISO Images, Making them compatible with ISO loading bioses for /// -/// the original Xbox console. /// +/// Repackinator was designed to be a modern all-in-one ISO Management tool /// +/// which will provide you the ability to convert your full OG Xbox ISO /// +/// dumps into 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. /// /// /// /// ----------------------------------------------------------------------- /// /// /// /// Core Features & Functionality /// /// /// -/// Repackinator will extract Certs, Title ID & Title Image from the XBE /// -/// located inside the ISO Dump. It will then generate a Default.XBE which /// -/// Will be used to load the ISO Games on ISO Enabled Bioses such as /// +/// Repackinator will extract Certs, Title ID & Title Image (.tbn) from the /// +/// XBE located inside the ISO Dump. It will then generate a Default.XBE /// +/// which will be used to load the ISO Games on ISO Enabled Bioses such as /// /// Cerbios (Native Iso Support) , IND-Bios (Patched) , EVOX (Patched) /// /// /// /// The generated Default.XBE will use the XBE Title Column as the New /// @@ -97,12 +116,13 @@ /// favorite dashboard. /// /// /// /// Please note that the region shown in Repackinator is calculated based /// -/// on the Region that is extracted from the Games XBE. These regions are /// -/// GLO = (GLOBAL) USA,PAL,JAP /// -/// JAP = (JAPAN/ASIA) JAP /// +/// 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-JAP = (USA,JAPAN/ASIA) USA,JAP /// +/// USA-JPN = (USA,Japan/Asia) USA,JPN /// /// USA-PAL = (USA,Europe/Australia) USA,PAL /// /// /// /// /// @@ -112,12 +132,25 @@ /// Install Notes /// /// ----------------------------------------------------------------------- /// /// /// -/// Run Repackinator.exe. /// +/// Repackinator consists of two executables: /// +/// - Repackinator.exe (GUI application) /// +/// - repackinator.shell.exe (Command-line interface) /// +/// /// +/// GUI Usage: /// +/// Run Repackinator.exe. /// /// Select Grouping Type. /// -/// Set Input Folder. (Path to your Redump .ZIP/.7Z or .ISO) Files /// +/// Set Input Folder. (Path to your Redump .ZIP/.7Z/.RAR/.CCI or .ISO) /// /// Set Output Path. (Path to where you want to save your processed game) /// /// Click On Process, Sit back while Repackinator does the hard work for you /// /// /// +/// CLI Usage: /// +/// Run repackinator.shell.exe -h to view all available actions. /// +/// Run repackinator.shell.exe -a= -h for action-specific help. /// +/// /// +/// Context Menu (Windows): /// +/// Run repackinator.shell.exe -a=register as admin to enable context menu. /// +/// The application will automatically prompt for elevation if needed. /// +/// /// /// /// /// /// //////////////// ////////////////