MPEG-H 3D Audio (mha1 / mhm1) decoder plugin for AIMP
======================================================

Plays MPEG-H 3D Audio tracks stored in MP4 / M4A files (codec IDs mha1 and mhm1),
for example 360 Reality Audio music files.

Requirements: AIMP 5.x for Windows, 64-bit or 32-bit. The zip contains both builds and
AIMP's installer picks the right one.

Install
-------
In AIMP open Preferences -> Plugins -> Install, pick this zip and restart AIMP.
Then open your .mp4 / .m4a file as usual.

Settings
--------
In AIMP open Preferences -> Plugins, select "MPEG-H 3D Audio decoder" and open its settings.
There you choose the output layout (Stereo, 5.1, 7.1, 9.1.6 or Mono), the loudness target and
the dynamic range control. Changes apply to the next track you start.

Surround layouts need a sound device set up for that many channels. Stereo, 5.1 and 7.1 are
confirmed working in AIMP. 9.1.6 outputs 16 channels (L R C LFE Lb Rb Ls Rs Lw Rw Tfl Tfr Trl
Trr Tml Tmr) and is untested in AIMP.

Your choices are saved automatically (in aimp_mpegh.ini, usually in %AppData%\AIMP).

Notes and limits
----------------
- Files that are not MPEG-H are ignored by the plugin and play through AIMP as before.
- Supported: MPEG-H Baseline / Low Complexity profile, up to level 4 (Fraunhofer decoder).
- Output is 32-bit PCM at the stream's sample rate (normally 48 kHz).
- Raw .mhas files and DRM-protected streams are not supported.
- Cover art is not provided by the plugin.

Licences
--------
The plugin contains the Fraunhofer FDK MPEG-H Software (mpeghdec), mmtisobmff and ilo,
(c) Fraunhofer-Gesellschaft; see the LICENSE-*.txt files. This build is a
"Third-Party Modified Version of the Fraunhofer FDK MPEG-H Software": one ilo source file
received extra #include lines (Nov 2026) so it compiles with mingw-w64; nothing else was changed.
Full source of the plugin and build instructions are in aimp_mpegh_source.zip; the
Fraunhofer sources are at https://github.com/Fraunhofer-IIS/mpeghdec.
The Fraunhofer licence grants no patent licence; it is for personal, non-commercial use
unless you hold the relevant MPEG-H patent licences.
