I’ve been working on TIDAL Atmos for TidaLuna, a Windows Desktop project that keeps the normal TIDAL interface while a hidden Omniphony-enabled mpv instance handles the actual playback.
GitHub: https://github.com/Cxsmo-ai/Tidal-Atmos-For-Tidal-Luna-
Latest release: https://github.com/Cxsmo-ai/Tidal-Atmos-For-Tidal-Luna-/releases/latest
Current version: v2.2.0
WHAT IT DOES
TIDAL Desktop remains the only visible music interface, so you can continue using:
• Search
• Albums and playlists
• Your collection
• TIDAL’s normal playback queue
• Play, pause, previous and next
• Seeking and volume
• Shuffle and repeat
• Album artwork
• Synchronized lyrics
• Windows media keys
• Compatible keyboards and remotes
Behind the scenes, the TidaLuna plugin keeps TIDAL’s native audio session silent and sends the selected stream to a hidden Omniphony-enabled mpv instance.
This gives you the native TIDAL Desktop experience with a separate Atmos playback and binaural-rendering path.
ATMOS-FIRST REALMAX MATCHING
The project includes RealMAX, which checks whether the stereo track you selected has a matching Dolby Atmos edition.
It compares information such as:
• Track title
• Duration
• Available editions
• Returned stream format
Playback priority:
Verified Dolby Atmos
↓
HiRes FLAC
↓
Lossless FLAC
RealMAX does not assume a track is Atmos merely because its title or album metadata contains the word “Atmos.”
The Dolby Atmos indicator is only shown after the returned stream has been verified as EAC3_JOC and decoded by mpv as multichannel E-AC-3.
When no verified Atmos edition is available, playback falls back to the best available stereo FLAC stream.
OMNIPHONy BINAURAL RENDERING
Verified Atmos playback can be routed through Omniphony Studio for binaural headphone rendering.
You can use:
• Your preferred SOFA or HRIR profile
• Omniphony binaural rendering
• Headphone playback
• WASAPI output
• Exclusive-capable Windows devices
• A real installed ASIO driver
• Omniphony OSC communication
• Custom spatial-rendering settings
The SOFA or HRIR profile is controlled by Omniphony Studio rather than the TIDAL plugin.
Playback path:
TIDAL Desktop UI
↓
TidaLuna Omniphony plugin
↓
Local playback API on 127.0.0.1
↓
Atmos, HiRes FLAC, or Lossless FLAC stream
↓
Hidden Omniphony-enabled mpv
↓
orender and OSC
↓
Omniphony Studio
↓
SOFA or HRIR binaural rendering
↓
WASAPI or ASIO output
THE MODIFIED MPV RUNTIME IS INCLUDED
The downloadable Windows release ZIP includes the required Omniphony-enabled mpv runtime:
• mpv.exe
• libmpv-2.dll
• orender.dll
• harletty_bridge.dll
You do not need to locate or build a separate modified mpv package when using the release ZIP.
The compiled runtime binaries are distributed through the release archive rather than stored directly in the Git source tree.
NEW CONTROL CENTER IN V2.2.0
Version 2.2.0 adds a visual Omniphony Control Center for setup and daily use.
It handles:
• Guided TIDAL device authorization
• Authorization verification
• Luna plugin installation and repair
• Launching TIDAL in Atmos-first mode
• Portable-path detection
• Repairing paths after moving the folder
• Authorization backup and restore
• Installation and output diagnostics
The package does not require a hard-coded installation directory.
You can move the complete extracted folder, reopen the Control Center, and it will rediscover the package root and rewrite the portable paths.
SYNCHRONIZED CONTROLS AND LYRICS
The hidden player stays synchronized with TIDAL’s visible interface.
Supported controls include:
• Play
• Pause
• Stop
• Previous
• Next
• Absolute seeking
• Seek forward and backward
• Volume and mute
• Shuffle and repeat
• Queue progression
• Progress-bar position
• Synchronized lyrics
• Windows media-session controls
• Compatible keyboard and remote controls
When a new track or RealMAX Atmos edition starts, the plugin:
Pre-pauses mpv.
Loads the selected stream manifest.
Seeks to exactly zero.
Applies the current volume.
Starts playback.
Version 2.2.0 also includes a zero-start lock that rejects stale timestamps from the previous song. This prevents a newly loaded track or Atmos edition from jumping to the previous track’s position.
Recovery after an actual audio-device interruption is handled separately and resumes from the saved position.
PREVIOUS-BUTTON BEHAVIOR
Previous behaves like it does in most desktop music players:
• Pressing Previous after three seconds restarts the current track.
• Pressing it near the beginning moves to the previous queue item.
ENCRYPTED AUTHORIZATION BACKUPS
The Control Center can export the local TIDAL authorization into an encrypted .omniauth backup.
The backup uses AES-256-GCM encryption and can be imported into another extracted copy of the project.
The password is never stored.
Local authorization files remain inside the extracted folder:
• api/token.json
• api/.env
These files are excluded from Git and rejected by the release validator.
They should never be uploaded, attached to an issue, included in screenshots, or committed to GitHub.
VERIFIED V2.2.0 PLAYBACK TESTS
The release was validated with an authenticated TIDAL account.
Results included:
• Verified E-AC-3 JOC Atmos playback
• Six-channel, 48 kHz Atmos streams
• Exact 0.000-second playback starts
• HiRes FLAC playback at 192 kHz
• Audible standard FLAC fallback
• Five out of five known stereo selections resolving to verified Atmos editions
• Working play, pause, seek, and volume synchronization
• Working previous and next routing
• TIDAL’s Atmos indicator
• Native TIDAL audio muting
• Audible hidden mpv output
• Synchronized TIDAL lyrics
The measured test streams became ready in roughly 432–629 ms, although real startup time depends on TIDAL’s CDN and your connection.
INSTALLATION
Requirements:
• Windows 10 or Windows 11 x64
• TIDAL Desktop
• A working TidaLuna client patch
• An active TIDAL subscription
• Omniphony Studio
• A WASAPI device or real installed ASIO driver
Setup:
Download Tidal-Atmos-For-TidaLuna-v2.2.0-Windows-x64.zip.
Extract the complete ZIP into a permanent writable folder.
Install and open Omniphony Studio.
Close every existing TIDAL window.
Run Omniphony Control Center.bat.
Open Authorization and request a fresh TIDAL device code.
Complete the device-link page in your browser.
Return to the Control Center and verify the authorization.
Open Installation and install or repair the Luna plugin.
Start Omniphony Studio and load your SOFA or HRIR profile.
Select Launch TIDAL Atmos.
Choose the Omniphony WASAPI or ASIO backend and your physical output device from TIDAL’s output menu.
Setup.bat remains available as a compatibility shortcut and opens the same Control Center.
No Docker container, global Python installation, separate visible API terminal, hard-coded installation path, or visible mpv window is required.
SOURCE AND DOWNLOAD
GitHub: https://github.com/Cxsmo-ai/Tidal-Atmos-For-Tidal-Luna-
Latest v2.2.0 release: https://github.com/Cxsmo-ai/Tidal-Atmos-For-Tidal-Luna-/releases/latest
The Git repository contains the auditable plugin source, setup tooling, tests, and documentation.
The downloadable Windows release additionally includes the portable native runtime binaries required for playback.
Feedback and testing are welcome, especially from people using different headphones, DACs, ASIO drivers, SOFA profiles, and Omniphony configurations.
This is an independent community project and is not affiliated with or endorsed by TIDAL, Dolby, Omniphony, mpv, or the TidaLuna maintainers.