A home studio at night with a large monitor showing a video player, studio speakers and glowing rings of sound spreading through the room

Eclipsa Audio on YouTube: Convert Atmos for Free (Even With ChatGPT) and Listen on Your Computer

Spatial9 Team · · 14 min read

Key takeaways

  • You no longer need to buy conversion software to put an immersive mix on YouTube: Spatial9, ChatGPT with the Spatial9 connector and open-source tools all convert ADM to Eclipsa Audio for free.
  • Upload a video MP4 that contains the Eclipsa Audio track, upload it as private first, and check Stats for nerds for Opus (773), which means the immersive stream is playing.
  • To listen on a computer, use Chrome 153 or later, set your audio device to its full speaker layout, and open the video through the YouTube TV interface.
  • On headphones, use the binaural version Spatial9 delivers, the free iamf-tools web demo, or the open-source libiamf decoder.
A home studio at night with a monitor showing a video player and glowing sound rings filling the room
From a finished immersive mix to a YouTube video you can actually hear in 3D, without buying a converter.

YouTube accepts Eclipsa Audio, the open immersive format from Google, Samsung and the Alliance for Open Media. Most guides on the subject stop at "upload and hope", or end by selling a conversion tool. This one covers the whole path: three free ways to convert, how to package the file, how to check that YouTube kept the immersive track, and how to listen on a Mac or Windows computer with speakers or headphones.

At a glance

StepWhat you needCost
Convert an ADM BWF masterSpatial9 converter, ChatGPT with the Spatial9 connector, or iamf-toolsFree
Convert Dolby Digital, Digital Plus or TrueHDSpatial9 converter or the Spatial9 connectorIncluded with a Spatial9 account
Package with videoSpatial9 (automatic) or MP4BoxFree
UploadYouTube Studio, private firstFree
CheckStats for nerds shows Opus (773)Free
Listen on speakersChrome 153 or later, multichannel audio device, YouTube TV interfaceFree
Listen on headphonesSpatial9 binaural file, iamf-tools web demo or libiamfFree

You do not need to pay for conversion anymore

For a while, getting an Atmos mix onto YouTube in an immersive format meant buying a dedicated converter or a renderer licence. That made sense when the only encoders were closed. It no longer does, for three reasons.

  1. The format is open. Eclipsa Audio is the consumer name for IAMF, a royalty-free standard published by the Alliance for Open Media. The reference encoder, iamf-tools, is open source and has an ADM input built in.
  2. Spatial9 offers the conversion free. The ADM to Eclipsa converter takes ADM WAV or BWF masters up to 4 GB, needs only a free account and adds no watermark.
  3. AI assistants can now do the work. ChatGPT can drive the Spatial9 converter through the Spatial9 connector, and it can also try the open-source route inside its own file workspace.
Three routes to Eclipsa Audio: Route A in the Spatial9 browser converter, Route B in ChatGPT with the Spatial9 connector, Route C with open-source iamf-tools and FFmpeg
Three free routes. Pick the one that matches how you like to work; all three end in a file YouTube accepts.

Paid tools can still make sense if you need a specific workflow inside your DAW. For the job of "turn my Atmos master into something YouTube plays in 3D", the free routes are enough.

Before you start: check your master

Every route below starts from an ADM BWF file: the single WAV that Dolby Atmos Renderer, Pro Tools, Logic Pro, Nuendo and DaVinci Resolve export, with the beds, objects and their positions stored inside. If you are not sure what you have, our guide to what an ADM BWF file is explains how to tell.

Have a cover image or a video ready too. YouTube needs a video track.

Route A: the Spatial9 converter in your browser

This is the shortest path, and the only one with no file size problem for most masters.

  1. Open the free ADM to Eclipsa converter and create a free account.
  2. Upload your ADM BWF master, up to 4 GB.
  3. Add a cover image or video if you want a YouTube-ready MP4.
  4. Download the Eclipsa Audio file and the MP4, or publish straight to your channel.

The result is 16-channel third-order Ambisonics in IAMF, with an Intent Fidelity Score that tells you how closely the converted scene matches the original object positions. Our step-by-step Atmos to Eclipsa conversion guide covers each screen.

Route B: ask ChatGPT to do it

There are two ways to do this in ChatGPT, and knowing the difference saves time.

Option 1: ChatGPT with the Spatial9 connector (recommended). Add Spatial9 to ChatGPT once (setup is on the connect page). Then you can say:

ChatGPT gives you an upload link for files up to 2 GB, runs convert_dolby_to_eclipsa on Spatial9, waits for the job and returns the downloads. Because the conversion runs on Spatial9, it works on any ChatGPT plan that supports apps, and it also accepts Dolby Digital, Digital Plus and TrueHD files. If you just want to try it, the guest address https://spatial9.ai/mcp/free includes one ADM to Eclipsa conversion with no account. For everything else an assistant can do with Spatial9, from remixing in 3D to publishing, see agentic AI and spatial audio.

