{"id":13543119,"url":"https://github.com/vgmstream/vgmstream","last_synced_at":"2025-04-02T12:31:18.129Z","repository":{"id":4452854,"uuid":"5591410","full_name":"vgmstream/vgmstream","owner":"vgmstream","description":"vgmstream - A library for playback of various streamed audio formats used in video games.","archived":false,"fork":false,"pushed_at":"2025-04-01T23:17:15.000Z","size":40671,"stargazers_count":1757,"open_issues_count":20,"forks_count":183,"subscribers_count":41,"default_branch":"master","last_synced_at":"2025-04-02T00:24:25.671Z","etag":null,"topics":["audio","c","codec","decoder","foobar2000","vgm","vgmstream","winamp"],"latest_commit_sha":null,"homepage":"https://vgmstream.org","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vgmstream.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2012-08-28T20:08:24.000Z","updated_at":"2025-04-01T23:17:18.000Z","dependencies_parsed_at":"2023-09-24T16:17:19.635Z","dependency_job_id":"a4ce98d7-b8d6-438a-abbb-0556c2d0e2d5","html_url":"https://github.com/vgmstream/vgmstream","commit_stats":{"total_commits":5478,"total_committers":102,"mean_commits":"53.705882352941174","dds":0.3964950711938664,"last_synced_commit":"416ac26510b4e243760d9c3a1fdb81a885762a8b"},"previous_names":[],"tags_count":128,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vgmstream%2Fvgmstream","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vgmstream%2Fvgmstream/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vgmstream%2Fvgmstream/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vgmstream%2Fvgmstream/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vgmstream","download_url":"https://codeload.github.com/vgmstream/vgmstream/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246815512,"owners_count":20838453,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","c","codec","decoder","foobar2000","vgm","vgmstream","winamp"],"created_at":"2024-08-01T11:00:23.513Z","updated_at":"2025-04-02T12:31:13.117Z","avatar_url":"https://github.com/vgmstream.png","language":"C","funding_links":[],"categories":["C","🛠️ General Tools"],"sub_categories":["🔊 Audio Tools"],"readme":"# vgmstream\nThis is vgmstream, a library for playing streamed (prerecorded) video game audio.\n\nSome of vgmstream's features:\n- Decodes [hundreds of video game music formats and codecs](doc/FORMATS.md), from typical\n  game engine files to obscure single-game codecs, aiming for high accuracy and compatibility.\n- Support for looped BGM, using file's internal metadata for smooth transitions, with accurate\n  sample counts.\n- [Subsongs](doc/USAGE.md#subsongs), playing a format's multiple internal songs separately.\n- Many types of companion files (data split into multiple files) and custom containers.\n- Encryption keys, internal stream names, and other unusual cases found in game audio.\n- [TXTH](doc/TXTH.md) function, to add external support for extra formats, including raw audio in\n  many forms.\n- [TXTP](doc/TXTP.md) function, for real-time and per-file config, like forced looping, removing\n  channels, playing certain subsong, or fusing multiple files into a single one.\n- Simple [external tagging](doc/USAGE.md#tagging) via .m3u files.\n- [Plugins](#getting-vgmstream) are available for various media player software and operating systems.\n\nThe main development repository: https://github.com/vgmstream/vgmstream/\n\nAutomated builds with the latest changes: https://vgmstream.org\n(https://github.com/vgmstream/vgmstream-releases/releases/tag/nightly)\n\nNumbered releases: https://github.com/vgmstream/vgmstream/releases\n\nHelp can be found here: https://www.hcs64.com/\n\nMore documentation: https://github.com/vgmstream/vgmstream/tree/master/doc\n\n## Getting vgmstream\nThere are multiple end-user components:\n- [vgmstream-cli](doc/USAGE.md#testexevgmstream-cli-command-line-decoder): A command-line decoder.\n- [in_vgmstream](doc/USAGE.md#in_vgmstream-winamp-plugin): A Winamp plugin.\n- [foo_input_vgmstream](doc/USAGE.md#foo_input_vgmstream-foobar2000-plugin): A foobar2000 component.\n- [xmp-vgmstream](doc/USAGE.md#xmp-vgmstream-xmplay-plugin): An XMPlay plugin.\n- [vgmstream.so](doc/USAGE.md#audacious-plugin): An Audacious plugin.\n- [vgmstream123](doc/USAGE.md#vgmstream123-command-line-player): A command-line player.\n\nThe main library (plain *vgmstream*) is the code that handles the internal conversion, while the\nabove components are what you use to get sound.\n\n### Usage\nIf you want to convert game audio to `.wav`, get *vgmstream-cli* then drag-and-drop one\nor more files to the executable (support may vary per O.S. or distro). This should create\n`(file.extension).wav`, if the format is supported. You can also try the online web player\ninstead. See: https://vgmstream.org\n\nMore user-friendly would be installing a player like *foobar2000* (on Windows) or *Audacious*\n(on Linux) and the vgmstream plugin. Then you can directly listen your files and set options like\ninfinite looping, or convert to `.wav` with the player's options (also easier to use if your file\nhas multiple \"subsongs\").\n\nSee [components](doc/USAGE.md#components) in the *usage guide* for full install instructions and\nexplanations. The aim is feature parity, but there are a few differences between them due to\nmissing parts on vgmstream's side or lack of support in the player.\n\nNote that vgmstream cannot *encode* (convert from `.wav` to a game format), it only *decodes*\n(plays game audio).\n\n### Windows binaries\nPrebuilt binaries:\n- https://vgmstream.org (latest)\n- https://github.com/vgmstream/vgmstream/releases (infrequent numbered releases)\n\nThe foobar2000 component is also available on https://www.foobar2000.org based on current\nrelease.\n\nYou may also try the alternative versions (irregularly) built by [bnnm](https://github.com/bnnm):\n- https://github.com/bnnm/vgmstream-builds/raw/master/bin/vgmstream-latest-test-u.zip\n\nOr compile from source, see the [build guide](doc/BUILD.md).\n\n### Linux binaries\nA prebuilt CLI binary is available. It's statically linked and should work on systems running\nLinux kernel v3.2 and above:\n- https://vgmstream.org (latest)\n- https://github.com/vgmstream/vgmstream/releases (infrequent numbered releases)\n\nBuilding from source will also give you *vgmstream.so* (Audacious plugin), and *vgmstream123*\n(command-line player), which can't be statically linked.\n\nWhen building it needs several external libraries. For a quick script for Debian and Ubuntu-style\ndistros run `./make-build-cmake.sh`. The script will need to install dependencies first, so you\nmay prefer to run steps manually, which the [build guide](doc/BUILD.md) describes in detail.\n\n### macOS binaries\nA prebuilt CLI binary is available:\n- https://vgmstream.org (latest)\n- https://github.com/vgmstream/vgmstream/releases (infrequent numbered releases)\n\nOtherwise follow the [build guide](doc/BUILD.md).\n\n\n## More info\n- [Usage guide](doc/USAGE.md)\n- [List of supported audio formats](doc/FORMATS.md)\n- [Build guide](doc/BUILD.md)\n- [TXTH file format](doc/TXTH.md)\n- [TXTP file format](doc/TXTP.md)\n\n\nEnjoy! *hcs*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvgmstream%2Fvgmstream","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvgmstream%2Fvgmstream","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvgmstream%2Fvgmstream/lists"}