MMH Version 6.3 - New Dolby Atmos Helper tool & updated Multchannel Remix tool

QuadraphonicQuad

Help Support QuadraphonicQuad:

This site may earn a commission from merchant affiliate links, including eBay, Amazon, and others.

HomerJAU

Moderator: MCH Media Players
Staff member
Moderator
Moderator
Joined
Jun 13, 2013
Messages
5,916
Location
Melbourne, Australia
Edited: October 2023: (MMH 7.0 is now released - MMH Atmos Helper in MMH 7 has improvements and bug fixes)

I have just released Music Media Helper 6.3.0 with the following new features:

Please PM me for a download link to the beta version (this has 3 alpha users, so pretty stable and usable now)..

MMH Atmos Helper:​

Functionality:

This tool enables users to create Dolby Atmos Master File Sets from multichannel (mch) interleaved WAV files to create ‘channel based’ Atmos mixes encoded with the Dolby Media Encoder or Dolby Encoder Engine.

Input mch files can contain any number of supported channels below:
  • 8 (5.1.2)
  • 10 (5.1.4)
  • 12 (7.1.4)
  • 16 (9.1.6)
For correct channel mapping by the Dolby Atmos Encoders, the interleaved WAV files channel order must be in this corresponding order:

16 channel (9.1.6): L, R, C, LFE, Ls, Rs, Lrs, Rrs, Lw, Rw, Lfh, Rfh, Ltm, Rtm, Lrh, Rrh
12 channel (7.1.4): L, R, C, LFE, Ls, Rs, Lrs, Rrs, Lfh, Rfh, Lrh, Rrh
10 channel (5.1.4): L, R, C, LFE, Ls, Rs, Lfh, Rfh, Lrh, Rrh)
8 channel (5.1.2): L, R, C, LFE, Ls, Rs, Lrh, Rrh)

NOTE: The Dolby Atmos bed 7.1 channel order used in 9.1.6, 7.1.4 and 5.1.4 swaps sides and rears compared to the ‘standard’ channel order used by other multichannel layouts. Users can remix channel order using the MMH Channel Remix tool.

NOTE: A user must have a Dolby Encoder license to encode files to Dolby Atmos. However, this Helper tool can create Dolby Atmos Master File Sets without any Dolby software, Atmos Renderer or DAW (Digital Audio Workstation) software, for encoding by a 3rd party.

Dolby Atmos Master File Sets created by this MMH Atmos Helper tool can be encoded in lossless TrueHD or lossy Dolby Digital Plus format (typically used for streaming Atmos). Currently without Master File Sets the Dolby Media Encoder (DME) cannot encode interleaved WAV files to TrueHD, only Dolby Digital Plus at 768kbps. With Master File Sets a user can encode to TrueHD (lossless) and/or Dolby Digital Plus at up to 1664kbps.

If a user has a Dolby Encoder license and the encoder is installed on the same PC as MMH, the MMH Atmos Helper can also batch encode multiple Master File Sets to create MLP/MP4 files (and optionally: MKV, M4A and/or MP4 files).

MMH Atmos Helper dialog description:​

When the Atmos Helper is opened this is the initial dialog:

MMHAtmosHelper1.PNG


To create Atmos master Files Sets, first select the Source Channel Layout from the first dropdown.

Once the layout is selected add a folder containing multiple source wavs, or add single or multiple wav files using either of the two buttons: Add Folder or Add Files.

NOTE: MMH checks the channel count is each file and ensure that matches to channel count implied by the Source Channel Layout selected. All files in a single batch must containing same number of channels matching the Source Layout (e.g 7.1.4 = 12 channels).

Once file(s) are loaded into the grid, click ‘Create Atmos Files’ to create the Atmos Master File Set(s).

NOTE: ‘Channel based’ Dolby Atmos uses fixed channel positions. To create ‘Objects’ (that can be positioned anywhere in 3D space, including movement) users will need to author using DAW (Digital Audio Workstation) software. But channel based Atmos is still very effective and easy to create for non-pro (enthusiast) for use at home. This is equivalent to traditional multichannel quad, 5.1 and 7.1 mixers produced prior to recent spatial music formats.

Encoding to Atmos with MMH Atmos Helper:​

