filediver

module

v0.7.14 Latest Latest Go to latest Published: Feb 5, 2026 License: BSD-3-Clause

README ¶

Filediver

An unofficial Helldivers 2 game asset extractor.

Download

Filediver GUI (graphical interface with preview)

GUI Screenshot

Simply download and run. It's highly recommended to install all extensions when prompted.

Manually installing extensions

Do this if auto-download doesn't work for some reason. BE WARNED THAT IT'S A LOT MORE INVOLVED.

In file expolorer, paste %LOCALAPPDATA%\filediver into the directory bar to open the extension folder; all future instructions saying to "create a file/folder" will imply to do it in there
Make sure to have file extensions enabled in file explorer
Make two folders, called ffmpeg and filediver-scripts
FFmpeg
- Download https://github.com/BtbN/FFmpeg-Builds/releases/download/latest/ffmpeg-master-latest-win64-gpl.zip
- Place the bin folder in ffmpeg-master-latest-win64-gpl.zip/ffmpeg-master-latest-win64-gpl into the ffmpeg directory you just created
- Create a new text file called ffmpeg_version (NO EXTENSION). Edit the file with notepad, type in the text latest and hit save.
Helper scripts
- Download scripts_dist
- Place the hd2_accurate_blender_importer folder in scripts-dist-windows.zip/scripts_dist into the filediver-scripts directory you just created
- Create a new text file called filediver-scripts_version (NO EXTENSION). Edit the file with notepad, type in the latest version of filediver (e.g. v0.6.15) and hit save.

Filediver CLI (command-line interface)

Extract the archive. This will create a folder named filediver, where everything relevant is located.

The program is called "filediver.exe" (or just "filediver" on Linux). See usage.

Helper scripts (scripts_dist)

CLI Only: Extract the helper scripts achive into the filediver folder (the same folder containing the executable, e.g. filediver.exe).

Export features

Video to bink/mp4
Audio to ogg/aac/wav
Images/textures to png
3D models to gltf/blender (with bones, textures and animations [needs flag])
Prefabs
Text tables to JSON
...and more

Usage

See the Wiki

CLI Basics

Links

HD 2 Archive Labelling (IDs can be used with -t option)
Helldivers Archive Discord server

Credits

This app builds on a lot of work from other people. This includes:

Hellextractor by Xaymar
- Basic binary file structure
- Unhashed resource names/types (.txt files)
vgmstream, ww2ogg by hcs and bnkextr by eXpl0it3r
- Wwise audio formats
ImageMagick
- DDS texture decoding
Accurate HD2 Shader by Thejudsub on the Helldivers Archive Discord server
- The most accurate Blender material replicating the game's procedural shaders

Hacking

Running

go run ./cmd/filediver-cli / go run ./cmd/filediver-gui

Setup blender importer for development

uv venv --python 3.11
uv pip install -r scripts/requirements.txt
set FILEDIVER_BLENDER_IMPORTER_COMMAND=uv run scripts/hd2_accurate_blender_importer.py (CMD) or $env:FILEDIVER_BLENDER_IMPORTER_COMMAND="uv run scripts/hd2_accurate_blender_importer.py" (PowerShell)

License

Copyright (c) filediver contributors

FileDiver is licensed under the 3-Clause BSD License (https://opensource.org/license/bsd-3-clause).

Directories ¶

Path	Synopsis
app
appconfig
bitio Implements LSb-First reader and writer for reading/writing arbitrary bit width integers from/to normal go byte streams.	Implements LSb-First reader and writer for reading/writing arbitrary bit width integers from/to normal go byte streams.
cmd
filediver-cli command
filediver-gui command
filediver-gui/fonts
filediver-gui/fonts/generate command
filediver-gui/getter Getter downloads assets from GitHub releases.	Getter downloads assets from GitHub releases.
filediver-gui/glutils
filediver-gui/imgui_wrapper Package imgui_wrapper provides a basic framework for an IMGui app.	Package imgui_wrapper provides a basic framework for an IMGui app.
filediver-gui/imutils ImGui utilities.	ImGui utilities.
filediver-gui/ioutils
filediver-gui/textutils
filediver-gui/widgets
filediver-gui/widgets/previews
tools/animation-event-dumper command
tools/animation-name-dumper command
tools/animation-variable-dumper command
tools/components/arc-setting-json-dumper command
tools/components/armor-set-json-dumper command
tools/components/beam-setting-json-dumper command
tools/components/beam-weapon-json-dumper command
tools/components/damage-setting-json-dumper command
tools/components/entity-component-settings-json-dumper command
tools/components/entity-component-settings-name-dumper command
tools/components/entity-delta-json-dumper command
tools/components/environment-setting-json-dumper command
tools/components/explosion-setting-json-dumper command
tools/components/health-json-dumper command
tools/components/passive-bonus-json-dumper command
tools/components/projectile-setting-json-dumper command
tools/components/projectile-weapon-json-dumper command
tools/components/typelib-json-dumper command
tools/components/typelib-string-dumper command
tools/components/typelib-unknown-hash-dumper command
tools/components/unit-customization-json-dumper command
tools/components/visibility-mask-json-dumper command
tools/components/visibility-mask-name-dumper command
tools/components/weapon-customization-component-json-dumper command
tools/components/weapon-customization-json-dumper command
tools/crossref-checker command
tools/hash-tool command
tools/hd2grep command
tools/lookup-hash command
tools/material-resource-name-dumper command
tools/physics-name-dumper command
tools/state-machine-event-state-dumper command
tools/state-machine-state-dumper command
tools/strings-language-dumper command
config
datalibrary
enum
generate command
dds
exec
extractor
ah_bin
animation
bik
blend_helper
bones
geometry
geometry_group
material
package
physics
prefab
single_glb_helper
state_machine
strings
texture
unit
wwise
hashes
generate/combine command
generate/wwise_streams command
steampath
stingray
ah_bin
animation
bones
package
physics
prefab
state_machine
strings
unit
unit/geometry_group
unit/material
unit/material/d3d
unit/material/d3d/opcodes
unit/texture
wwise
util
wwise The following is mostly manually converted from vgmstream (https://github.com/vgmstream/vgmstream)	The following is mostly manually converted from vgmstream (https://github.com/vgmstream/vgmstream)
vorbis The following is manually converted from ww2ogg by hcs (https://github.com/hcs64/ww2ogg)	The following is manually converted from ww2ogg by hcs (https://github.com/hcs64/ww2ogg)

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL