ZeroIV User Guide
ZeroIV is a manager for browsing and editing RPF files in GTA V. You can open the game folder or a single RPF file, preview models, textures and XML, and edit resources inside the app itself.
This software has no connection to Rockstar Games. Back up your game files before changing anything.
Requirements
| Platform | Requirements |
|---|---|
| Windows | Windows 10/11 x64; WebView2 (usually preinstalled) |
| Linux | x86_64; WebKitGTK 4.1 and GTK 3 (pulled in by deb/rpm) |
Optional: environment maps (HDRI) download automatically on the first model preview and are cached in the user profile; you can also place your own under assets/ next to the app.
Install
Windows
- Extract the release zip (e.g.
ZeroIV-*-windows-amd64.zip). - Run
ZeroIV.exe. - Optionally create a
keys/folder beside the exe and addgtav_aes_key.dat(see below).
Linux (deb / rpm)
# Fedora / RHEL-like
sudo dnf install ./zeroiv-*-*.rpm
# Debian / Ubuntu-like
sudo apt install ./zeroiv_*_*.deb
After install, launch ZeroIV from the app menu, or run:
zeroiv
Linux (portable)
Extract ZeroIV-*-linux-amd64.tar.gz and run the ZeroIV binary inside.
Quick start
- Start ZeroIV and complete the language / appearance welcome wizard (changeable later in Settings).
- From the top bar, choose:
- Open folder — any directory that contains
.rpffiles (game root not required); or - Open RPF archive — a single
.rpffile.
- Open folder — any directory that contains
- If the top bar shows No keys, open Settings → Encryption keys before reading encrypted archives.
- The app starts read-only. Enable Edit mode in the top bar before saving, importing, or deleting.
UI overview
| Area | Purpose |
|---|---|
| Top bar | Open / workspace, edit mode, settings, about |
| Left project tree | Workspace, folders, .rpf files, and folders inside archives (including nested RPFs) |
| Right list | Files and folders under the current node; search, sort, drag-out |
| Preview / editor | Textures, models, XML, text, hex, and more |
Common tasks
Browse and search
- Click a tree node to browse it on the right; use breadcrumbs, up, back, and forward.
- The search box searches the current folder recursively, including nested archives. Double-click a hit to open it, or click the location column to jump there.
- The right-click menu copies a file name or its full disk path (RPF containers count as folders, one line per item for a multi-selection).
Textures (.ytd)
- Double-click to open the texture grid; filter and inspect size / mip / format metadata.
- Double-click a texture for fullscreen preview (wheel zoom, pan, ←/→, Esc).
- Export one, selected, or all textures as DDS or PNG; switch to the XML view anytime.
- Import (edit mode): png / jpg / bmp / dds.
.ddsis stored as-is; other formats can target DXT1 / DXT5 / BC7 / etc., with mipmap options. Same-name textures are replaced in place.
Models (.ydr / .ydd / .yft)
- Double-click for the built-in 3D viewer; right-click for XML.
- Attach on-disk
.ytdfiles, change display modes, vehicle lights, and paint / liveries. - Vehicle fragments with a companion
.ycd(e.g.sentinel2_hi.yft+va_sentinel2.ycd) get an Animation panel: play / reverse / scrub convertible roof, door and boot clips. The dictionary is picked up automatically from the same folder. - HDRIs in a sibling
assets/folder are picked up automatically when present.
Other resources and XML
- Types such as
.ymap/.ytyp/.ymt/.ybn/.ycd/.yptopen as XML and can be saved back (edit mode). - Export any resource to
.xml, or import XML and repack to the matching resource type. - Text files are editable; plain
.meta/.xmlget syntax highlighting; binaries get a hex view.
RPF writes (edit mode)
- Create RPF (OPEN / NONE / AES / NG), create folders, import, rename, delete.
- Right-click an RPF to defragment it (edit mode required).
- Renaming or deleting an RPF closes the archive first, then touches the
.rpfon disk. - With edit mode off, all write operations stay disabled.
Drag-out and OS integration
- Drag files from the right list to the desktop or a file manager.
- Right-click a tree node to reveal it in the system file manager.
Settings
Configure:
- Language, dark / light / system theme, accent color
- Whether to enter edit mode on launch
- Whether to remember and restore previously opened folders
- GTA V install folder (version detection and key extraction)
- Encryption key management
- Gen9 / Enhanced resource layout
Encryption keys
AES / NG encrypted archives need an AES key file (commonly gtav_aes_key.dat).
Lookup order
./keys/under the current working directorykeys/next to the executable- The last directory that successfully loaded keys
Manual load
Settings → Encryption keys → Manage keys:
- Pick a folder that contains
gtav_aes_key.dat; or - Pick
GTA5.exe/GTA5_Enhanced.exeand let ZeroIV try to extract keys.
FAQ
Encrypted .rpf will not open / “No keys”
Set the correct GTA 5 install folder first. ZeroIV scans the game executable for the encryption key, and only then can it decrypt RPF files.
I cannot save or import; buttons are disabled
The app is read-only by default. Turn on Edit mode in the top bar (the button turns yellow when active).
Enhanced / Gen9 resources look wrong
Enable Gen9 / Enhanced resource layout in Settings, then reopen the folder or archive.
Model preview has no environment lighting
Environment maps download automatically on the first preview and are cached in %LocalAppData%\ZeroIV\envmaps. Offline, put .hdr / .exr / .hdri files in an assets/ folder next to the binary (system install path: /usr/lib/zeroiv/assets/).
Drag-and-drop fails on Linux file managers
For multi-select drag-out, ZeroIV exports a temporary folder instead (WebKitGTK mishandles multi-line file:// lists). Drag one file at a time, or export then copy.
Game breaks after editing an encrypted archive
Writes modify the original file. Back up first. The first NG write can be slow while encryption tables are generated.
Known limitations
.ymf/.psosupport XML export only (no import yet).- When importing texture XML for a
.ytd, DDS files are read from a same-named folder beside the XML (e.g.adder.ytd.xml→adder/). - Large entries inside archives are extracted to a cache on first drag-out, so the drop target may appear slightly later.
- Shared vehicle textures (
vehshare*, etc.) are indexed only when the workspace is a game install that containsGTA5*.exe.