Skip to content

warmpop/melonDS-RPC

 
 

Repository files navigation

MelonDS-RPC

A fork of melonDS with native Discord Rich Presence built in.


About this fork

MelonDS-RPC adds Discord Rich Presence: while the emulator is running, your Discord status shows the game you're playing.

Rich Presence Example

  • Status line shows "Playing [game name]", taken from the ROM header
  • Game box art (via GameTDB, keyed by the ROM's game code) as the large image, with the melonDS logo as the small badge
  • Elapsed play time, and a "(Paused)" marker while emulation is paused
  • Talks to the Discord client directly over IPC — no external SDK, no configuration needed
  • Degrades gracefully: if Discord isn't running, the emulator behaves normally, and it reconnects automatically whenever Discord (re)starts

There's also one small quality-of-life addition: mouse buttons and the scroll wheel can be bound in Config → Input and hotkeys, alongside keyboard keys — handy if your mouse has a couple of spare side buttons. They show up as Mouse 4, Wheel Up and so on, and work for DS buttons and hotkeys alike.

Everything else is stock melonDS. RPC can be disabled at build time with -DENABLE_DISCORD_RPC=OFF.


How to use

Firmware boot (not direct boot) requires a BIOS/firmware dump from an original DS or DS Lite. DS firmwares dumped from a DSi or 3DS aren't bootable and only contain configuration data, thus they are only suitable when booting games directly.

Possible firmware sizes

  • 128KB: DSi/3DS DS-mode firmware (reduced size due to lacking bootcode)
  • 256KB: regular DS firmware
  • 512KB: iQue DS firmware

DS BIOS dumps from a DSi or 3DS can be used with no compatibility issues. DSi BIOS dumps (in DSi mode) are not compatible. Or maybe they are. I don't know.

As for the rest, the interface should be pretty straightforward. If you have a question, don't hesitate to ask, though!

How to build

See BUILD.md for build instructions.

TODO LIST

  • better DSi emulation
  • better OpenGL rendering
  • netplay
  • the impossible quest of pixel-perfect 3D graphics
  • support for rendering screens to separate windows
  • emulating some fancy addons
  • other non-core shit (debugger, graphics viewers, etc)

TODO LIST FOR LATER (low priority)

  • big-endian compatibility (Wii, etc)
  • LCD refresh time (used by some games for blending effects)
  • any feature you can eventually ask for that isn't outright stupid

Credits

  • Martin for GBAtek, a good piece of documentation
  • Cydrak for the extra 3D GPU research
  • limittox for the icon
  • All of you comrades who have been testing melonDS, reporting issues, suggesting shit, etc

Licenses

GNU GPLv3 Image

melonDS is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

External

  • Images used in the Input Config Dialog - see src/frontend/qt_sdl/InputConfig/resources/LICENSE.md

About

Fork of melonDS with Discord Rich Presence integration

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages