◉ Pulse
NaGaa95 avatar
#8 today ▲ 23

NaGaa95/DrasticDS_nx

C Other

Port of Drastic DS for Switch.

Created Jul 23, 2026
Stars
33
Today
+17
Forks
0
Quality
88/100
Momentum
31

README

Fetched from GitHub on Nov 15, 2026, 9:53 AM UTC · README.md

View original on GitHub

Third-party content — Open Source Pulse is not the owner of this repository.

This README belongs to NaGaa95/DrasticDS_nx and its contributors. We fetch it directly from the project’s public GitHub repository and display it for reference only. All text, code, images and trademarks remain the property of their respective authors. See the repository for its license terms. Copyright / takedown policy.

Banner

Drastic DS · Switch Port

A native wrapper/port of Drastic DS Emulator to the Nintendo Switch. It loads the original Android ARM64 emulator core libdrastic_arm64.so, patches it, and runs it inside a minimal Android-like environment natively.

Everything ships as a single DrasticDS.nro: it bundles the build-supplied Drastic core, game database and cheat table, one runtime-selectable host for native Deko3D, Vulkan/NVK, OpenGL/NVC0 and OpenGL-on-NVK through Zink, 56 ready-to-use custom shaders, and an SDL cover-art launcher. Nintendo DS BIOS and firmware are never packed into the NRO.

How to install

  1. Copy DrasticDS.nro into /switch/ on your SD card.
  2. Copy your own Nintendo DS system dumps into /switch/drastic/system/:
    • nds_bios_arm7.bin — 16 KiB ARM7 BIOS.
    • nds_bios_arm9.bin — 4 KiB ARM9 BIOS.
    • nds_firmware.bin — 256 KiB firmware.
  3. Put legally obtained .nds, .zip, or .rar games in /switch/drastic/games/, or add another SD, USB, or SMB library folder from Settings > Library & storage.

The launcher creates the rest of the folder tree and extracts the unified host and bundled application resources on demand:

/switch/DrasticDS.nro
/switch/drastic/
  .emu/                   <- hidden runtime host, extracted when first needed
    DrasticDS_nx.nro      <- Deko3D + Vulkan/NVK + OpenGL/NVC0 + Zink
  cache/
  cheats/                 <- custom Action Replay files
  cores/                  <- Drastic ARM64 core, auto-extracted
  covers/                 <- cover art (<game-key>.png)
  forwarders/             <- HOME-menu shortcut working data
  gamecfg/                <- per-game launcher settings
  games/                  <- default ROM library
  lsfg/                   <- optional user-supplied Lossless.dll
  microphone/             <- optional microphone samples
  scripts/                <- Lua scripts
  shaders/                <- custom DraStic .dfx/.dsd post-FX shaders
    Bundled/              <- OpenGL sources + Vulkan and Deko3D packs
  slot2/                  <- Slot-2 data
  system/
    nds_bios_arm7.bin     <- your ARM7 BIOS dump (you supply)
    nds_bios_arm9.bin     <- your ARM9 BIOS dump (you supply)
    nds_firmware.bin      <- your firmware dump (you supply)
    game_database.xml     <- auto-extracted Drastic database
    usrcheat.dat          <- cheat database (installed once; user-replaceable)
  user/backup/            <- cartridge save files
  user/savestates/        <- save states and previews
  launcher.ini            <- launcher settings
  drastic.ini             <- effective settings for the next launch

Default controls

  • L + R + Plus — open the in-game menu.
  • ZR — fast-forward; hold/toggle behavior is configurable.
  • ZL — swap the DS screens.
  • Touch screen — stylus input on the displayed bottom DS screen.
  • Right Stick + R-Stick — docked-mode analog stylus and touch press.
  • L-Stick — Drastic white-noise microphone input when the simulated source is selected.
  • L + R + Minus + Y / X — save/load the current state slot.
  • L + R + Minus + Up / Down — change the state slot.
  • L + R + Minus + A — reset the emulated DS.

Every runtime hotkey can be rebound to a button combination under Settings > Controller.

Microphone input

Choose Settings > Audio > Microphone source before launching a game, or change it at runtime from Audio, input & motion in the in-game menu. Simulated noise retains the microphone hotkey for games that only require blowing. External microphone captures real audio from a CTIA-compatible headset connected to the 3.5 mm jack or a compatible USB audio input. Attached USB inputs are preferred automatically, and reconnecting or unplugging a device is handled while the game is running. Bluetooth microphone input is not supported by Nintendo Switch.

Slot-2 accessories