If a user has a Dolby Encoder license and either Dolby Media Encoder (DMC) or Dolby Encoder Engine (DEE) installed, selecting the ‘Use Dolby Encoder Engine (Only if installed)’ checkbox to set up an encode and create both Master File Sets and Atmos Encode jobs in batch mode using parallel threads to do concurrent encodes (faster). MMH will use up to 4 processors on your CPU (but never more than half the available number of processors).

The first time a user selects the ‘Use Dolby Encoder’ checkbox MMH will pop up a dialog box to select the Dolby Encoder Engine executable (dee.exe). The DEE executable is installed with DEE and with DME. The default program folder if DME is installed is:

C:\Program Files\Dolby Media Encoder\resources\dee

Once selected, MMH stores that folder and will not ask again (unless the folder is renamed, deleted uninstalled etc). On selection MMH also checks if the dee license file (.lic) is in the same folder (as dee.exe), if not then you will be reminded to copy your license file to that folder. Without the license file in the dee folder MMH cannot use dee to encode.

Once the initial setup of DEE program location is done:

Encoder Settings:

MMHAtmosHelperDEESettings.PNG


With the DEE Settings enabled, a user can change the default settings as shown above:

Format: Dolby TrueHD, Dolby Digital Plus (Blu-ray) or Dolby Digital Plus (Online)

Lossless, higher bitrate DDP or Streaming bitrate DDP (DDP for Blu-ray supports 1664kbps encodes)

Bitrate: This dropdown is only available for DDP encodes (You must select a bitrate for DDP)

Output Folder: Output is always related to the files input folder (choose one option)

DRC: Dynamic Range Compression: Therese are the standard Dolby presets (Music Light is recommended for music encodes)

Dialnorm
: Users can choose from -31 to -5db (or Off no dialnorm is applied) NOTE: -31db is recommended for music encodes)

Output Type(s)
:
Select any (or all) of the outputs required. After DEE has encoded each input file, MMH will convert the encoded output to the selected file formats (always an Atmos stream within the selected container).


To Run the Encode Process:

Click: 'Create Atmos Files'

MMH will initially create Atmos Master File Sets for each input file, then it opens the MMH Encoder Job Queue dialog to process all the files and encode using DEE. The Job Queue starts automaticall:

MMHAtmosHelperQueues.PNG


The files are encoded using parallel processing (above shows 4 concurrent encodes). On completion the output files are created in the user’s Output sub-folder.


-------------------------------------------

Remix Channel Layout (new Features/Changes):​


New Functionality:
Downmix/remap between files with different number of channels or channel layouts (examples: map 7.1.4 to 5.1.4, 5.1 to stereo etc)
The Remix Channel Layout tool supports > 8 channels for WAV only, with most standard layouts supported from stereo to a maximum 24 channels (spatial mixes).

The standard channel ordering in a multichannel FLAC or WAV is always:

Quad: LF, RF, SL, SR
5.0: LF, RF, C, SL, SR
5.1: LF, RF, C, LFE, SL, SR
7.1: LF, RF, C, LFE, BL, BR, SL, SR

If you are working with wav files intended for Dolby Atmos channel based encoding the Dolby Atmos Encoder uses these channel orders:

16 channel (9.1.6): L, R, C, LFE, Ls, Rs, Lrs, Rrs, Lw, Rw, Lfh, Rfh, Ltm, Rtm, Lrh, Rrh
12 channel (7.1.4): L, R, C, LFE, Ls, Rs, Lrs, Rrs, Lfh, Rfh, Lrh, Rrh
10 channel (5.1.4): L, R, C, LFE, Ls, Rs, Lfh, Rfh, Lrh, Rrh)

NOTE: The Dolby Atmos bed 7.1 channel order swaps sides and rears compared to the ‘standard’ channel order above.

To define your own Remix Channel Mapping:​

In version 3.5.2 a new remix option was added to allow users to define their own temporary remix definition, for example swap front and rears in a quad file. This has been significantly updated in version 6.1 to support wavs > 8 channels.

Click on the checkbox [Remix (User Defined)]:

This immediately pops up the User Defined Remix channel mapping dialog:

ChannelRemixUserDefined1.PNG


