From GameBrew

AuthorMoonlight, Infantile Paralysiser
Last Updated2010/08/31
TypeMedia players
Version2.10 Stable

MoonShell is a homebrew multimedia player for the Nintendo DS, Nintendo DS lite, Nintendo DSi, and Nintendo 3DS. It is a well known, popular piece of Nintendo DS homebrew software, and offers a way to play videos and audio on the DS, along with other homebrew games.


Download and extract the Moonshell package to a folder on your computer.

Download the DLDI file for your card and move it into the DLDI folder that was created in the first step.

Download this tool: Win32_GUI.

Plug your card into your computer. Start setup.exe, which can be found in the folder that you created in the first step.

Choose your card for Destination in the list and click OK. Click All Clear and check the tick box for your card.

Click Setup and Moonshell will install itself to your card.

Once the copy has finished unplug your card from your computer. Launch your card in your DS and start the Moonshell app.

User guide

Support file formats

Music MP1, MP2, MP3, OGG, WAV, M4A, AAC, WMA, TTA, MID, RCP, R36, FLAC.
Chiptune SPC, NSF, GBS, HES, AY, SAP, KSS.
Playlist M3U, WPL.
Picture JPG, BMP, GIF, PNG, PSD.

Also supports DPG movie files and text files.

Limitations concerning formats

NDS Not support commercial NDSROM files.
WMA Not support "loss-less" and "voice mode" format WMA files.
M4A, AAC, WMA Not support encrypted files.
MID Not support "Standard MIDI file format.2" format.
SPC Tone quality is very bad.
Chiptune Only the first track is performed. The FM sound chip cannot be emulated.
Playlist Support encode is ANSI, S-JIS, UTF-8, CP437, CP850, CP1252.
Text file Support encode is ANSI, S-JIS, UTF-8, UTF-16BE, UTF-16LE. Auto detection only.

Information is displayed in the file list. MP3, JPEG, BMP, PSD, DPG only.

Screen capture

The screen capture can be preserved by keeping pushing the Select button for 3 seconds or more on an arbitrary screen.

NDS stops when succeeding in preservation. Please open the made BMP file with Windows.

When the memory is insufficient, it is not possible to make it.

Misc tools

AutoDLDIPatch Auto DLDI patch tool for not DLDI patch firmware.
DPGTools Movie encoder.
DPGTools_AltVer Movie encoder (old safe?).
HandWriteModelsManager Hand write models manager for text editor.
ImageViewer Album (IPK) maker.
JacketImageConverter Jacket image maker.
MakeBGPack Slide show bg-pack file maker.
MakeSplashAniForMS2 Splash anime file maker.
MoonMemo Readme of memo.
MoonShell2_AlternativeLoader When failing in the start, this boot loader is used.
PluginsText Plugin attached text files.
SetPassword Simple boot password setting tool.
SkinTool Skin maker.
sndeff Sound effect converter.
SoundFont8bit Low quality and small size, sound font file for software MIDI emulator.


File list:

Up/Down/Left/Right - Move cursor

A - Open file

A (hold) - When music file, Open music player

B - Stop music

X/Y - Change volume

Start - Open system menu

Start (hold) - Delete this file

Select - Open sub menu

Select (hold) - Get screen capture (exclude DSi)

Text reader:

Up/Down - Line scroll

Left/Right - Page scroll

A - Page scroll

B - Back to file list

X/Y - Open bookmark save or load menu

Start/Select - Open setting window

Image viewer:

Up/Down/Left/Right - Screen scroll

A/X/Y - Change zoom ratio (Y=50%, X=200%, A=100%)

B - Back to file list

Start - Set to background image

Select - Open setting window

L/R - Start direct moving mode

Movie player:

Left/Right - Previous or next 5sec seeking

Up/Down - Previous or next 30sec seeking

A - Toggle pause

B - Back to file list

Start/Select - Open setting window

X/Y - Change volume


Known issues

A bug that FileTrip Download Link moonshell sometimes stops in playing DPG isn't fixed this time.

Message file update of notepad and submenu isn't done yet.


v2.10 stable

  • Playback of MDX (software emulation so sound is worse than MDXOffline).
  • Play only audio in movie.
  • Output audio in movie to ROMEO2.
  • If you press A longer, you can select playback mode and playlist editor which is valid in the same folder.
  • ChannelsMapSelector was added to SELECT submenu (you can edit moonshl2.ini to modify langauge and number of content).
  • Drastic update in MoonMemo (Check Right/Left, X/Y).
  • Fixed a bug that thumbnail wasn`t updated after modifying real image.
  • Added equalizer to music player. Use R+Up/Down/Left/Right or touchpanel to modify (same for ROMEO2).
  • Fixed a bug that auto DLDI patching wasn`t applied when you launch big homebrew.
  • You can control music playback in screen saver. Listen to sounds like "PiPi".
  • Modified behavior of play icon. If you exits the folder which has music file currently played, FileTrip Download Link moonshell shows note icon on the folder.
  • Added ScreenSaver_ShowClock/ScreenSaver_ShowMusicInfo to moonshl2.ini [FileList] section to switch whether to show screensaver clock and music info.
  • Fixed a bug that SJIS text couldn`t open in textreader if the memory wasn`t enough.
  • Fixed a bug that jacket image wasn`t shown when you back to filelist from music player.
  • If you put cursor on BMP file, FileTrip Download Link moonshell shows simple preview.
  • In prompt to input new filename, you can erase all by pressing B but also cancel by pressing START/SELECT.
  • DPGEnc parameter was modified for recent CPU. You can encode 2-5x faster.

Updates in text editor:

  • Added "create new file" to SELECT submenu.
  • Default setting in textedit.ini was modified. Left/Right ends of Prediction conversion window are connected in default (only for jap).
  • Now text editor saves clipboard. You can paste to another file.
  • Arrangement of buttons in Kana mode is reversed in left/right.
  • You can paste not only by pressing R button but also by pressing L button (L+X/Y are reserved for backright so only L+Up/Down/Left/Right are OK).

External links