MoonShell

MoonShell
General
Author	Moonlight, Infantile Paralysiser
Type	Media Players
Version	2.1.0 child zwai
License	GPL-2.0
Last Updated	2012/05/04
Links
2.1.0 Stable, Child Zwai + Patch Old Versions
Website
Source

MoonShell is a homebrew multimedia player for the Sony PSP, 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.

The initial version 0.1 was released on 2 August 2005. It supports DPG video files, MP3 / OGG / MOD / SPC / MDX (no PCM) / GBS / HES / NSF / XM / MIDI / WMA / low bit rate AAC audio / non-progressive JPEG /BMP / GIF / PNG images, text files, and ebooks. The latest version 2.10 can play FLAC files, though with some audible sound distortion. Both screens on the DS are used, with the bottom screen allowing file selection and control via touchscreen.

The integrated plug-in system provides extensibility of program features. To add a feature, the plug-in files are simply copied to the appropriate folder. In order to function as a media player, several plug-in files are distributed with the software.

Installation

There are 2 versions in the archive, stable and child zwai (intended for DSi, DSiLL or ROMEO2).

The updated version (child zwai) prioritized on sound processing, which may cause some slowdown compared to the stable version. Particularly, high-quality music files like M4A/WMA, MDX, and SPC, might experience more frequent skipping. This effect is more pronounced when playing text or images simultaneously.

The improved sound quality is only noticeable when using DSi/DSiLL or ROMEO2 (a slot2 sound board) with earphones. There will be little improvement in sound quality when using NDS/DSLite alone despite the slowdown.

Instructions:

• Connect your SD card to your PC.
• Double click on the exe file to extract the contents on your PC.
• Double click on the setup.exe to run it.
• Choose the language, then from "Install to..." select the drive for your SD card.
• Click the "Open More" check box for other addons/plugins/tools.
• Click "Install" to continue.
• Double click LanguageSelect.exe to configure your MoonShell 2's language settings.
• Insert the SD card into your console.
• Run either moonshl2.nds or moonshl2_directboot.nds.

Alternatively you just need to copy the following files to the moonshl2 directory:

• moonshl2.nds
• moonshl2_DirectBoot.nds
• (moonshl2_AltLoader_DKPr27.nds is an alternative to moonshl2.nds for AceKard2, it also fixes a sound issue with R4)

Update patch for v2.10 child zwai:

• Note: Only use the update files with v2.10 child zwai. Do not use it on other versions (i.e. stable).
• Copy and overwrite the moonshl2.nds and moonshl2 folder. If you are booting directly without going through the standard firmware, use the files in the DLDIPatchedFiles folder.
• To check if the update is installed, press Start on the file list screen. It should display "MoonShell Ver 2.10 for child zwai May 4 2".

User guide

Support file formats

Music	MP1, MP2, MP3, OGG, WAV, M4A, AAC, WMA, TTA, MID, RCP, R36, FLAC.
MOD	MOD, IT, MTM, S3M, XM, 669, MED, STM, AMF, GDM, ULT, UNI, ASY, IMF, OKT, STX.
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

You can save a screen capture by pressing and holding the Select button for three seconds or more on any screen. After saving, the NDS will stop. Please open the BMP file with your computer (??_pmain.bmp, ??_pover.bmp, ??_psub.bmp).

If files with the same name exist, they will be saved with an added sequential number in the file name. If there is insufficient memory, it will not be created.

When capturing on DSi, please check "Enable Screen Capture Function (DSi)" in the overall environment settings.

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.

Controls

File list

Standard:

Up/Down/Left/Right - Move cursor

A - Open file

A (hold) - Start the music player if it's a music file

B - Stop music (exit the folder when stopped)

X/Y - Change volume

Start - Open system menu

Start (hold) - Delete this file

Select - Open sub menu

Select (hold) - Screen capture (DSi default to adjust brightness, can be changed in settings)

R Triple Click - Start standby mode (power off after 10 minutes of inactivity)

Key combos:

L/R+Touch - Start Notepad in new document creation mode

L+Left - Show MP3 control panel

