Opus audio decoding and encoding for Zig via the battle-hardened xiph.org libopus and libopusfile
Experimental
This is an experimental project according to our stability guarantees:
When a project has an experimental warning, it means all bets are off. You should carefully read the warning to understand why the project is experimental, and assume the worst.
Tracking issue: https://github.com/hexops/mach/issues/961
Getting started
Create a build.zig.zon
in your project (replace LATEST_COMMIT
with the latest commit hash):
.{
.name = "mypkg",
.version = "0.1.0",
.dependencies = .{
.mach_opus = .{
.url = "https://pkg.machengine.org/mach-opus/LATEST_COMMIT.tar.gz",
},
.opusfile = .{
.url = "https://pkg.machengine.org/opusfile/LATEST_COMMIT.tar.gz",
},
},
}
Run zig build
in your project, and the compiler will instruct you to add a .hash = "..."
field next to .url
:
note: expected .hash = "12209838fcfb7a77d2d6931efdc7448c033a1b7dad11d082c94bbeeba9d1038cd311",
Then use the dependency in your build.zig
:
pub fn build(b: *std.Build) void {
...
exe.addModule("mach-opus", b.dependency("mach_opus", .{
.target = target,
.optimize = optimize,
}).module("mach-opus"));
}
You can now use it in your src/main.zig
file:
const opus = @import("mach-opus");
See here for example code.
Ran into trouble?
Triple-check you followed the build.zig.zon
instructions correctly, it’s easy to mess that part up.
Feel free to join the Mach Discord community for help.