UD Nightly is a fork of melonDS Android, the Android port of the melonDS Nintendo DS and DSi emulator. It adds easier setup and controls, and includes fixes for saves, imports, Android lifecycle handling and the native core.
Downloads and release notes · Feature and update guide · Android core fork
Check each release for its exact version, Android package, CPU architectures, signing certificate and test results. An older release does not establish that the latest source has been packaged or tested on your device.
UD Nightly 2.1.1/54 is the current download.
The APK and complete ZIP
include the integrated official app 27321156. The ZIP contains the complete
recursive source, source patches, license, build instructions and verification
manifest. Check either download with the release's DOWNLOADS-SHA256SUMS.
2.1.1 restores import of complete cheat databases; see the release identity below.
main may contain later documentation or packaging-tool changes. This is an independent UD fork
release, with its own signing certificate. Release identity and checks
identify the exact binary and evidence; historical results retain their original
candidate identities. The 2.1 publication replaces inherited tag names at the fork maintainer's
request; published commit history and contributor attribution are preserved.
The original comparison starts from official app c42995ca and core 431ab4bd. Current source integrates official 27321156, including Benjamin BONVARLET/Komalis's RTC PR #1664, archive notices and the update installer. Features and contributor provenance distinguish upstream work, adapted patches and UD implementations; upstream reconciliation records the source checks.
- Guided BIOS and firmware setup. Select a folder, see separate DS/DSi results and retry a failed copy before adopting its files. UD implementation; existing firmware requirements still apply. Setup details · Implementation
- Firmware Wi-Fi controls. Edit three connection slots, names and DNS settings; enable or disable slots from the pause menu. UD implementation; successful configuration does not establish game/server connectivity. Connection settings · Implementation
- Cheat search and grouped choices. Use the integrated official toolbar search or UD folder search. Plain toolbar results support toggle/edit/delete; selector results open an explicit picker. Finding an option does not enable it. Supported families provide species, level, nature and starter choices. Search adapts and extends takanuva15's #1677; grouped selectors are UD work. The supported Sacred Gold Plus profile retains its in-game L+R encounter toggle; compatibility depends on the exact ROM/code set. DAT support already existed upstream. Cheat guide · Selector scope and UI checks
- Settings and layout backup access. Expose the existing upstream backup manager, validate restored values and refresh controller settings. This retains the original implementation and addresses the access requested in #264. Backup and restore
- Remove one library entry. The ROM details page can forget a selected entry and its per-game settings/history while keeping ROMs, saves, cheats and other entries. The confirmation identifies its exact URI. A file still present can be rediscovered by a later scan. Included in current UD Nightly; selected-entry removal and cold persistence passed on the named ARM64 emulator and Thor candidates. Behavior, regression tests and limits
- Combination hotkeys and hold to fast-forward. Adapt WailAbou's #1606 and #1608, with interrupted-input controls. Optional fast-forward mute adapts dysprosium's #1625; it is a listening option, not an audio-fidelity fix. Controls
- External launches and sleep/lid handling. Adapt N3MI-DG's #1648 and DLCSharp's #1589, with selected lifecycle fixes from corigne's #1666. Complete recovery after process death is not claimed. Adaptation scope
- Optional forward-only clock correction. Resume synchronization is now upstream via Benjamin BONVARLET/Komalis's #1664. UD retains its existing default-off setting and only advances a clock that is at least 30 seconds behind. Policy and limits
DS/DSi emulation, OpenGL/Compute rendering, high-resolution 3D, DAT import and the underlying backup manager retain their upstream authorship. The core overview describes the optional hostname-override API and shared-core changes; the firmware Wi-Fi editor does not call that API.
These are actual UD Nightly 2.1.8 screens on an Android 15 emulator, using synthetic data. The cheat examples remain disabled. Capture identity and checksums
| Guided BIOS setup | Cheat search | Level selector |
|---|---|---|
![]() |
![]() |
![]() |
| Species selector | Firmware connection slots |
|---|---|
![]() |
![]() |
Each dossier records the affected path, before/after behavior, source identity, tests and limits. High/Medium/Low below reproduce the linked security record's rating; other impact labels describe functional consequences without assigning a security score. Historical test results apply to their named candidates, not every later build.
| Correction | Impact | Evidence and remaining limits |
|---|---|---|
| Keep pending save writes after an I/O failure; report failure and permit retry. | Progress loss risk | SaveManager/file-mode tests and raw-save checks. Some SAF fallback providers can still truncate; this is not universal atomic replacement. |
| Preserve the previous cheat database during failed/cancelled XML or DAT import; read fragmented input completely and stop at invalid offsets/EOF. | Database loss, hang | C1/C2 before/after and JVM/ART/SQLite checks. Provider cancellation has the documented cooperation limits. |
| Reject incomplete BIOS/TMD files and clean up failed NAND imports before adopting them. | Invalid data adoption | N1/N2 reproductions and setup lifecycle/SAF checks. DSi HOME and logical quota remain separate. |
| Saturate amplified microphone samples and keep capture cursors with their owning buffers; serialize source/session changes. | Distorted input, crash | A1/A2 numeric and lifecycle controls, concurrency evidence. Physical microphone sensitivity and Bluetooth are not certified. |
| Release interrupted touches/controller state, update stationary multi-touch coordinates and restore both DS screens after display disconnect. | Stuck input, missing display | D1/I1 JVM/Android regressions. New casting controls, hardware display behavior and input latency are not established. |
| Handle failed audio opens/resume, renderer fallback and session teardown with explicit ownership. | Crash, silent or blank output | Lifecycle/renderer controls. Component/AVD evidence does not close every driver-specific resume report. |
| Serialize scans, persist the newly selected sort order, load icons independently and bound 7z heap use/archive traversal. | Crash, blocked library, wrong ordering | Library/archive/sort controls. Oversized archives may need manual extraction. Current source also integrates the upstream #1524 heap/OOM handling and extraction-failure notices while retaining the fork's tighter budgets. Source reconciliation. |
| Remove a selected obsolete ROM entry without resetting the library; serialize removal with scanning and persist the retained entries atomically. | Stale entries, missing selective cleanup | Library-entry dossier: three initial RED failures plus two invalidation regressions; 16 focused and 355 full JVM/API tests passed. Exact-candidate updates, native UI removal and cold persistence passed within the recorded emulator/Thor coverage; provider faults and power-loss durability remain unproven. |
| Keep selector actions visible with large text and the keyboard; use option-specific labels and a single radio action. | Clipped or misleading controls | UI regressions/captures · Final release selector labels. These correct fork-added UI; spoken TalkBack and physical gamepad acceptance remain separate. |
| Check ROM sizes, cache destinations and derived save names before access. | Medium: storage exhaustion or file overwrite | Cache-size case · Save-name case. Per-case source/regression evidence does not certify every provider. |
| Accept granted external-launch URIs instead of trusting serialized ROM authority; reject malformed/null launch fields. | High: unintended file access; Low: launch crash | Authority boundary · Malformed launch. Scoped-storage restrictions still apply. |
| Disable unauthenticated DSiWare metadata sources by default and require the validated transport/size contract. | Medium: untrusted metadata adoption | Transport correction and proof. This does not authenticate arbitrary title content or provide a production metadata service. |
| Bound imported cheat data and validate restored settings/firmware before adopting them. | Medium/Low: allocation or startup failure; High at the firmware/native boundary | Cheat allocation · Settings · Firmware. Dynamic evidence varies by card. |
| Validate savestate length and state invariants, restoring the previous state when load fails. | Medium/High: allocation, partial state or native memory access | Length · Rollback · Invariants. Old savestate/game compatibility remains bounded to the tested inputs. |
| Release JNI references/string leases and retain NAND enumeration ownership; handle provider write exceptions. | Medium/Low: resource exhaustion, lifetime or failed save retry | JNI · NAND lifetime · Save exceptions. Tests retain their ART/component distinctions. |
| Keep RetroAchievements credentials out of URL logs/platform backup; bound responses and close retry resources. | Medium/Low: credential exposure or resource exhaustion | Logging · Backup · Responses. These do not fix game-specific achievement rules. |
| Preserve the native DS pixel grid for LCD/scanline filters and stop dispatching resume for a stopped session. | Visual error, invalid lifecycle callback | LCD/scanline grid correction · Eight resume RED/GREEN cases. The current release includes the resume guard. |
| Pin CI dependencies and restrict signing/publication to the intended repository/event. | Low: release dependency integrity | Repository correction. External release-environment/tag controls remain unverified. |
| Recover failed NAND save replacement; correct JIT ownership/literals, cartridge/peripheral bounds and cheat work limits. | Data integrity, native memory safety, hang | Shared-core bug dossiers, with separate host/Android evidence and compatibility limits. |
The complete finding index contains 35 + 66 occurrences, not 101 independent bugs. The register records 97 occurrences with code corrections, two with repository corrections but unverified external controls, one Android-not-applicable case and one informational reconciliation. A source correction, an individually reproduced failure and a passing aggregate suite are different evidence levels.
The issue and PR coverage register distinguishes complete local fixes, partial coverage and work not integrated. A fix in this fork does not close an upstream issue or merge another contributor's PR.
Use the APK listed in a release and verify it against DOWNLOADS-SHA256SUMS before installing. The complete ZIP also includes that APK, source, source patches and the verification manifest. Commercial game images, personal BIOS/firmware, NAND and game saves are not included. The source retains the upstream freely redistributable BIOS replacement and its license.
- New UD installation: use the standalone UD Nightly APK and select your own game and system files.
- Existing UD installation: an in-place update requires the same Android package and signing certificate, with a higher version code. Back up saves, settings, layouts, cheats and system files first. Keep the app installed; do not clear its data as an update step.
- Official Nightly installation: UD Nightly follows the
.nightlypackage name but has a different signing identity. Android will reject replacing the author's signed APK with a fork-signed APK. - Earlier
.nightly.perfinstallation: the current public release provides no compatible legacy APK. The public.nightlyAPK cannot update it in place. Private databases and saved document permissions do not transfer automatically between package names.
A source patch, included in the complete ZIP, is for developers applying changes to the documented source revision and rebuilding. It cannot turn the author's signed APK into an update signed by this fork. Installation and update details
The persistent UD release signing certificate has SHA-256 fingerprint 832a0223e29802245c0e9f8ca24c8358e7d21cfe0dbea347845fda751f950d86. Verify the downloaded APK against the manifest inside the complete ZIP. Earlier .perf builds use a different preserved local identity and require their separately labeled update.
DS/DSi emulation, supported ROM archives and the existing renderers remain available. Local multiplayer, DSi SD-card support, new casting controls and broad device-specific compatibility are not claimed by these changes. Online settings do not guarantee that a game, access point or community server will connect.
Testing includes JVM/API checks, native sanitizers, Android native tests on ARM64 4 KiB and 16 KiB environments, and real-app tests on Android emulators. Physical-device results and skipped checks are recorded separately in the verification reports. Test success does not certify every game, Android version or device. No measured battery, CPU, GPU, RAM or frame-rate improvement is claimed without a corresponding comparison.
Both fork repositories use main. The app pins the exact core revision as a Git submodule and compiles it into the APK; end users do not install the core separately.
git clone --recurse-submodules --branch main https://github.com/Umberto-DEV/melonDS-android.git
cd melonds-android
sh ./gradlew :app:assembleGitHubNightlyDebugGitHub's automatic source ZIP does not contain submodule contents. The complete source ZIP inside the UD distribution ZIP includes the pinned dependencies; extract it and build from its source/ directory. In an existing checkout, use git submodule update --init --recursive; do not use --remote when reproducing a pinned build. The debug build has a separate .dev ID and is not the release update.
Use Java 21 and the SDK, NDK and CMake versions declared by the project. Release builds use :app:assembleGitHubNightlyRelease and require an owner-controlled signing key configured in untracked local.properties:
MELONDS_KEYSTORE=/path/to/keystore
MELONDS_KEYSTORE_PASSWORD=<store password>
MELONDS_KEY_ALIAS=<key alias>
MELONDS_KEY_PASSWORD=<key password>Keep signing material and passwords out of Git, artifacts and logs. Published UD updates must preserve their signing identity.
Rafael Caetano maintains the upstream Android port; melonDS and its contributors provide the core. This fork preserves their licenses and credits. Adapted app work includes takanuva15 (cheat search), WailAbou (hotkeys and hold to fast-forward), dysprosium (fast-forward mute), N3MI-DG (external launches), DLCSharp (sleep/lid behavior), selected fixes by corigne, and Benjamin BONVARLET/Komalis (RTC PR #1664). The evidence documents retain the corresponding PR links and scope.
See LICENSE, the core contributor guide and the original projects for licensing and contributor information. Game and system files are not distributed here.




