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.
- Copy
DrasticDS.nrointo/switch/on your SD card. - 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.
- Put legally obtained
.nds,.zip, or.rargames 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
- 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.
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.
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.
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.
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/uamThe 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.
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-glslangDrasticDS/
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- 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.
If you enjoy my work and want to support me:
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.
