vgmstream - A library for playback of various streamed audio formats used in video games.
This is vgmstream, a library for playing streamed (prerecorded) video game audio.
Some of vgmstream's features:
The main development repository: https://github.com/vgmstream/vgmstream/
Automated builds with the latest changes: https://vgmstream.org (https://github.com/vgmstream/vgmstream-releases/releases/tag/nightly)
Common releases: https://github.com/vgmstream/vgmstream/releases
Help can be found here: https://www.hcs64.com/
More documentation: https://github.com/vgmstream/vgmstream/tree/master/doc
There are multiple end-user components:
The main library (plain vgmstream) is the code that handles the internal conversion, while the above components are what you use to get sound.
If you want to convert game audio to .wav
, try getting vgmstream-cli (see below) then
drag-and-drop one or more files to the executable (support may vary per O.S. or distro).
This should create (file.extension).wav
, if the format is supported. More user-friendly
would be installing a player like foobar2000 (for Windows) or Audacious (for Linux)
and the vgmstream plugin. Then you can directly listen your files and set options like infinite
looping, or convert to .wav
with the player's options (also easier if your file has multiple
"subsongs").
See components in the usage guide for full install instructions and explanations. The aim is feature parity, but there are a few differences between them due to missing parts on vgmstream's side or lack of support in the player.
Note that vgmstream cannot encode (convert from .wav
to a video game format), it only decodes
(plays game audio).
Get the latest prebuilt binaries (CLI/plugins/etc) on our website:
Or the less frequent "official" releases on GitHub:
The foobar2000 component is also available on https://www.foobar2000.org based on current release.
If the above links fail, you may also try the alternative versions built by bnnm:
You may compile from source as well, see the build guide.
A prebuilt CLI binary is available. It's statically linked and should work on systems running Linux kernel v3.2 and above:
Building from source will also give you vgmstream.so (Audacious plugin), and vgmstream123 (command-line player).
When building, many extra components have to be installed or compiled separately, which the
build guide describes in detail. For a quick build on Debian and Ubuntu-style
distributions run ./make-build-cmake.sh
. The script will need to install various dependencies,
so you may prefer to copy commands and run them manually.
A prebuilt CLI binary is available as well:
Otherwise follow the build guide.
Enjoy! hcs