Option 2: ChatGPT's own file tools. ChatGPT can run code on files you upload, so it can try the open-source route itself. Two honest limits apply: audio uploads need a paid ChatGPT plan, and the upload limit is 512 MB. Many ADM masters are larger than that. If yours fits, use a prompt that asks the assistant to check before it promises anything:

Inspect this ADM BWF master. Tell me the duration, sample rate,
number of channels and whether it contains ADM metadata.

If the tools available to you can convert it, convert it to
Eclipsa Audio (IAMF) with the open-source iamf-tools ADM workflow,
then put it in a video MP4 with my cover image as the picture.

Keep the full duration and check that audio and video stay in sync.
Tell me how the objects were represented (for example, folded into
third-order Ambisonics) and any metadata that could not be kept.

Give me the .iamf file and the final MP4, and list every check you
actually ran. If you cannot run the encoder here, say so plainly
and do not substitute a stereo or 5.1 file.

The last line matters. If the encoder is not installed in ChatGPT's workspace, a good answer is "I can't do this here", not a different file with a convincing name. When that happens, use Option 1 or Route A.

Two friendly robots shaking hands over a glowing connector plug, one with a chat bubble and one with a headphone icon
With the Spatial9 connector, ChatGPT handles the conversation and Spatial9 handles the conversion.

Route C: open source on your own computer

If you are comfortable in a terminal, you can do everything yourself with free software. This is also what an assistant runs under the hood in Route B, Option 2.

Open-source pipeline: ADM BWF into iamf-tools encoder_main with the adm_filename flag, producing an IAMF file, muxed with MP4Box into an MP4, uploaded as private and verified as Opus 773
The open-source route from ADM master to verified YouTube upload.

Build the encoder and convert:

git clone https://github.com/AOMediaCodec/iamf-tools.git
cd iamf-tools
bazel build -c opt //iamf/cli:encoder_main

./bazel-bin/iamf/cli/encoder_main \
  --adm_filename=/path/to/my_mix_adm.wav \
  --output_iamf_directory=/path/to/out

Turn a cover image into a video the same length as your mix, then combine the two:

ffmpeg -loop 1 -i cover.jpg -t 245 -r 30 \
  -c:v libx264 -pix_fmt yuv420p cover_video.mp4

MP4Box -add /path/to/out/my_mix.iamf -add cover_video.mp4 -new upload.mp4

Replace 245 with your mix length in seconds, and use the name of the .iamf file the encoder wrote.

Three things to know about this route:

What changes when Atmos becomes Eclipsa Audio

Conversion is a translation, not a copy. An Atmos mix is beds plus objects with positions. Eclipsa Audio describes the same scene as channel layouts or Ambisonics. The positions and the sense of height survive. What does not survive is the ability to grab one object and move it later.

So listen before you publish. Pay attention to:

Spatial9's Intent Fidelity Score gives you a number for this; your ears give you the final answer.

Upload to YouTube the right way

YouTube's recommended upload settings list Eclipsa Audio alongside AAC-LC and Opus, with a channel layout of "Stereo + Eclipsa Audio" at 48 kHz. In practice:

Check that YouTube kept the immersive track

Right-click the video player and choose Stats for nerds. Look at the audio codec line.

Comparison: Opus 773 means the Eclipsa Audio immersive stream is playing, Opus 251 means the stereo version is playing
The one number to check. 773 is the immersive stream, 251 is stereo.
Stats for nerds showsWhat it meansWhat to do
opus (773)The Eclipsa Audio stream is playingNothing; it worked
opus (251)The stereo version is playingCheck your browser and setup below, or wait for processing
No 773 after a day, on a correct setupThe immersive track may not have been acceptedRe-check the file: video MP4, 48 kHz, IAMF track present

If you have ffprobe from FFmpeg 7.1 or later, you can also confirm before uploading that your MP4 contains an IAMF stream group.

How to listen to Eclipsa Audio on your computer

This is the part most people get stuck on. YouTube only sends the immersive stream to players that ask for it, and a desktop browser normally asks for stereo.

Four ways to listen on a computer: Chrome 153 with the YouTube TV interface, the Spatial9 headphone version, the iamf-tools web demo and the libiamf iamfdec decoder
Four ways to hear Eclipsa Audio on a computer, from speakers to headphones.

On speakers, through YouTube

  1. Update Chrome to version 153 or later. Chrome 153 added Eclipsa Audio (IAMF) decoding for web players on every platform Chrome supports. Check your version under Settings, then About Chrome.
  2. Set your audio device to its full layout.
  1. Open the video through the TV interface. YouTube's TV app, at youtube.com/tv, is the player that requests immersive audio. Desktop browsers are normally redirected away from it, which is why many listeners use a browser extension or a user-agent setting that presents Chrome as a TV. Use a reputable extension and remove it when you are done.
  2. Find a video and confirm. Open your private upload, or a channel of Eclipsa Audio demo music such as @EclipsaAudioMusic, play it and check Stats for nerds for opus (773).
