Explorer and search

Find your way around the game: browse archives like folders and search everything at once.

Documentation · Explorer and search

New here? Start with Getting started. Prefer a terminal? See the command line.

Starting

Start openrage-gui, or openrage-gui <virtual path> to open a folder or file directly. With several games set up, OpenRAGE first shows a small window that asks which one to open (unless one is ticked as Always open this game); the explorer opens with the game chosen there. File → Switch game… changes the game later.

The window

Folder tree and file list

  • The folder tree shows the game folder. Archives, including archives inside archives, open like folders.
  • The file list is sortable and shows a format icon for each file (textures, models, maps, data, audio, scripts …).
  • Files that contain other files (texture dictionaries, audio containers) carry a badge on their icon.
  • The address bar has clickable breadcrumbs. Click the free space (or press Ctrl+L) to type a path.
  • Views: the buttons above the list (or View → List, Icons, Large icons; Ctrl+1, Ctrl+2, Ctrl+3) show the files as a list with columns or as icons. In the icon views the arrow keys move left, right, up and down.
  • Filter: the funnel button above the list (Ctrl+Shift+F) opens a field that narrows the list to names containing the text; Esc clears and closes it.
  • Text size: View → Text size (or Settings → Appearance) makes text, list rows and icons smaller or larger, in every window.

Preview and info panel

  • Selecting a file shows it in the preview: text in a fixed-width font, images, 3D models, sounds, or a hex dump.
  • The info panel lists the file's details: type, size, version, format, mip levels, meshes, triangles …
  • A texture dictionary previews up to 16 of its textures at once; a drawable dictionary shows all its objects side by side.

Viewer windows

  • Double-click opens folders, archives and texture dictionaries.
  • Models and textures open in their own viewer window (also Ctrl+Enter). Several can be open at once, for example to compare models.
  • XML files open in the XML window, whether they are text (.xml, .meta, XML in a .dat, …) or binary metadata (.ymt, .ymap, …): a tree of the structures, named by their name field (e.g. CHandlingData #2 · ADDER), the values of the selected one, and the XML with syntax colours. Edit as text opens a text file in the editor.
  • Other text files (.dat, .ini, .ide, …) open in the text editor; right-click → Edit opens XML there directly. Right-click → Open with system app opens a read-only copy in your default program.

What each format looks like is described in Viewing files.

Extracting

Extract… saves files, folders or whole archives. It runs in the background, can be cancelled, and its output matches OpenIV's.

Every action is in the menu bar (File, Edit, View, Go, Help) with its shortcut. Right-click a file for the actions that apply to it: open, view, extract, export, replace, rename, delete, copy name or path.

The other windows have right-click menus too:

  • XML window: on a tree entry, expand or collapse, copy its name, its values or its XML, or Show in XML (jumps to its line); on a value, copy the value or the name; on an XML line, copy the line or the whole XML.
  • Viewer: reset the view, look from the front, side or above, switch to the fly camera, export glTF (models) or save PNG (textures), show or hide the details, copy the path, close.
  • Text editor: cut, copy, paste, select all, save, reload, unlock editing, wrap lines, show tabs, copy the path.
KeysAction
Arrow keys, Page Up/Down, Home/EndMove in the list
EnterOpen
Backspace or Alt+UpUp one folder
Ctrl+LType a path
Ctrl+FSearch
Ctrl+Shift+FFilter the list
Ctrl+1 / Ctrl+2 / Ctrl+3List / icons / large icons
F2 / DeleteRename / delete (in edit mode)
Ctrl+ZUndo
F1All keyboard shortcuts

The magnifier in the toolbar (or Ctrl+F) opens the search field; Enter searches, Esc folds it away again.

OpenRAGE keeps a search index of the whole game. It is built once in about 30 seconds; after a game update only the archives that changed are read again.

What you can search for

TypeExampleFinds
Namesadderany part of a file or folder name, exact matches first
Hashes0xB779A091, B779A091, 3078201489, -1216765807the name behind the hash (adder), files with that name hash and game text with that label hash
Textweapon pistolwords in XML/META/DAT/UGC files, audio name tables and game text; all words must occur

Game text is filtered to one language, by default your system language.

From the address bar

Typing ?query into the address bar searches as well; Back returns to the results.

Settings

Settings (gear button, File → Settings… or Ctrl+,) has four tabs:

  • Appearance: the theme (light, dark or system), the accent colour (a preset or any colour of your own), the text size and the file view;
  • Game: Switch game…, Add or change a game… and whether to ask at start;
  • Behaviour: whether the history opens in its own window and whether the mods overlay is shown;
  • Plugins (also Tools → Plugins…): installing, which are on, their permissions, the plugin folder; see plugins.

The sun/moon button in the toolbar switches the theme quickly.

Plugins

Plugins add previews and actions for file types OpenRAGE does not handle itself. They are WebAssembly programs that run in a sandbox: a plugin sees only the files you open with it and, if you allow it, reads the game's files. It cannot change anything, open other files or go online.

  • Install: Settings → Plugins → Install plugin… installs a plugin package (.orp); opening an .orp with OpenRAGE (a double-click, once OpenRAGE is the file manager's app for it; the Flatpak sets that up) does the same. You first see what the plugin is, what it may do and its SHA-256 checksum (compare it with the one the author publishes). Uninstall removes it again. A plugin folder also works: put it into your plugin folder (~/.config/openrage/plugins on Linux, %APPDATA%\openrage\plugins on Windows, or plugins next to the program); Open plugin folder opens it, Reload plugins picks up new ones. The download comes with four example plugins: Strings (shows and exports the readable text of any file), Text patch (applies an OpenIV .oxt file to a .gxt2) and OBJ tools (exports models as OBJ with their textures, shows .obj files in 3D, replaces props and vehicle bodies with an OBJ) and Hex tools (a number and RAGE hash converter in the Tools menu, and hex dumps of any file).
  • Enable: Settings → Plugins lists each plugin with what it does, its licence and the permissions it asks for. New plugins are off; turning one on grants what it asks for. A new version that asks for more is off again until you confirm. Plugins that cannot be loaded are listed with the reason.
  • File list: plugins name the file types they add and give them an icon.
  • Preview: files OpenRAGE has no viewer for are shown by a plugin (text, tree, table, picture or a 3D model in the model view, with Open viewer and Export glTF…). The info panel names the plugin and shows its messages and errors. A plugin for every type (like Strings) only gets binary files.
  • Context menu: plugin entries such as Export strings…. One result is saved with a save dialog, several into a folder you pick. Some actions also work on whole folders and archives (progress in the status bar, Cancel stops), and some ask for a file first, like the patch for Apply text patch….
  • Changing files: plugins with the write-mods permission can change game files. That only works while editing is unlocked; the changes go into the mods folder, never into the game's own files, and each run is one entry in History that you can undo.
  • Tools: some plugins add a small window of their own to the Tools menu, such as Hex tools' number converter: fill in the fields and the result follows as you type; Copy result copies it.
  • Command line: everything also works with openrage plugin.

Want to write one? See Writing plugins.

About and licenses

Help → About OpenRAGE shows the version, OpenRAGE's license (GPL-3.0, and AGPL-3.0 for the TFIT2 cipher), a link to the source code, the credits, and every third-party crate with its license. The same list is on the licenses page.