Choose the accessory before launching a game under Settings > Gameplay / Features > Slot-2 accessory. The complete native Drastic set is available: None, GBA Cart, SRAM Cart, Rumble Pack, Motion Pack (Official), and Motion Pack (Homebrew).

For GBA Cart, put the GBA ROM and its raw cartridge save in /switch/drastic/slot2/. Name them after the DS ROM (for example, Pokemon Platinum.gba and Pokemon Platinum.sav for Pokemon Platinum.nds). slot2_gamepak.gba and slot2_gamepak.sav can be used as the shared fallback pair. The DS and GBA releases still need to be region-compatible, and only games with Slot-2 connectivity can use them.

Notes

This will not run in applet/album mode. It needs the full memory and JIT services of a game override. Launch it by holding R while opening an installed title, or use a forwarder.

The launcher supports multiple library folders across SD, USB mass storage (FAT32, exFAT, NTFS), and SMB shares, cover and background downloads, a file manager, and HOME-menu shortcut creation. The Classic interface uses the same navigation and artwork design as the NetherSX2 and Dolphin NX launchers.

The library opens on Recent, with a scrolling row of games ordered by last launch. All games and Favorites use the configured cover grid. Press L / R to change tabs and ZL / ZR to page through games. Up from the top row focuses the tab bar and its settings icon. A launches the selected game; Y opens its game menu, where favorites can be toggled. Tabs, covers, the settings icon, and footer hints also support touch.

Classic is the only theme; existing theme selections migrate automatically. Cover settings lets you choose a cover and an optional wide background from SteamGridDB. The Classic background follows the selected game and fades between artwork when animations are enabled. Covers remain available as a fallback, and embedded DS icons keep their original proportions. Configure the API key and download missing artwork under Settings > Library & storage. Use Settings > Launcher > Launcher rotation to select 0, 90, 180, or 270 degrees. The 90 and 270 degree modes reflow the complete SDL launcher for vertical/tate use, including the recent-game carousel, artwork picker, and settings. The grid retains the configured games per page while choosing a portrait arrangement; 0 and 180 retain the landscape layout. Touch follows the displayed UI; D-Pad and stick menu directions remain physically mapped as normal.

Press L + R + Plus to open the in-game menu for save states, per-title Action Replay cheats, screen layout and filter controls, emulation/audio/input settings, frame generation, reset, and return to the launcher. At 90 or 270 degrees, the menu, filter preview bar, layout editor, and FPS HUD use a portrait canvas while menu controls keep their normal orientation.

Settings > Graphics > Renderer > Deko3D (native) selects direct Horizon presentation. It maps the core's completed framebuffer banks for GPU DMA, without calling Android renderFrame, GLES/EGL, or Vulkan. Both native and high-resolution screens, RGB565/RGBA output, all layouts, rotations, built-in filters, custom shaders, the stylus cursor, and menu overlays are supported. The DS 2D/3D rasterizer remains DraStic's software renderer. See the backend notes for the verified ABI and synchronization. Deko3D is the default renderer and appears first in the backend selector. Existing global and per-game renderer choices are preserved.

Settings > Graphics > Background / bezel... selects gameplay artwork, independently of the Classic launcher background. Included presets provide four adaptive PocketArch DS bezel colors and the hardware skins below. The adaptive presets follow every layout, including single-screen, hybrid, custom and rotated layouts. Artwork never covers the game screens or changes touch input.

Use Import background image... to select PNG, JPEG, WebP or BMP from SD, USB or SMB storage. Imports are validated and saved on SD, so the original drive does not need to stay connected. Alternatively, put images in /switch/drastic/backgrounds/; subdirectories are supported. Background fit offers Contain, Fill and Stretch. For a bezel with fixed screen openings, use the Custom layout editor...: it previews the selected image behind the screen rectangles so you can align them. These options support per-game overrides; select None to disable artwork, or reset the row to inherit global settings in a game profile.

The background picker shows the highlighted bezel on the right, with the current screen layout. The Nintendo DS hardware bezel from PNGkey and lnkd's DS Phat Silver / Analogue Black variants include matched screen-layout presets; selecting one applies those screen positions and the appropriate rotation.

During a game, open L + R + Plus → Screen layout & filters → Background / bezel. Use Left/Right to preview backgrounds directly over the paused game, A to apply and save for this title, or B to restore the previous background and layout. The Background fit row also updates immediately. Custom images copied into /switch/drastic/backgrounds/ appear in this picker without returning to the launcher, including images that have never been selected before.

