What is dolby-atmos-encoder?

This repository is a proof-of-concept audio tool written in Rust that attempts to convert Dolby Atmos audio from one format to another. Specifically, it reads a Dolby Atmos Master file (the lossless, uncompressed version of an Atmos soundtrack that exists inside a Blu-ray disc) and converts it into DD+ Atmos, the compressed version used by streaming services like Netflix. The motivation was a practical home-theater problem: some TVs and amplifiers cannot pass TrueHD Atmos audio over their HDMI connections, but they can handle the compressed DD+ Atmos version. This tool aimed to bridge that gap. The pipeline is fairly complex. It parses the Dolby Atmos Master file, renders the 3D object positions down to a standard 5.1 surround layout, encodes the object metadata (including height information), and injects all of that into a standard E-AC-3 audio file alongside detection flags that tell hardware it is receiving Atmos content. The E-AC-3 core audio itself is encoded by a separate external tool (ffmpeg), and this project handles the Atmos metadata layer on top of it. The project status is described as research-complete but hardware-blocked. Software decoders and reference tools all confirm that the output looks correct: they detect it as Atmos, report the right number of objects, and verify the 3D positions. However, when played back on real Dolby-certified amplifiers and TVs, the hardware falls back to regular surround sound and does not engage Atmos. The README explains this is caused by two proprietary barriers that cannot be crossed without access to Dolby cryptographic keys. The repository is documented carefully and honestly. It includes working commands, verification steps using an open-source Atmos decoder called Cavern, and a detailed explanation of where and why the approach hits its limits. The author describes it as the artifact of a complete research investigation rather than a finished product. It is intended for personal and interoperability research use only.