Bring OEM speaker tuning back to Linux.
Open-source Dolby DAX3 tuning parser & zero-latency PipeWire filter-chain generator.
Warning
Experimental / Clean-Room Notice: OpenDolby is an independent clean-room implementation based on OEM tuning XMLs. It is not official Dolby software or a Dolby Atmos decoder.
Laptop speakers on Linux often sound flat or tinny compared to Windows because the manufacturer's Dolby DAX3 / APO speaker tuning is not applied.
- Not a generic EQ preset: Directly parses the OEM's speaker-specific DAX3 XML (crossovers, biquads, and multiband curves).
- Zero-latency PipeWire native: Synthesizes causal minimum-phase FIR impulse responses (
.irs) and runs natively in PipeWirefilter-chainwith optionallsp-pluginsLV2 brickwall limiting. - Easy to try & revert: One command to install, switch profiles, check status, or cleanly uninstall.
Built and verified on ASUS Zenbook UX3404VC (Realtek ALC294, VEN_10EC&DEV_0294&SUBSYS_10431693).
# Run directly with uv (no manual venv or cargo needed)
git clone https://github.com/Ravomi/OpenDolby.git && cd OpenDolby
uv run python -m opendolby.cli install music
# Switch profiles (movie / dynamic / game / voice)
uv run python -m opendolby.cli install movie
# Check active installation
uv run python -m opendolby.cli status
# Uninstall and restore plain speaker output
uv run python -m opendolby.cli uninstallExtract the DAX3 .xml from your Windows partition (C:\Windows\System32\drivers\) or OEM audio driver package, then pass --xml:
uv run python -m opendolby.cli inspect --xml /path/to/your_dax3.xml
uv run python -m opendolby.cli install music --xml /path/to/your_dax3.xml- Parse DAX3 XML (
opendolby/parser.py): Extractstuning-cp(IEQ, GEQ, Optimizer) andtuning-vlldp(20-band speaker optimizer,speaker-peq-filtersbiquads/crossovers, multiband compressor, peak ceiling). - Synthesize Minimum-Phase FIR (
opendolby/dsp.py): Combines active curves on a dense FFT grid, converts to a causal minimum-phase.irs(float32 stereo WAV) via real cepstrum, and trims headroom safely below0 dBFS. - Generate PipeWire
filter-chain(opendolby/pipewire.py): Emits a zero-latencybuiltinconvolver + optionallsp-pluginsLV2limiter_stereotargeting your hardware speaker sink.
See docs/architecture.md for full DSP mapping details.
Dual-licensed under MIT OR Apache-2.0.
把本机扬声器调音带回 Linux。开源的 Dolby DAX3 调音解析器与零延迟 PipeWire filter-chain 生成器。
- 并非通用 EQ 预设:直接解析 Windows 驱动 XML 中的厂商扬声器专属调音(分频、双二阶滤波器、多段曲线)。
- PipeWire 原生零延迟:通过实倒谱合成因果最小相位 FIR 脉冲响应(
.irs),并可选搭配lsp-pluginsLV2 限幅器。 - 支持自定义机型:默认内置华硕 Zenbook UX3404VC 配置,也支持
--xml <path>导入其他笔记本的 DAX3 XML。
git clone https://github.com/Ravomi/OpenDolby.git && cd OpenDolby
uv run python -m opendolby.cli install music # 安装 music 配置
uv run python -m opendolby.cli status # 查看当前状态
uv run python -m opendolby.cli uninstall # 卸载并恢复默认输出

