Homebrew and USB

Homebrew and USB

This page covers the rgh homebrew install workflow in XeCLI.

For the separate Original Xbox compatibility workflow that targets HddX:\Compatibility, use Original Xbox Compatibility.

Use it when you want to:

• stage Aurora, DashLaunch, XeXMenu, Freestyle Dash, XM360, TimeFixer, Simple 360 NAND Flasher, or XellLaunch onto a USB drive or folder
• install those packages directly onto Hdd1, Usb0, Usb1, or Usb2 on the console
• keep Original Xbox compatibility separate from normal dashboard/homebrew staging so HddX:\Compatibility installs are handled through rgh ogxbox install ...
• prepare a clean homebrew layout without manually hunting archives
• copy user-supplied console plugin files from ConsoleDependencies\ when you choose to provide them

Package Mode

XeCLI now exposes package staging through the homebrew command group:

rgh homebrew list
rgh homebrew install aurora --usb E:\XeCLI-Stage
rgh homebrew install aurora --device Hdd1 --ini-mode merge
rgh homebrew install all --device Hdd1 --ini-mode generated
rgh homebrew install dashlaunch --usb E:\XeCLI-Stage
rgh homebrew install xexmenu --usb E:\XeCLI-Stage
rgh homebrew install fsd --usb E:\XeCLI-Stage
rgh homebrew install xm360 --usb E:\XeCLI-Stage
rgh homebrew install timefixer --usb E:\XeCLI-Stage
rgh homebrew install simple360 --usb E:\XeCLI-Stage
rgh homebrew install xelllaunch --usb E:\XeCLI-Stage
rgh homebrew install all --usb E:\XeCLI-Stage

If you are still in the extracted release folder and rgh is not registered yet, use:

.\rgh.exe homebrew install aurora --usb E:\XeCLI-Stage

Supported package IDs:

• aurora
• dashlaunch
• xexmenu
• fsd
• xm360
• timefixer
• simple360
• xelllaunch
• all

Target Selection

USB or folder staging

Use --usb when you want a host-side staging target.

--usb accepts:

• a drive letter like E:
• a drive root like E:\
• a removable-drive selection number from the prompt
• a normal folder path for staging

Examples:

rgh homebrew install aurora --usb E:\XeCLI-Stage
rgh homebrew install all --usb F:\XeCLI-Stage
rgh homebrew install dashlaunch --usb E:\Builds\UsbStage
rgh homebrew install xm360 --usb E:\XeCLI-Stage
rgh homebrew install timefixer --usb E:\XeCLI-Stage
rgh homebrew install simple360 --usb E:\XeCLI-Stage
rgh homebrew install xelllaunch --usb E:\XeCLI-Stage

Use a dedicated, empty staging folder instead of a drive root. Local staging merges into existing package folders, replaces files with matching paths, and leaves unrelated files in place; it does not clean the target first.

Direct console install

If you omit --usb, XeCLI switches into direct console install mode.

It connects to the console over FTP, checks only these supported install roots:

• Hdd1
• Usb0
• Usb1
• Usb2

It does not offer System, SysExt, HddX, or other system roots in this workflow.

If more than one supported install root is present, XeCLI asks which one to use. You can also pass it explicitly:

rgh homebrew install aurora --device Hdd1
rgh homebrew install all --device Usb0 --ini-mode skip

Use --device only with direct console install. Do not combine it with --usb.

Download and Cache Behavior

In installed mode, XeCLI downloads package archives into the default local cache:

• %LOCALAPPDATA%\XeCLI\cache\packages\archives

Portable mode uses UserData\cache\packages\archives beside the executables. XECLI_HOME places the cache under the directory it names, and --cache <DIR> overrides all of these defaults for the current command.

It then extracts them into a staging area, copies the payload into the selected USB/folder target or onto the console, and reuses cached archives on later installs.

Useful flags:

rgh homebrew install aurora --usb E:\XeCLI-Stage --force-download
rgh homebrew install all --usb E:\XeCLI-Stage --cache D:\XeCLI-Cache

• --force-download ignores the cached archive and fetches it again
• --cache <DIR> moves both the archive cache and staging root to a different location
• --auto-confirm skips the confirmation step before package install

Confirmation Behavior

XeCLI asks before staging or installing a package unless --auto-confirm is supplied. In a non-interactive context, the command refuses to continue unless that bypass is explicitly provided.

What XeCLI Places on the Target

For each selected package, XeCLI creates or reuses its package folder on the target:

• Aurora\
• DashLaunch\
• XeXMenu\
• FreestyleDash\

If a ConsoleDependencies\ folder exists beside rgh.exe, XeCLI also copies those user-supplied console-side plugin files into:

• Plugins\

When you choose generated launch.ini mode, XeCLI also writes:

