base on vgmstream - A library for playback of various streamed audio formats used in video games. # 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](doc/FORMATS.md), 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](doc/USAGE.md#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](doc/TXTH.md) function, to add external support for extra formats, including raw audio in many forms. - [TXTP](doc/TXTP.md) 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](doc/USAGE.md#tagging) via .m3u files. - [Plugins](#getting-vgmstream) 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: - [vgmstream-cli](doc/USAGE.md#testexevgmstream-cli-command-line-decoder): A command-line decoder. - [in_vgmstream](doc/USAGE.md#in_vgmstream-winamp-plugin): A Winamp plugin. - [foo_input_vgmstream](doc/USAGE.md#foo_input_vgmstream-foobar2000-plugin): A foobar2000 component. - [xmp-vgmstream](doc/USAGE.md#xmp-vgmstream-xmplay-plugin): An XMPlay plugin. - [vgmstream.so](doc/USAGE.md#audacious-plugin): An Audacious plugin. - [vgmstream123](doc/USAGE.md#vgmstream123-command-line-player): 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. ### 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](doc/USAGE.md#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: - https://vgmstream.org (latest) - https://github.com/vgmstream/vgmstream/releases (infrequent numbered releases) 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](https://github.com/bnnm): - https://github.com/bnnm/vgmstream-builds/raw/master/bin/vgmstream-latest-test-u.zip Or compile from source, see the [build guide](doc/BUILD.md). ### Linux binaries A prebuilt CLI binary is available. It's statically linked and should work on systems running Linux kernel v3.2 and above: - https://vgmstream.org (latest) - https://github.com/vgmstream/vgmstream/releases (infrequent numbered releases) 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](doc/BUILD.md) describes in detail. ### macOS binaries A prebuilt CLI binary is available: - https://vgmstream.org (latest) - https://github.com/vgmstream/vgmstream/releases (infrequent numbered releases) Otherwise follow the [build guide](doc/BUILD.md). ## More info - [Usage guide](doc/USAGE.md) - [List of supported audio formats](doc/FORMATS.md) - [Build guide](doc/BUILD.md) - [TXTH file format](doc/TXTH.md) - [TXTP file format](doc/TXTP.md) Enjoy! *hcs* ", Assign "at most 3 tags" to the expected json: {"id":"13550","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"