audio_reconfigure(3)

💖 audio_reconfigure(3) — bestie edition 💖

okay so welcome to audio_reconfigure(3) from the Library Functions Manual. Yes bestie, that's the manual name — we're folding it in right here at the top because we're cute AND accurate. 💅

✨ NAME ✨

audio_reconfigure — control audio device output parameters. It's giving “audio device output parameters? controlled.” periodt. 🎀

🎀 SYNOPSIS 🎀

int:device
audio_reconfigure( cfgtbl )

💖 DESCRIPTION 💖

okay bestie, here's the tea: this function lets you reconfigure and enable/disable certain audio parameters. slay. But heads up — this might cause a buffering reset and queued samples might be lost depending on the configuration change. 😭 That's the whole warning, no cap.

The returned device specifies new/old audio device identifier that can be used to re-assign audio sources to a newly assigned sink. 🫶 Keep track of that identifier, iykyk — it's how you re-assign audio sources to a newly assigned sink.

This function is mainly a hrtf toggle for the time being, thus marked experimental. ⚠️ Literally experimental, bestie. Eventually it will become the control surface for handling hotplug events and enabling/disabling specific audio outputs. 👑

🔥 EXAMPLE 🔥

This example is giving audio_reconfigure0() realness, comments and all:

-- @group: audio
-- @cfunction: audioreconf
-- @related:
function audio_reconfigure0()
      audio_reconfigure({hrtf = true})
end

xoxo, your Unix bestie 💖 — source/version: Arcan Lua API, date: October 2026. periodt. 🦋