AUDIOWMARK(1)

📦 version 0.6.5, in ubuntu stonking

💖 AUDIOWMARK(1) 💖

okay bestie, so this is the audiowmark page from the User Commands manual — and honestly? it's giving genius. let's get into it 🎀

✨ NAME ✨

audiowmark — the audio watermarking tool. that's her. that's the whole vibe. 🌸

🦋 SYNOPSIS 🦋

audiowmark [options] command [args...]

👑 DESCRIPTION 👑

So audiowmark is an open-source C++ audio watermarking utility, and what she does is literally embed and retrieve 128-bit messages inside audio files — in a way that's inaudible to most listeners. like, the message is in there but you can't hear it. sorcery? no. it's just good engineering. 💅

She supports blind decoding, meaning watermark extraction without access to the original file. no reference track needed, she just knows. and she's got robust forward error correction too, which is the reason watermarks can survive lossy compression formats like MP3 and OGG. the watermark really said "you can't get rid of me" and honestly, periodt. 🔥

🎀 COMMANDS 🎀

  • add input_wav watermarked_wav message_hex — makes a watermarked WAV file that's carrying the message you gave it. your audio, but with a lil secret. 🤫
  • get watermarked_wav — pulls the embedded watermark message back out of a watermarked WAV file and prints it to standard output. the big reveal ✨
  • cmp watermarked_wav message_hex — checks the embedded watermark message against the message you expected. basically "is this the message I thought it was?" — and she'll tell you. 🕵️
  • gen-key key_file [ --name key_name ] — generates a 128-bit watermarking key and writes it to key_file. new key, who dis. 🔑

🌈 GLOBAL OPTIONS 🌈

these apply to all the commands, no exceptions bestie.

  • -q, --quiet — disables informational messages. she goes quiet. shh. 🤫
  • --strict — treats minor problems as errors. no chill mode enabled. 😤

💜 OPTIONS FOR get / cmp 💜

  • --detect-speed — detects and corrects replay speed differences. if someone sped it up or slowed it down, she notices. ⏩
  • --detect-speed-patient — slower, but more accurate replay speed detection. good things take time, bestie. 🐢
  • --json file — writes JSON-formatted results to file. structured data, we love to see it. 📄

🫶 OPTIONS FOR add / get / cmp 🫶

  • --key file — loads watermarking key material from file. 🔑
  • --short bits — enables short payload mode using the specified number of bits. smol payload, big energy. 🍓
  • --strength s — sets the watermark strength. the default value is 10. 💪
  • --input-format raw — uses a raw audio stream as input.
  • --output-format raw — uses a raw audio stream as output.
  • --format raw — uses raw audio streams for both input and output. two for one, iconic. 🎁
heads up! the options for configuring raw stream parameters (stuff like sample rate or channel count) are documented in the upstream README. that's where that tea lives. ☕

⭐ EXAMPLES ⭐

Embed a watermark into an audio file:

audiowmark add input.wav output.wav 00112233445566778899aabbccddeeff

Extract a watermark from an audio file:

audiowmark get output.wav

Compare a watermark with an expected message:

audiowmark cmp output.wav 00112233445566778899aabbccddeeff

Generate a watermarking key:

audiowmark gen-key key.bin --name "example key"

💀 EXIT STATUS 💀

  • 0 — the operation completed successfully. she ate. 🎉
  • >0 — an error occurred. 😭

🧚 SEE ALSO 🧚

ffmpeg(1), sox(1) — her besties fr fr. 👯

🌸 AUTHOR 🌸

audiowmark was written by Stefan Westerfeld <stefan@space.twc.de>. 👑

This manual page was written and maintained for Debian by Christopher Obbard. 🫡

Copyright © 2018-2020 Stefan Westerfeld <stefan@space.twc.de>. Licensed under the GNU General Public License, version 3 or later. 📜

okay that's the whole page bestie, you're officially educated 💅✨ this was audiowmark, from the User Commands manual, source/version audiowmark, dated January 2026 — mwah, love u, go watermark something 🎀🦋💜

📦 where this page comes from