Generates and tests various channel/scene-based audio configuratons for Eclipsa Audio, and whether YouTube supports them or not.
To set up the repo to work properly, you must have ffmpeg as a valid command.
After that, simply generate the media files via sample_files/gen_samples.sh.
It will run FFmpeg and generate audio files and a 5 second video file to test
with. For your convenience, and because these files are very small, I include
generated files in this repo already.
After generation, run any of the .sh files in the repo root directory to
generate MP4 files with IAMF information embedded. The results will be stored
in output_files.
YouTube currently (as of 2026/08/30) supports up to 18 channels and 2 IAMF Audio Elements, as per IAMF v1.0 Base profile. However, some combinations of Audio Elements trip up the renderer and force the video encoding process on YouTube to fail. That is why I created this repo in the first place, to test various configurations and see what works before future media projects take place on DERPG.
Here are the configurations from this repo, as well as what works and what doesn't:
| Layout Configuration | YouTube Status | Audio Channels | Audio Elements |
|---|---|---|---|
| First-Order Ambisonics | ✅ | 4 | 1 |
| Third-Order Ambisonics | ✅ | 16 | 1 |
| Third-Order Ambisonics + Mono | ✅ | 17 | 2 |
| Third-Order Ambisonics + Stereo | ✅ | 18 | 2 |
| 7.1ch | ✅ | 8 | 1 |
| 7.1.4ch | ✅ | 12 | 1 |
| 7.1.4ch + Stereo | ✅ | 14 | 2 |
| 9.1.6ch | ❌ | 16 | 1 |
| 5.1ch + First-Order Ambisonics | ❌ | 10 | 2 |
As of now, there isn't really much testing taking place. I hope someone finds this useful at least.