• launch.ini

The generated launch.ini sets Aurora as the default path. Plugin entries are added only when user-supplied console plugins were copied into Plugins\.

For local USB or folder staging, XeCLI writes launch.ini when Aurora is selected or already present in the staging folder. An existing launch.ini at that path is replaced. Local staging does not use --ini-mode.

For direct console installs, existing package files are not silently overwritten; a destination conflict stops the upload. Use a clean install location or move the previous package folder before reinstalling.

Direct console install uses these console paths:

• /<Device>/Aurora
• /<Device>/DashLaunch
• /<Device>/XeXMenu
• /<Device>/FreestyleDash
• /<Device>/Plugins when user-supplied ConsoleDependencies\ files are present

Default launch.ini path for console installs:

• /Hdd1/launch.ini

Override it with:

rgh homebrew install dashlaunch --device Hdd1 --ini /Hdd1/launch.dev.ini --ini-mode merge

launch.ini Modes

Direct console install supports three launch.ini modes:

• generated
  • create a fresh XeCLI launch.ini
  • useful when you want Aurora as a clean baseline
  • include plugin entries only when user-supplied console plugins are present
  • preserve an existing file as launch.ini.bak before replacing it
• merge
  • keep existing settings and other lines
  • add or update plugin entries only when user-supplied console plugins are present
  • leave the file unchanged when no user-supplied plugins are present
  • preserve the previous file as launch.ini.bak before writing merged plugin entries
• skip
  • install only the homebrew files and any user-supplied plugins
  • leave launch.ini untouched

Example Output

rgh homebrew install all --usb E:\XeCLI-Stage
Extracting Aurora 0.7b.2...
Extracting DashLaunch 3.21...
Download XeXMenu 1.2 downloading: 55%
Extracting XeXMenu 1.2...
Extracting Freestyle Dash 3...
Extracting XM360...
Extracting TimeFixer...
Extracting Simple 360 NAND Flasher...
Extracting XellLaunch...
SUCCESS Homebrew install complete
8 package(s) 326 MB -> E:\XeCLI-Stage

The displayed total depends on the package versions and downloaded archive contents.

rgh homebrew install dashlaunch --device Hdd1 --ini-mode merge
Extracting DashLaunch 3.21...
SUCCESS Console homebrew install complete
1 package(s) 2.52 MB -> Hdd1 on <console-ip>

Package            Console Path       Files   Size
DashLaunch 3.21    /Hdd1/DashLaunch   8       2.52 MB

User-supplied plugins copied to /Hdd1/Plugins
Updated existing launch.ini plugin entries /Hdd1/launch.ini
Backup written to /Hdd1/launch.ini.bak

Package Sources

The current build uses these public sources:

• Aurora 0.7b.2
  • https://phoenix.xboxunity.net/downloads/Aurora%200.7b.2%20-%20Release%20Package.rar
  • mirror: https://consolemods.org/wiki/images/d/dd/Aurora_0.7b.2_-_Release_Package.rar
• DashLaunch 3.21
  • https://consolemods.org/wiki/File:DashLaunch_v3.21.7z
• XeXMenu 1.2
  • https://consolemods.org/wiki/images/5/5c/XeXmenu_1.2.7z
• Freestyle Dash 3
  • https://consolemods.org/wiki/images/a/a0/Fsd3.zip
  • fallback: https://consolemods.org/wiki/images/7/76/TeamFSD.Freestyle3.0.775.7z
• XM360
  • https://consolemods.org/wiki/images/5/5f/XM360.7z
  • https://consolemods.org/wiki/File:XM360.7z
• TimeFixer
  • https://github.com/DerfJagged/TimeFixer/releases/download/v1/TimeFixer_by_Derf.zip
• Simple 360 NAND Flasher
  • https://consolemods.org/wiki/images/f/ff/Simple_360_NAND_Flasher.7z
  • https://consolemods.org/wiki/File:Simple_360_NAND_Flasher.7z
• XellLaunch
  • https://consolemods.org/wiki/images/4/41/XellLaunch.7z
  • https://consolemods.org/wiki/File:XellLaunch.7z

XeCLI resolves MediaWiki file pages to the raw archive automatically when a page URL is provided instead of a direct file URL.

Notes

• the Windows setup executable is the XeCLI installer
• rgh homebrew install ... is the package workflow for both local staging and direct console install
• rgh ogxbox install ... is the Original Xbox compatibility workflow for XeFu packs and the optional HDD Compatibility Partition Fixer
• use --usb for local staging
• omit --usb for direct console install
• direct console install only targets Hdd1, Usb0, Usb1, or Usb2
• interactive installs prompt for confirmation; non-interactive installs are refused unless confirmation is explicitly bypassed