A home listening room with a desk, surround speakers and ceiling speakers, a small robot in headphones sitting next to the computer
A 7.1.4 room is ideal, but a 5.1 system or a good pair of headphones is enough to hear the difference.

On headphones

Most people will hear your mix on headphones, so it is worth checking that version too.

# Build with the command-line tool enabled
cmake -DIAMF_TEST_TOOL=ON .. && make

# Binaural for headphones
./iamfdec -i1 -o3 headphones.wav -sb upload.mp4

# 7.1.4 speaker feed
./iamfdec -i1 -o3 speakers_714.wav -s9 upload.mp4

Our explainer on binaural versus spatial audio covers why the headphone version sounds different from speakers.

Troubleshooting

ProblemLikely causeFix
Stats for nerds always shows 251Desktop YouTube player asked for stereoUse Chrome 153 or later and the TV interface
773 shows but it sounds like stereoAudio device set to stereoSet the speaker layout in Audio MIDI Setup or Windows Sound
Height speakers are silentWindows layout limited to 7.1Check your interface driver; use the binaural version to judge height
Upload has no immersive trackAudio-only MP4, wrong sample rate or missing IAMF trackRe-mux as a video MP4 at 48 kHz
ChatGPT refuses the fileOver 512 MB or no paid planUse the Spatial9 connector or the browser converter
ChatGPT returns a 5.1 or stereo fileEncoder not available in its workspaceAsk it to stop and say so; use Route A or Option 1
Movement feels smearedObjects folded into AmbisonicsCompare with the original; adjust the mix or check the Intent Fidelity Score

Common misconceptions

For the creator side of publishing, including titles, thumbnails and where else to release, see our guide to Eclipsa Audio for YouTube creators.

Frequently asked questions

Can I convert Dolby Atmos to Eclipsa Audio for free?

Yes. Spatial9's ADM to Eclipsa converter is free with an account, accepts ADM BWF masters up to 4 GB and adds no watermark. The open-source iamf-tools encoder from the Alliance for Open Media is also free.

Can ChatGPT convert ADM to Eclipsa Audio?

Yes, in two ways. With the Spatial9 connector, ChatGPT runs the conversion on Spatial9 and returns the files. Without it, ChatGPT can try the open-source encoder in its own workspace, which needs a paid plan for audio uploads and works only for files up to 512 MB.

Why should I not pay for an Atmos to Eclipsa converter?

Because the format is open, the reference encoder is free, and Spatial9 offers a free converter that also scores how well the conversion kept your mix. Paid tools can be useful for specific DAW workflows, but they are not required to publish on YouTube.

Does YouTube support Eclipsa Audio uploads?

Yes. YouTube's recommended upload settings list Eclipsa Audio with a channel layout of "Stereo + Eclipsa Audio" at 48 kHz. Upload a video MP4 that contains the IAMF track.

How do I know YouTube is playing Eclipsa Audio?

Right-click the player and open Stats for nerds. opus (773) means the Eclipsa Audio stream is playing; opus (251) means you are hearing stereo.

How can I listen to Eclipsa Audio on my computer?

Use Chrome 153 or later, set your audio device to its full speaker layout and open the video through YouTube's TV interface. On headphones, use the Spatial9 binaural version, the iamf-tools web demo or the libiamf decoder.

Does Eclipsa Audio work with Dolby Digital Plus or TrueHD files?

Spatial9 accepts AC-3, E-AC-3 and TrueHD files, decodes the speaker channels up to 7.1 and converts them to Eclipsa Audio. The open-source ADM route only reads ADM BWF files.

Will my Atmos objects stay as objects in Eclipsa Audio?

No. Eclipsa Audio stores channel layouts and Ambisonics, so objects are rendered into the scene, for example as third-order Ambisonics. Their position and movement remain; the ability to edit them separately does not.

References

  1. Uploading files and audio to ChatGPT, OpenAI Help Center.
  2. iamf-tools encoder documentation, including ADM input, Alliance for Open Media.
  3. Encoding and muxing IAMF with external tools, Alliance for Open Media.
  4. YouTube recommended upload encoding settings, YouTube Help.
  5. IAMF decoding with Media Source Extensions, Chrome Platform Status, shipped in Chrome 153.
  6. IAMF web demo, Alliance for Open Media.
  7. libiamf decoder and iamfdec tool, Alliance for Open Media.
  8. Report on YouTube audio format 773, yt-dlp issue tracker.
  9. Spatial9 free ADM to Eclipsa conversion, Spatial9.

Convert your master free

Your Atmos mix already exists. Getting it onto YouTube in 3D should not cost extra. Convert your ADM master free with Spatial9, or connect ChatGPT to Spatial9 and ask it to do the whole job for you.

Dolby, Dolby Atmos, Dolby Digital Plus, TrueHD, YouTube, Chrome, ChatGPT, Eclipsa Audio and all other names are trademarks of their respective owners. Spatial9 is not affiliated with or endorsed by Dolby Laboratories, Google, OpenAI or Samsung.

Try Spatial9 free