To define a mapping:
Select your Source Channel Layout from the first dropdown (the channels will be shown after selection)
Select your Output Layout from the Output Layout dropdown (the output channels will now be shown


ChannelRemixUserDefined2.PNG


Add your new channel mappings by clicking an input channel and dragging the mouse to top the Output desired channel, release the mouse button.

Here is an example of Quad channels being remapped by swapping front and rears and adding 2 new silent channels for C and LFE to convert to 5.1 formatted files:

ChannelRemixUserDefined3.PNG


NOTE: MMH uses ffmpeg to remix the channels. As you build your mapping MMH displays the ffmpeg ‘pan’ audio filter command-line and shows it in a text box at bottom of the dialog. You can manually edit this text. The text definition always overides to diagram. So effectively the diagram just a visual aid to create the pan filter commandline. MMH passes this audio pan filter to Ffmpeg to make batch remixes for selected files in the main MMH Channel Remix tool dialog. Ffmpeg uses zero based channel numbering (the first channel is 0).

Ffmpeg audio pan filter info here:
https://ffmpeg.org/ffmpeg-filters.html#pan-1
If an output channel is not mapped to an input channel it will created as a silent channel in the output file.

Users can delete a mapping line by clicking on the line and hitting the DEL key.

To save your definition click the [Save] button. This returns you to the original Remix dialog and now you can go ahead and select the Quad files or folders containing Quad files to remix (in this example).


Advanced Channel Mixing Definitions:

MMH (and ffmpeg) also support advanced channel mixing options:

Mixing multiple Source Channels into a single Output Channel:

ChannelRemixUserDefined4.PNG


The above example mixes the side and rear left surround channels of a 7.1 file to rears of a 5.1 file. In the ffmpeg pan filter you will see the channel mix as: c3=0.707*c4+0.707*c5

Applying Channel Gain to any channel map:

When multiple source channels are mapped to a single Output channel, a channel gain factor is auto applied and shown as a numeric value in the mapping line (0.707 in above 1/ root 2) this ensures the output channel in the 5.1 mix has same volume as the two input channels played together in the 7.1 file.

Users can edit the gain of any channel map my clicking the gain text and entering a gain value, if ther is already a gain value, or simply clicking on the centre of any mapping line and entering a value. Values > 1 increases gain, < 1 reduces gain.

If 3 source channels are mapped to a single channel the default gain is 0.577 (1 / root 3)
 
Last edited:
For those beta testers: I just updated the MMH 6.3.0 beta installer.

Changes:
Atmos Helper tool adds a new custom dialnorm option of 'No' - This is the recommended setting for music encodes (No = The encoder auto calculate loudness dialnorm from the input audio file)
 
Another new beta version, same link as previously advised to MHH Beta testers:

Fixes:
Channel Remix tool: User Defined remixes: Error if user has FLAC input files and user defines > 8 output channels. (MMH was trying to create > 8 channel FLAC :(
Fixed: MMH now creates WAVs from input FLACs when Output channels > 8.
 
HomerJAU,
thanks for your effort - this software is great!

So far I've found only a problem: when the decoding is finished, the temp files are not deleted.
 
HomerJAU,
thanks for your effort - this software is great!

So far I've found only a problem: when the decoding is finished, the temp files are not deleted.
Where are they located on the disk? I think Garry said they get deleted after the app closes.
 
Where are they located on the disk? I think Garry said they get deleted after the app closes.
They are here:
C:\Users\username\AppData\Local\Temp\MMH\Decode
(where username is of course the one used on my PC)
and they did not get deleted after the app closes.
Also, I made a conversion on an almost full HDD (I noticed later...); the app finished the job without warnings, but the converted file was not complete - but it was inside the temp folder.

Said so, these are only small bugs in an otherwise GREAT app; hope this few hints would help!
 
They are here:
C:\Users\username\AppData\Local\Temp\MMH\Decode
(where username is of course the one used on my PC)
and they did not get deleted after the app closes.
Also, I made a conversion on an almost full HDD (I noticed later...); the app finished the job without warnings, but the converted file was not complete - but it was inside the temp folder.

Said so, these are only small bugs in an otherwise GREAT app; hope this few hints would help!
I had one album's worth of files in the temp decode folder dated from yesterday. I did 4 or 5 conversions yesterday. The total file size is 563 mb.
 
hello all,

when i try to decode several files, i get the following error message:

the value cannot be an empty string. (parameter 'oldvalue')

other files work. can i see a log somewhere to find the error?

the strange thing is that it works fine with other files. i have not yet been able to find a match between the files that i can use to determine the error message.

someone got this error too? or know how to handle?

thanks in advance

Oliver
 
Hi Homer,

the Version is 7.0.2. I run the "Decode Atmos" on the MMH Atmos Helper.

I just found out, that the decode runs with 9.1.4 layout!

Previously I tried 9.1.6, 7.1.4 and 5.1.4, all failed. The file is an Atmos 16 channel file.

At least that is what the programme shows me:
1688416630141.png


And i seem to remember that i was already given empty top channels when they were not filled.

Can i provide you with more information that will help?
 
I had a question about missing Complexity Index in MP4 files created with EAC3 Dolby Digital Plus (Atmos JOC) encodes created by MMH Atmos Helper's encoder tool.

(Many players ignore this index: Kodi, VLC etc)

If this issue causes problems with your Atmos Player you can correct the index during the encode:

Install GPAC MP4box.exe into your 'C:\Program Files\GPAC" folder (the default install location) MMH Atmos Helper's encoder tool will use that exe to create MP4 files with the correct Complexity Index.

Installer here:
https://gpac.wp.imt.fr/downloads/gpac-nightly-builds/
Use the Windows x64 (64 bit) installer
 
IMPORTANT NOTICE to All MMH Atmos Helper Encoding users

Please note the DialNorm recommendation has been changed to -31db for music encodes (I had previously recommended 'Off' in the PDF docs)

A user did exhaustive tests and reported 'Off' actually turn off DialNorm and lowers the volume during playback too low. I had mistakenly thought Off forced dialnorm to -31.

Based on users testing, -31 resulted in "My Atmos encode is now a respectable -16.87 LUFS!!! My loudest Atmos mix ever".

Excellent news! Thanks to @Methuselah’s Grandpa
 
Ok so I have some more information about this, ...I created some new Atmos encodes using the new setting and shared the same mix with the old encode settings. I shared the mixes with several people & they have let me know the differences (if any) between the playback volume with this change and what their hardware/software was when testing.

On some people's receivers (Denon, Onkyo) the "old" Atmos encode setting of "DialNorm = OFF" had no effect on playback volume, ...so there is no difference in volume compared to the same file that uses the setting of "DialNorm = -31".

There are other receivers (Yamaha, Onkyo, McIntosh, Anthem) in which the "old" setting of "DialNorm = OFF" had drastic effects on playback volume and the same mix encoded with "DialNorm = -31" now is much louder. (One file improved from -31LUFS to -16.6LUFS when decoded through the DolbyReferencePlayer to WAV)

So apparently some receivers disregard that "OFF" setting and play back the old default encodes just fine, ...those were never that quiet for them to begin with. So this change to "DialNorm = -31" doesn't mean that all Atmos encodes will now be louder, ...it just fixes the problem that some of us have had.
 
Last edited:
Is it possible to ask those various users about their Dolby AVR settings.

Here is a post fro 2018 on AVSforum:

Apparently with some Dolby soundtracks (TrueHD mainly?) Denon and Marantz receivers will automatically turn 'ON' the DRC feature. This seems to 'affect' older and newer equipment alike.

I am not a fan of DRC, or other versions like Night mode, Dynamic EQ or Dynamic Volume etc as I would like to hear the soundtrack as intended so when I found this out I wan't too impressed.

The main issue I have is that I have turned off all these modes when I set my receiver(s) up and expect that setting to stay the same, but apparently the DRC 'feature' sometimes turns 'ON' when specific films with Dolby sound are played. This happens automatically in your receiver based on the 'flag' or metadata biult into the soundtrack. I think it happens on TrueHD only and not any DTS ones. It also doesn't happen on all soundtracks either.

What is apparent is that the option for DRC does not appear until the film has started, so most people will not have seen the option when setting things up (as most won't fiddle with settings when a film has started I suppose?).

I have checked on my Denon AVC-A1HD (old by today's standards as not 4K or anything) in my lounge setup and this was happening here. I thought I had all dynamic range control options set to 'OFF' etc but when I played Black Panther I checked the 'audio parameters' section and there was now a 'DRC' option which was set to 'Auto'. I could change it to Low, Middle, High, Auto or OFF so I turned it off. Not sure if the setting will stay that way or not once I turn the AVR off but we will see. Goingto check my Denon AVP-A1HD now, but I think a lot of the newer AVR's are also 'affected' by this issue.
 
Back
Top