Getting started

Download OpenRAGE and set up your game in a few minutes.

Documentation · Getting started

Download a release

Ready-made builds for Linux (x86-64, glibc 2.35 or newer) and Windows (x86-64) are on the releases page.

Linux (.tar.gz) Windows (.zip)

Linux

Unpack the archive and start the GUI, or openrage for the command line. The archive also holds openrage.desktop and openrage.png for a menu entry. Newer releases also come as an AppImage: make it executable and start it.

From 0.5 there is also a Flatpak (openrage-*-x86_64.flatpak). It installs a menu entry, and OpenRAGE plugins (.orp) and OpenIV packages (.oiv) then open in OpenRAGE with a double-click. It keeps its settings apart from the other downloads, in ~/.var/app/io.github.Two_Play.OpenRAGE. The command line runs with flatpak run --command=openrage io.github.Two_Play.OpenRAGE.

flatpak install --user openrage-*-x86_64.flatpak
tar -xzf openrage-*-linux-x86_64.tar.gz
cd openrage-*-linux-x86_64
./openrage-gui

To check the download, put SHA256SUMS.txt next to it:

sha256sum --check --ignore-missing SHA256SUMS.txt

Windows

Unzip the archive (right-click → Extract All…) and start openrage-gui.exe; openrage.exe is the command line. The program is not signed yet, so Windows SmartScreen may ask first: More info → Run anyway.

To check the download, compare its hash in PowerShell with the line in SHA256SUMS.txt:

Get-FileHash .\openrage-*-windows-x86_64.zip -Algorithm SHA256

Set up your game

GTA V

On first start, OpenRAGE opens a setup dialog. It finds your Steam installation and takes the archive keys from your own copy of the game: check the game folder and click Derive keys. For GTA V Legacy that is all.

  • GTA V Enhanced (GTA5_Enhanced.exe) no longer stores all keys in the executable. In the setup dialog, choose a CodeWalker key blob (magic.dat) you obtained yourself under Key blob. It is decrypted with the key from your executable and checked against common.rpf before it is used.
  • The keys are cached once, at ~/.config/openrage/gtav.keys (Linux) or %APPDATA%\openrage\gtav.keys (Windows), and the game folder is remembered. To add or switch games later: File → Switch game…

Never share the key cache. It contains keys taken from your copy of the game.

GTA IV

Choose the GTA IV folder in the same setup dialog; the key is taken from your GTAIV.exe in under a second. More on the GTA IV page.

Red Dead Redemption 2

RDR2's keys come from your running game and are set up on the command line, in three steps. See Red Dead Redemption 2.

Coming from OpenIV

Nothing to migrate: OpenRAGE works with what you already have.

  • Your mods folder stays as it is. OpenRAGE reads it the way OpenIV.asi does, marks modded files, and writes its own edits there too. Toggle Mods in the toolbar to see what your mods change.
  • .oiv packages install as in OpenIV (format 2.x), but you see every change before it is written, and you can uninstall a package later from History.
  • Same output: DDS textures, WAV audio and .oxt game text match OpenIV's exports.
  • Same safety: OpenRAGE starts read-only; Read-only → Editing unlocks changes, like OpenIV's edit mode.
  • New: undo for every change, search across the whole game, Linux, GTA V Enhanced and RDR2.
  • Model import is a preview: OBJ models replace GTA V Enhanced props and vehicle bodies (how). For other kinds of models keep OpenIV; both tools share the same mods folder.

Next steps

I want to …Read
find my way around and search the gameExplorer and search
see what each file format showsViewing files
change files and install .oiv packagesModding
use a terminal or scriptsCommand line
build OpenRAGE myselfBuild from source

Found a bug or missing a format? Open an issue.