L+Right - Next music

L+Up - Pause music

L+Down - Change play mode

L+A/B - Previous/Next music

L+X/Y - Change backlight level

R+Left/Right - 1% forward/backward MP3 seek

R+Up/Down - 5% forward/backward MP3 seek

R+A - Play all songs in the folder

L+R+A - Play all songs in the SD card

Text reader

Standard:

Up/Down - Scroll one line

Left/Right - Scroll one page

A - Scroll one page

B - Return to file list

X/Y - Open bookmark save/load menu

Start/Select - Open settings menu

Key combos:

L/R+X/Y - Adjust backlight brightness

Image viewer

Standard:

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 current image as wallpaper

Select - Open settings menu

L/R - Start direct moving mode

Key combos:

L/R+X/Y - Adjust backlight brightness

Video playback

Standard:

Left/Right - Previous or next 5sec seeking

Up/Down - Previous or next 30sec seeking

A - Pause video

B - Back to file list

Start/Select - Open settings menu

X/Y - Change volume

Key combos:

L/R+Left/Right - Move to the previous/next video file

L/R+Up - Pause video

L/R+Down - Change playback mode

L/R+X/Y - Adjust backlight brightness

L/R button combinations

L+R Simultaneously - Pause music

L/R Single Press+Long Press - 1% forward/backward MP3 seek

L/R Double Click - Play previous/next song

L Triple Click - Pause

Screenshots

Changelog

v2.10 child zwai update 2012/05/04

• Fixed a bug causing abnormal termination near the end of DPG file playback.
• Fixed a bug in implementing touch panel combination commands (unable to seek by long press).
• Added an option to play DPG files on the lower screen to moonshl2.ini. Please refer to moonshl2_DPGOption.ini.

v2.10 for child zwai 2010/08/31

• Added support for MDX file playback (since it's software emulation, the quality is lower than MDXOffline).
• Added option to output only video audio (useful for web radio, etc.).
• Added support for outputting video audio from Romeo2.
• A button long-press selection for playlist editor only within the same folder as playback mode.
• Added ChannelsMapSelector to the SELECT button submenu.
• Significant changes to MoonMemo. (Try pressing the right/left, X/Y buttons).
• Fixed bug where thumbnails were not updated when the content of an image changed in automatic thumbnail generation.
• Added equalizer to music player. Adjust levels with R+up/down/left/right or touch screen. (Unified behavior with Romeo2).
• Fixed bug where automatic DLDI patch was not applied when launching large HomeBrew.
• Enabled song control via touch panel during screen saver. Since you can operate with the backlight off screen by making a "beep" sound, it may be a bit difficult to explain, but please try it.
• Changed behavior of play icon. When exiting a folder while playing music, a music note icon is now also added to the folder containing the playing file.
• Added ScreenSaver_ShowClock and ScreenSaver_ShowMusicInfo to the [FileList] section of moonshl2.ini. Options to toggle display/show for screen saver clock and song information, respectively.
• Fixed bug where S-JIS text files couldn't be opened if there wasn't enough memory when starting the text reader.
• Fixed bug where album art was not displayed when returning from music player to file list.
• Added simple preview of BMP files when cursor is placed on them in file list.
• Added ability to cancel with START/SELECT buttons in addition to clearing everything with B button on new file name input screen.
• Adjusted CPU load balance of DPGEnc for recent CPUs, speeding up encoding by about 2-5 times.
• Added a simple toy drum set.

Text Editor-related:

• Added submenu for creating new text files to SELECT button.
• Changed initial settings of textedit.ini to connect the left and right edges of the prediction conversion window, making it easier to convert single kanji characters.
• Saved clipboard (copy-paste buffer) and made it possible to paste into other files.
• Reversed the button layout for kana/Kana input mode.
• Added ability to copy & paste with L button as well as R button. (L+X/Y is for backlight adjustment, L+up/down/left/right only).

Not Fixed:

• The bug where DPG video files may stop playing has not been fixed this time.

External links

• Author's website - http://home.att.ne.jp/blue/moonlight