Skip to content

README.md

Latest commit

 

History

History
91 lines (58 loc) · 2.91 KB

README.md

File metadata and controls

91 lines (58 loc) · 2.91 KB
Raw

GOD360 Renamer — Xbox 360 Title ID Renamer

Renames Xbox 360 game folders on the HDD from their Title ID format to the actual game name, and allows reverting it. Ships as a desktop app for Windows, macOS, and Linux — no Python or dependencies required.

4D5307D5  →  Gears of War [4D5307D5]
4D5307E6  →  Halo 3 [4D5307E6]
4B4E085E  →  Metal Gear Solid V (Disc 2) [4B4E085E]

Download

Grab the latest build for your OS from the Releases page:

OS File
Windows GOD360Renamer-windows.exe
macOS GOD360Renamer-macos.zip (unzip, then open GOD360Renamer.app)
Linux GOD360Renamer-linux (make it executable: chmod +x GOD360Renamer-linux)

No installation needed — just download and run.

macOS may show an "unidentified developer" warning since the app isn't notarized. Right-click the app and choose Open to bypass it.

Files

File Description
god360_renamer.py Main script / app source
xbox360_gamelist.csv Game database (IronRingX)

Usage

Open the app. It has two tabs:

Search

Look up a game by partial name or by exact Title ID.

Rename Folders

  1. Click Browse... and select the folder containing the Title ID folders (e.g. your HDD's Content\0000000000000000 directory).
  2. Choose the direction:
    • Title ID → Game Name [Title ID] — renames to a readable name.
    • Game Name [Title ID] → Title ID — reverts to the original Title ID.
  3. Click Rename Folders.

The log at the bottom shows every folder renamed, plus a summary of how many were renamed and which Title IDs had no match in the database.

Notes

  • Names are automatically trimmed to 42 characters (FATX filesystem limit). Trailing parentheses like (Disc 2) are preserved when trimming.
  • The Title ID is always kept at the end in brackets [XXXXXXXX] so the rename can be reverted.
  • Folders that don't have exactly 8 hexadecimal characters are ignored.

Running from source

Requires Python 3.x (tkinter included). xbox360_gamelist.csv must be in the same folder as god360_renamer.py.

python god360_renamer.py

Building the executables yourself

Executables for all three platforms are built automatically by the build GitHub Actions workflow on every push to main and on tagged releases (v*). To build locally:

pip install pyinstaller
pyinstaller --onefile --windowed --name GOD360Renamer --add-data "xbox360_gamelist.csv;." god360_renamer.py   # Windows
pyinstaller --windowed --name GOD360Renamer --add-data "xbox360_gamelist.csv:." god360_renamer.py              # macOS
pyinstaller --onefile --name GOD360Renamer --add-data "xbox360_gamelist.csv:." god360_renamer.py               # Linux

Credits

Based on GODRenamer by mansonss.

Modified by Yirr777.