Image files are limited to 32 MiB / 16 megapixels and resized to a maximum 1920-pixel edge when imported. A 128 MiB RAM cache retains decoded images, with the active bezel and the picker's Cancel target pinned while in use. First-time decoding and disk-cache preparation run on a worker so both background pickers remain responsive; rapid navigation replaces queued requests. Once prepared, boot checks the source file's path, size and timestamps instead of hashing the PNG again, and skips the preparation screen when the disk cache is current. Applying a matched layout saves its settings together. The emulator updates the cached overlay only when the layout or UI changes and uses the existing overlay pass on all backends. Native Deko3D LSFG keeps artwork and menus outside interpolation. See artwork sources and licenses.

Settings > Graphics > Low latency controls Deko3D and Vulkan and is enabled by default. Existing preferences migrate from the selected backend's old setting. Restart the game to apply a change. OpenGL and Zink do not use it. With Vulkan, it uses the minimum FIFO swapchain depth and synchronizes DraStic's next emulated frame with image acquisition instead of allowing an extra completed frame to queue. The dedicated HID sampler continues updating controls independently while the renderer waits, so input is not tied to the display loop.

With Deko3D, low latency uses two swapchain images, following the double-buffering approach described by sa2-nx. The renderer acquires an image before selecting the newest completed core bank, so a captured frame does not grow stale while waiting for scanout. This also works with native LSFG: its history is stored separately, and the generated and original frames are presented one at a time. Disabling this option restores three images, which can give heavy filters more pacing headroom. Restart the game after changing it. Gameplay input continues to update independently on the one-millisecond HID sampler; emulation/audio timing is unchanged. Latency gains still need measurement on Switch hardware.

LSFG 2x Frame Generation is available with Deko3D and Vulkan under Settings > Frame Generation. You must provide your own Lossless.dll at /switch/drastic/lsfg/Lossless.dll. LSFG must be enabled before launching a game so the native compute resources or Vulkan device can be prepared; it can then be toggled from the in-game menu. Deko3D extracts and compiles native Maxwell compute shaders on the first launch, then reuses its verified cache in /switch/drastic/cache/lsfg-deko3d/. Changing the DLL, compiler revision, Performance mode or flow resolution selects a separate cache. HUD and stylus overlays are drawn after interpolation. Performance mode and Quarter flow resolution are the defaults.

LSFG generates one intermediate display frame per source frame. It does not increase emulation speed and can add artifacts and latency. Its two presents per source frame limit source presentation to half the display refresh rate; the emulation thread continues independently. Leave it disabled for the lowest latency. With Vulkan, its deeper swapchain takes precedence over the Low latency setting. Also enable Game Mode on the connected TV or monitor when docked.

Nearest, linear, Quilez, scanline, Scale2x, HQ2x, FXAA, FXAA HQ, and SMAA use Drastic's original Android post-FX programs. Native NVC0 and Zink execute the generated GLES programs directly. Vulkan executes SPIR-V generated from the same .dfx/.dsd for Scale2x, HQ2x, FXAA, FXAA HQ, and SMAA, and built-in equivalents for nearest, linear, Quilez, and scanline. Deko3D uses native Maxwell programs compiled from the same original shader sources at build time, with the shared presenter's scanline implementation and explicit base-level sampling.

Custom shaders

The original DraStic Android .dfx format is supported by every backend, including multi-pass chains, headers/includes, framebuffer targets, output scaling, named samplers, and raw lookup textures. Copy a shader's complete folder tree to /switch/drastic/shaders/, then choose Custom shader under Settings > Graphics or from the dedicated in-game custom-shader preview.

OpenGL compiles .dfx/.dsd sources directly when selected. Vulkan has no runtime GLSL compiler, so each custom shader needs an adjacent SPIR-V pack. Deko3D uses an adjacent native DKSH pack, compiled with devkitPro's uam. With glslangValidator and uam installed, generate both on a PC:

python3 tools/compile_custom_shader.py "/path/to/My Shader.dfx" --uam /path/to/uam

The command validates the OpenGL program and creates My Shader.dfx.nxvk/ and My Shader.dfx.nxdk/ beside the manifest. Copy them with the .dfx, .dsd, include, and .raw files while preserving relative paths. A whole shader directory can be passed instead of one file to compile every .dfx recursively. The launcher marks missing packs for the selected backend and blocks that invalid launch instead of silently substituting another filter or renderer.

How to build

Install the devkitPro Switch toolchain and portlibs:

