From 65da7890f1d26316d8d8a353e9b728688e904590 Mon Sep 17 00:00:00 2001 From: rmcrackan Date: Mon, 11 Aug 2025 09:21:03 -0400 Subject: [PATCH] Begin documentation for Dolby Atmos --- Documentation/Advanced.md | 1 + Documentation/DolbyAtmos.md | 30 +++++++++++++++++++++++ Documentation/FrequentlyAskedQuestions.md | 6 ++++- 3 files changed, 36 insertions(+), 1 deletion(-) create mode 100644 Documentation/DolbyAtmos.md diff --git a/Documentation/Advanced.md b/Documentation/Advanced.md index e7fce5e8..9ad2ca08 100644 --- a/Documentation/Advanced.md +++ b/Documentation/Advanced.md @@ -12,6 +12,7 @@ - [Custom File Naming](NamingTemplates.md) - [Command Line Interface](#command-line-interface) - [Custom Theme Colors](#custom-theme-colors) (Chardonnay Only) +- [Dolby Atmos, Widevine, Spacial Audio, 4D](DolbyAtmos.md) diff --git a/Documentation/DolbyAtmos.md b/Documentation/DolbyAtmos.md new file mode 100644 index 00000000..c1bab378 --- /dev/null +++ b/Documentation/DolbyAtmos.md @@ -0,0 +1,30 @@ +## [Download Libation](https://github.com/rmcrackan/Libation/releases/latest) + +### If you found this useful, tell a friend. If you found this REALLY useful, you can click here to [PayPal.me](https://paypal.me/mcrackan?locale.x=en_us) +...or just tell more friends. As long as I'm maintaining this software, it will remain **free** and **open source**. + + + +## \*\*\* THIS PAGE IS A WORK IN PROGRESS. PLEASE HELP OUT BY CONTRIBUTING TO IT. \*\*\* + + + +# Dolby Atmos + +Dolby Atmos (Dolby Digital Plus (E-AC-3)) is a surround sound technology that creates an immersive audio experience by adding height channels to traditional surround sound setups. It's also used in 4D and spatial audio. + +## Downloading Dolby Atmos files + +Audible uses a different DRM technology on these files called "Widevine." To remove it, enable "Use widevine DRM" in Settings. + +## Listening to Dolby Atmos files + +### VLC Media Player + +If you save your file with Libation and play it in VLC and only get an image and no audio, the problem is most likely with the audio codecs. Specifically, with the xHE-AAC codec, as it is a modern codec and platforms such as Audible are implementing it in their most recent audiobooks, and VLC cannot process it. In these cases, one user recommended the Polport pre-decoder, which does run this more modern codec and will allow you to listen to your audiobook without any problems. There is an installable and portable version of Polport. + +### Samsung Music app + +To listen with the Samsung Music app, even if your phone does not have Dolby Atmos enabled, the Samsung Music app will read the Dolby Atmos data in the file. The only condition is that the audiobook must be in M4A format, as M4B is not supported. + +If you download it in M4B on your PC, simply change the extension to M4A. You will not lose any quality with that change, and you will be able to play it on the Samsung Music app on your cell phone. \ No newline at end of file diff --git a/Documentation/FrequentlyAskedQuestions.md b/Documentation/FrequentlyAskedQuestions.md index 436dabc5..d4268283 100644 --- a/Documentation/FrequentlyAskedQuestions.md +++ b/Documentation/FrequentlyAskedQuestions.md @@ -35,9 +35,13 @@ Self-hosting online: * [audiobookshelf](https://www.audiobookshelf.org). On [reddit](https://www.reddit.com/r/audiobookshelf/) * [plex](https://www.plex.tv/). Listen with [Prologue](https://prologue.audio/) (iOS) +## I'm having trouble playing my book with 4D, spatial audio, or Dolby Atmos, how can I fix this? + +**A:** Disable the 'Use widevine DRM' option in settings and download it again. [See this page for more information about this file format.](DolbyAtmos.md) + ## Q: I'm having trouble loggin into my Brazil account. -For reasons known only to Jeff Bezos and God, amazon and audible brazil handle logins slightly differently. The external browser login option is not possible for Brazil. [See this ticket for more details.](https://github.com/rmcrackan/Libation/issues/1103) +**A:** For reasons known only to Jeff Bezos and God, amazon and audible brazil handle logins slightly differently. The external browser login option is not possible for Brazil. [See this ticket for more details.](https://github.com/rmcrackan/Libation/issues/1103) ## Q: How do I use Libation with a South Africa account?