vgmstream - A library for playback of various streamed audio formats used in video games.
Go to file
2024-09-22 11:01:25 +02:00
.github doc 2024-08-10 23:46:26 +02:00
audacious cleanup: misc doc/fixes 2024-07-14 20:24:53 +02:00
cli cleanup: misc 2024-08-27 17:27:52 +02:00
cmake cleanup: remove jansson dependency 2024-07-28 18:40:05 +02:00
doc doc 2024-09-08 21:07:48 +02:00
ext_includes cleanup: remove jansson dependency 2024-07-28 18:40:05 +02:00
ext_libs cleanup: remove jansson dependency 2024-07-28 18:40:05 +02:00
fb2k cleanup: foobar misc + tweak file info 2024-08-10 23:26:53 +02:00
src Update hca_keys.h 2024-09-21 01:53:27 -05:00
winamp cleanup: api stuff 2024-08-18 17:50:55 +02:00
xmplay cleanup: move defs around 2024-08-07 22:35:38 +02:00
.gitattributes cleanup: separate init functions into its own file 2024-07-25 12:27:22 +02:00
.gitignore cleanup: misc 2024-08-10 23:43:41 +02:00
bootstrap builds: missing audacious files 2024-02-11 22:38:35 +01:00
CMakeLists.txt cleanup: remove jansson dependency 2024-07-28 18:40:05 +02:00
configure.ac cleanup: remove jansson dependency 2024-07-28 18:40:05 +02:00
COPYING Update COPYING 2019-04-29 18:31:37 -07:00
Directory.Build.props cleanup: disable some msvc warnings 2024-08-10 23:43:58 +02:00
make-build-cmake.sh cleanup: remove jansson dependency 2024-07-28 18:40:05 +02:00
make-build.sh build tweak 2023-06-10 16:40:05 +02:00
Makefile api: add beta api 2024-07-14 20:31:50 +02:00
Makefile.autotools.am builds: modify how version.h is used to fix issues 2021-08-10 23:51:48 +02:00
msvc-build-clean.bat msbuild: some config and tweaks 2021-08-07 17:04:48 +02:00
msvc-build-init.bat rename build.* to msvc-build.* for consistency 2021-08-07 13:19:57 +02:00
msvc-build-package.bat doc 2021-10-08 22:21:42 +02:00
msvc-build.bat Add S3V support for SVDX (AC). Fix looping for 2DX9 and SD9. 2022-04-20 23:05:37 -04:00
msvc-build.ps1 cleanup: remove jansson dependency 2024-07-28 18:40:05 +02:00
README.md doc 2024-07-18 23:53:28 +02:00
unbootstrap Change ./test folder references to ./cli 2018-01-19 00:39:04 +01:00
version-get.sh builds: fix version .sh for standard sh 2021-08-15 21:22:43 +02:00
version-make.bat builds: batch tweaks 2021-08-15 19:57:56 +02:00
version-make.sh builds: fix version .sh for standard sh 2021-08-15 21:22:43 +02:00
version.h Update version.h 2024-08-19 23:31:12 +02:00
vgmstream_full.sln Add foo_input_vgmstream x64 SDK + automated build 2023-02-12 00:10:49 +01:00
vgmstream_msvc.props cleanup: remove jansson dependency 2024-07-28 18:40:05 +02:00
vspf.py cleanup: renames 2024-07-18 23:52:55 +02:00

vgmstream

This is vgmstream, a library for playing streamed (prerecorded) video game audio.

Some of vgmstream's features:

  • Decodes hundreds of video game music formats and codecs, from typical game engine files to obscure single-game codecs, aiming for high accuracy and compatibility.
  • Support for looped BGM, using file's internal metadata for smooth transitions, with accurate sample counts.
  • Subsongs, playing a format's multiple internal songs separately.
  • Many types of companion files (data split into multiple files) and custom containers.
  • Encryption keys, internal stream names, and other unusual cases found in game audio.
  • TXTH function, to add external support for extra formats, including raw audio in many forms.
  • TXTP function, for real-time and per-file config, like forced looping, removing channels, playing certain subsong, or fusing multiple files into a single one.
  • Simple external tagging via .m3u files.
  • Plugins are available for various media player software and operating systems.

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)

Numbered 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

Getting vgmstream

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.

Usage

If you want to convert game audio to .wav, get vgmstream-cli 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. You can also try the online web player instead. See: https://vgmstream.org

More user-friendly would be installing a player like foobar2000 (on Windows) or Audacious (on 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 to use 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 game format), it only decodes (plays game audio).

Windows binaries

Prebuilt binaries:

The foobar2000 component is also available on https://www.foobar2000.org based on current release.

You may also try the alternative versions (irregularly) built by bnnm:

Or compile from source, see the build guide.

Linux binaries

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), which can't be statically linked.

When building it needs several external libraries. For a quick script for Debian and Ubuntu-style distros run ./make-build-cmake.sh. The script will need to install dependencies first, so you may prefer to run steps manually, which the build guide describes in detail.

macOS binaries

A prebuilt CLI binary is available:

Otherwise follow the build guide.

More info

Enjoy! hcs