vitor251093/KHMelonMix v0.8.0 on GitHub

Changes

(Days & Re:Coded) Adjusting HUD sizing and position to match the ones from KH2 and KH3
(Days) Slow camera speed should be the ingame default
(Days) Improving support to dual screen mode
(Days) In local multiplayer, only the primary instance should play the BGMs
(Re:Coded) Finishers shouldn't break the HUD
Adding integration with the 1.5+2.5 collection (by @TopazTK)
Adding bridge to launch Linux's Melon Mix from the 1.5+2.5 collection running under Wine/Proton
Memory leak fixed (by @ej-sanmartin)

Installing

If this is your first time using the Melon Mix, follow the "How to install for the first time" guide down below. If you want to keep your save files from older Melon Mix versions, follow the "How to upgrade from an older version" guide right here:

How to upgrade from an older version

On Windows, replace MelonMix.exe with the newest one.

On Steam Deck, replace MelonMix.AppImage with the newest one, provided in this release. Then right click the AppImage, go to "Properties", then go to the "Permissions" tab and check the "Allow executing file as program" checkbox.

Migrating from versions below 0.6.0

For additional required steps, check the 0.6.0 migration guide.

How to install for the first time

How to play "358/2 Days" (standalone)

Download the latest version for your system (not the source code zip);
Open the downloaded ZIP file and copy the contents to an empty folder;
Dump an original copy of "358/2 Days" and copy the NDS file to your computer;
Rename that NDS file to "days.nds", place it inside a folder named "roms", and then place that folder next to the Melon Mix executable that you just copied;
Place this assets folder next to the Melon Mix executable file (optional; only if you want to upgrade the audio / cutscenes / textures / sprites) (on macOS, the assets folder should be inside the bundle's Contents folder);
(Windows) In the future, launch the Melon Mix using "MelonMix_KHDays.bat", but, right now, launch "MelonMix.exe";
(Linux) Right-click the AppImage, go to "Properties", then go to the "Permissions" tab and check the "Allow executing file as program" checkbox. Repeat those steps for MelonMix_KHDays.sh as well;
(Linux) In the future, launch the Melon Mix using "MelonMix_KHDays.sh", but, right now, launch the AppImage/binary;
(macOS) Move the Melon Mix app to the Applications folder, or run the following command in the terminal: xattr -drs com.apple.quarantine <path>, replacing <path> with the full path of the app bundle;
(macOS) Now you just need to launch the Melon Mix bundle, and open the NDS file with it;
Open the Days NDS file with the Melon Mix, and then press Config -> Input and hotkeys to configure the controls (recommended mappings at the "Recommended controller binds" guide below). You MUST open the NDS file BEFORE opening the Input and hotkeys window, otherwise you will just see the melonDS Add-ons;
Press Config -> Plugin settings to configure the Melon Mix according to your personal preferences.

Note: The Linux steps are also applicable on the Steam Deck.

How to play "Re:Coded" (standalone)

Download the latest version for your system (not the source code zip);
Open the downloaded ZIP file and copy the contents to an empty folder;
Dump an original copy of "Re:Coded" and copy the NDS file to your computer;
Rename that NDS file to "recoded.nds", place it inside a folder named "roms", and then place that folder next to the Melon Mix executable that you just copied;
Place this assets folder next to the Melon Mix executable file (optional; only if you want to upgrade the audio / cutscenes / textures / sprites) (on macOS, the assets folder should be inside the bundle's Contents folder);
(Windows) In the future, launch the Melon Mix using "MelonMix_KHReCoded.bat", but, right now, launch "MelonMix.exe";
(Linux) Right-click the AppImage, go to "Properties", then go to the "Permissions" tab and check the "Allow executing file as program" checkbox. Repeat those steps for MelonMix_KHReCoded.sh as well;
(Linux) In the future, launch the Melon Mix using "MelonMix_KHReCoded.sh", but, right now, launch the AppImage/binary;
(macOS) Move the Melon Mix app to the Applications folder, or run the following command in the terminal: xattr -drs com.apple.quarantine <path>, replacing <path> with the full path of the app bundle;
(macOS) Now you just need to launch the Melon Mix bundle, and open the NDS file with it;
Open the Re:Coded NDS file with the Melon Mix, and then press Config -> Input and hotkeys to configure the controls (recommended mappings at the "Recommended controller binds" guide below). You MUST open the NDS file BEFORE opening the Input and hotkeys window, otherwise you will just see the melonDS Add-ons;
Press Config -> Plugin settings to configure the Melon Mix according to your personal preferences.

Note: The Linux steps are also applicable on the Steam Deck.

How to play Melon Mix from the 1.5+2.5 collection (Steam only)

Note: Those instructions apply only to Linux and Windows, and are only compatible with Melon Mix 0.8.0 and later releases.

Download the latest version for your system (appimage for Linux, windows for Windows);
Extract the downloaded ZIP file to a new folder;
Open Steam, right click your installation of the 1.5+2.5 collection, and press Manage -> Browse local files, which will open a folder (let's refer to it in the next steps as the "collection folder");
Inside the collection folder, rename KINGDOM HEARTS HD 1.5+2.5 Launcher.exe to KINGDOM HEARTS HD 1.5+2.5 Launcher backup.exe;
Copy KINGDOM HEARTS HD 1.5+2.5 Launcher.exe folder from the extracted folder to the collection folder;
Inside the collection folder, open the Image folder, and create a melon folder inside of it;
Copy MelonMix.exe, MelonMix.AppImage (if any) and the roms folder from the extracted folder to the "melon" folder;
Dump an original copy of "358/2 Days", copy the NDS file to your computer, and name it days.nds;
Dump an original copy of "Re:Coded", copy the NDS file to your computer, and name it recoded.nds;
Place both NDS files inside the "roms" folder;
Place this assets folder next to the Melon Mix executable file (optional; only if you want to upgrade the audio / cutscenes / textures / sprites);
(Linux) Right-click the AppImage, go to "Properties", then go to the "Permissions" tab and check the "Allow executing file as program" checkbox;
Open the Melon Mix directly (MelonMix.exe on Windows, MelonMix.AppImage on Linux);
Open the Days NDS file with the Melon Mix, and then press Config -> Input and hotkeys to configure the controls (recommended mappings at the "Recommended controller binds" guide below);
Open the Re:Coded NDS file with the Melon Mix, and then press Config -> Input and hotkeys to configure the controls (recommended mappings at the "Recommended controller binds" guide below);
Press Config -> Plugin settings to configure the Melon Mix according to your personal preferences.

Recommended Controller Binds

(DS Keypad tab) Map the DS D-Pad to your controller's left analog stick
(DS Keypad tab) Map the Start button to the equivalent key in your controller
(DS Keypad tab) Map the A/B/X/Y buttons to the equivalent keys in your controller
(DS Keypad tab) Map the L button to the L1/LB button in your controller
(Touch Screen tab) Map the DS Touch Screen to your controller's right analog stick
(Add-ons tab) Map the command menu to your controller's D-Pad
(Add-ons tab) Map "Switch Target - Left" to the L2/LT button in your controller
(Add-ons tab) Map "Lock On" to the R1/RB button in your controller
(Add-ons tab) Map "Switch Target - Right" to the R2/RL button in your controller
(Add-ons tab) Map "Fullscreen Map Toggle" to the Select/Share/View button in your controller
(Add-ons tab) Map "HUD Toggle" to the R3/R button in your controller
(General hotkeys) Map "Toggle fullscreen" to an available button of your preference

How to dump DS cart into an NDS file

There are multiple ways to do so. Those are some of them:

Using a DSi: https://dsi.cfw.guide/dumping-game-cards.html
Using a 3DS: https://3ds.hacks.guide/dumping-titles-and-game-cartridges.html

vitor251093/KHMelonMix v0.8.0 0.8.0 on GitHub