Subscribe to download
libsneedio, a library that provides custom music and audio (experimental)

libsneedio is a library that provides scripting API to include custom music and audio within the game.

*Please read this description thoroughly*

if you get following message:
"Cannot check native code version, I refuse to work with unknown DLL version"
"libsneedio.dll version mismatch against sneedio, current version is _ expected version is _."
Install the latest dependencies here: https://github.com/admiralnelson/warhammer2-libsneedio/releases
"Failed to load libsneedio, please check your mod installation. Make sure you extracted the 7zip archive into Warhammer2.exe folder"
You must extract the 7z content into the game folder.


**Full install guide is here: https://github.com/admiralnelson/warhammer2-libsneedio/blob/master/doc/install.md **

**To use this library you need to download native code libraries from my github release page:
https://github.com/admiralnelson/warhammer2-libsneedio/releases/tag/version0.6.3
head over to For.Steam.Release.7z file and extract it to your Warhammer2.exe directory. This is the secret sauce of the library. I do not include the binaries on the pack files, this is intended to maintain binaries trust.**

**This mod doesn't come with music, either create your own playlist using provided lua API or download a sample pack in github release page. This is strictly library mod that provides functionality for other mods.**

* Starting guide to make your own music and unit voice pack mod: https://github.com/admiralnelson/warhammer2-libsneedio/blob/master/doc/modder-getting-started.md *

How does it work?
It uses native code via `require` function to bridge SDL media player and lua script, this code can load audio from local files and youtube links.

How do you use this library (for modders)?
Visit https://github.com/admiralnelson/warhammer2-libsneedio/blob/master/doc/sneedio.md for library API documentations and sample

What it can do?
It can apply voices for your custom units in campaign, battle, and diplomacy. It can also load custom music to your liking. No more .wem files editing, just a simple .mp3 file or Youtube links, and couple lines of lua scripts.

Why there are .exe in your release page?
That will be used to download youtube links and convert them to .mp3 files.
Visit:
- https://github.com/yt-dlp/yt-dlp (yt-dlp.exe, downloaded from: https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp.exe)
- https://github.com/yt-dlp/FFmpeg-Builds (ffmpeg.exe, downloaded from: https://github.com/yt-dlp/FFmpeg-Builds/releases/download/latest/ffmpeg-master-latest-win64-gpl.zip)
for more information.

Why there are .dlls in your release page?
These will be used to load codec and interface with the lua script.
libsneedio.dll will bridge the gap between SDL and @sneedio_loader.lua script
These are third party libraries I use:
- https://github.com/NotAPenguin0/audeo/tree/123c83272e619453cf7175a4882e72639882a9ca
- https://github.com/libsdl-org/SDL/tree/297ce148e66091f190b3c462fda2a6f8b799a3fd
- https://github.com/libsdl-org/SDL_mixer/tree/37ddea8b3e29160e5b591037a5742533a14d1372
- https://github.com/rangercyh/lua5.1/tree/bd830426035f6db4d02bff3088f35299637b0ef5

How do you uninstall the mod?
Unsubscribe and run uninstall-libsneedio.bat. You may also want to remove yt-dlp-audio and yt-dlpbin folder.

Does it work on linux?
No, the libraries are compiled as win64 DLLs and executables. Play using proton to get around this.

To enable output you need to add your system environment variable: SNEEDIO_DEBUG with a value of 1 or edit @sneedio_loader.lua and set SNEEDIO_DEBUG = true;

Source code and non steam version will always be available at
https://github.com/admiralnelson/warhammer2-libsneedio

Please report bugs on my github issue page, so I can track bugs easily.

To enable debug output, download this mod https://steamproxy.net/sharedfiles/filedetails/?id=1271877744&searchtext=logs. The logs can be found on Warhammer2.exe directory.
Also you need to edit your system environment and add new entry SNEEDIO_DEBUG with value of 1. https://media.discordapp.net/attachments/732202039484088344/957526200157347840/unknown.png?width=1909&height=1282