pacman -S devkitA64 switch-tools libnx deko3d uam switch-sdl2 switch-sdl2_ttf \
          switch-sdl2_image switch-curl switch-ntfs-3g \
          switch-zlib switch-libzstd switch-libexpat switch-cmake \
          cmake ninja git python python-mako bison flex \
          mingw-w64-ucrt-x86_64-glslang
DrasticDS/
  com.dsemu.drastic_r2.6.0.4a-109_minAPI14(arm64-v8a)(nodpi)_drasticds.com/
  mesa-switch-unified-sdk/
  DrasticDS_nx/
JOBS=16 DRASTIC_APK_DIR=/path/to/extracted-apk \
  MESA_SDK_DIR=/path/to/mesa-switch-unified-sdk bash ./build_all.sh

Credits

  • Settings icon adapted from Autorun, under LGPL 2.1 or later; source attribution and license are in launcher/romfs/icons/ and bundled with the launcher.
  • Drastic developers.
  • fgsfds for the Switch so-loader groundwork reused here.
  • TheOfficialFloW for the original Android so-loader lineage.
  • Dantiicu for the Switch Vulkan driver.
  • PancakeTAS for LSFG-VK.
  • PalindromicBreadLoaf and the Dolphin/Cemu/NetherSX2 native LSFG contributors.
  • Slluxx for IconGrabber.
  • jdgleaver and the original RetroArch shader authors for the bundled DraStic shader collection; individual source headers retain full attribution.

Support

If you enjoy my work and want to support me:

ko-fi

Legal

This project has no affiliation with Exophase or the Drastic developers. Drastic is proprietary software. No emulator core, BIOS, firmware, database, cheat table, Lossless.dll, or game image is distributed in this repository; you must supply legally obtained copies. The generated NRO intentionally contains no Nintendo DS BIOS or firmware. Do not redistribute an NRO containing other proprietary material unless you have the necessary rights. We do not condone piracy.

Unless noted otherwise, the wrapper source is under the MIT License (see LICENSE). The vendored LSFG-VK subset under third_party/lsfg-vk and native LSFG sources under third_party/lsfg-deko3d are GPL-3.0-or-later. The native integration retains its GPL notices, and source/deko_compiler retains the GPL-2.0-or-later notices of the Cemu/NetherSX2 compiler bridge. Pinned UAM and SPIRV-Cross checkouts retain their individual license files in the build cache.

Rendered by GitHub from the repository’s README. Scroll to read the full file.
First trending

Jul 23, 2026

first spotted on the list

Best rank

#8

highest position reached

Appearances

3

times on the trending list

Quality score

88

out of 100

Momentum

31

trend strength indicator

Star velocity

0.29

stars per day since creation

Activity — last 60 days

daily counts, collected every 6 hours
  • Stars
  • Forks
  • Merged PRs
  • Issues
  • Closed issues

Collecting activity data since launch — check back in a few days.

Star history

total stars per snapshot
510152025303540NaGaa95/DrasticDS_nx · Jul 23, 2 PM UTC: 11 starsNaGaa95/DrasticDS_nx · Jul 23, 7 PM UTC: 16 starsNaGaa95/DrasticDS_nx · Jul 24, 2 AM UTC: 33 stars2 PM8 PM2 AM

Rank history

position on trending · lower is better
#1#5#10#15#20#25#30Jul 23, 2 PM UTC: rank #15Jul 23, 7 PM UTC: rank #27Jul 24, 2 AM UTC: rank #82 PM8 PM2 AM

3D card for your website

Live HTML card with a glass surface and pointer tilt. Paste the iframe on any website.

<iframe src="https://www.notionpulse.cc/embed/NaGaa95/DrasticDS_nx" width="420" height="240" style="border:0;max-width:100%;background:transparent" loading="lazy" title="NaGaa95/DrasticDS_nx — trending on Open Source Pulse"></iframe>

Stars badge

Show current stars in your README or profile. Auto-updates every 6 hours.

NaGaa95/DrasticDS_nx stars badge
Markdown
[![NaGaa95/DrasticDS_nx](https://www.notionpulse.cc/api/badge/NaGaa95/DrasticDS_nx.svg)](https://www.notionpulse.cc/repo/NaGaa95/DrasticDS_nx)
HTML
<a href="https://www.notionpulse.cc/repo/NaGaa95/DrasticDS_nx"><img src="https://www.notionpulse.cc/api/badge/NaGaa95/DrasticDS_nx.svg" alt="NaGaa95/DrasticDS_nx stars badge" /></a>

Repository of the Day

#8 Repository of the Day

Repository of the Week

#8 Repository of the Week

Repository of the Month

#8 Repository of the Month