edde33489b
significant improvements include: - char flags in ongakukan_adp_lib.c have all, with one exception, been made to bools. -- ATM, sample_mode will remain a char. -- several other variables have been removed. they did not affect decoding in any significant way. -- init_ongakukan_adpcm now accepts at least one bool as an argument for a total of four arguments. -- many function from lib renamed to follow external lib function naming standard. - simplified ongakukan_adp_decoder.c -- decode_ongakukan_adp in particular benefited from this code simpification; loop is now re-done so all samples are copied to outbuf when they're made available. -- as a consequence of this, at least one var was removed entirely, while others have been redefined into different purposes; samples_filled is now a bool var that flags whether or not all available samples were decoded. -- init_ongakukan_adp has four arguments as well, and accepts at least one bool as an argument of its own. -- streamfile is now close there as well instead of in the external decoder lib. - adp_ongakukan.c saw much simpified code as well; meta checks have been relaxed significantly, which meant the removal of several var and at least three vars repurposed into bools. -- supposed_size is introduced as an entirely new var; it now calculates the supposed file size of an ADP file with several 32-bit fields from the first byte as a base. -- consequently, file_size checks are now made against supposed_size. - as a consequence of all of the above, riff.c has now lost an additional RIFF size check; initially if RIFF chunk reported a big-enough size than RIFF file realistically has, it would be enough for vgmstream to stop working with said file. |
||
|---|---|---|
| .github | ||
| audacious | ||
| cli | ||
| cmake | ||
| doc | ||
| ext_includes | ||
| ext_libs | ||
| fb2k | ||
| src | ||
| winamp | ||
| xmplay | ||
| .gitattributes | ||
| .gitignore | ||
| bootstrap | ||
| CMakeLists.txt | ||
| configure.ac | ||
| COPYING | ||
| Directory.Build.props | ||
| make-build-cmake.sh | ||
| make-build.sh | ||
| Makefile | ||
| Makefile.autotools.am | ||
| msvc-build-clean.bat | ||
| msvc-build-init.bat | ||
| msvc-build-package.bat | ||
| msvc-build.bat | ||
| msvc-build.ps1 | ||
| README.md | ||
| unbootstrap | ||
| version-get.sh | ||
| version-make.bat | ||
| version-make.sh | ||
| version.h | ||
| vgmstream_full.sln | ||
| vgmstream_msvc.props | ||
| vspf.py | ||
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)
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
Getting vgmstream
There are multiple end-user components:
- vgmstream-cli: A command-line decoder.
- in_vgmstream: A Winamp plugin.
- foo_input_vgmstream: A foobar2000 component.
- xmp-vgmstream: An XMPlay plugin.
- vgmstream.so: An Audacious plugin.
- vgmstream123: A command-line player.
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).
Windows
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.
Linux
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.
macOS
A prebuilt CLI binary is available as well:
Otherwise follow the build guide.
More info
Enjoy! hcs