MoonShell: Difference between revisions

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

Revision as of 07:22, 9 Mayıs 2024

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) focused 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). 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

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

@@ Line 4: / Line 4: @@
 |description=Well known multimedia player.
 |author=Moonlight, Infantile Paralysiser
-|lastupdated=2010/08/31
+|lastupdated=2012/05/04
 |type=Media Players
-|version=2.10 Stable
+|version=2.1.0 child zwai
-|license=Mixed
+|license=GPL-2.0
-|download=https://dlhb.gamebrew.org/dshomebrew/moonshell.7z
+|downloadraw=[https://dlhb.gamebrew.org/dshomebrew/moonshell.7z?k33p0fil35 2.1.0 Stable, Child Zwai + Patch]<br>[https://dlhb.gamebrew.org/dshomebrew/moonshello.7z?k33p0fil35 Old Versions]
 |website=http://home.att.ne.jp/blue/moonlight
-|source=https://dlhb.gamebrew.org/dshomebrew/moonshell.7z
+|source=https://dlhb.gamebrew.org/dshomebrew/moonshello.7z
 }}
-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.
+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==
-*Insert your Flashcard microSD card into your PC card reader.
+There are 2 versions in the archive, stable and child zwai (intended for DSi, DSiLL or ROMEO2).
-*Run the EXE to extract the files.
-*In the extracted file is a program called Setup.exe - Run this.
-*Select the drive that represents your MicroSD card and click on "Install to ...".
-*In the next box select the "Open More" box if you want to install any addons/tools (e.g. dustbox/Moonmemo/extra languages/plugins).
-*Click the Update button to continue. Moonshell will then install all the necessary files to your MicroSD card.
-It is also recommended that after it has been installed - you should run the LanguageSelect.exe file to select the correct language. If you don't use this program - then you should run the "moonshl2.nds" file first when you've inserted your Flashcard & switched on.
+The updated version (child zwai) focused 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.
-*Remove your MicroSD card from your PC & insert into your Flashcard.
+The improved sound quality is only noticeable when using DSi/DSiLL or [https://www.itplaza.co.jp/opti/NDS/romeo2.html ROMEO2] (a slot2 sound board). There will be little improvement in sound quality when using NDS/DSLite alone despite the slowdown.
-*Insert into your DSPhat/DSLite/DSi & switch on.
-*Run either moonshl2.nds or moonshl2_directboot.nds to run.
-Alternatively you just need to copy over the moonshl2 folder, moonshl2.nds and moonshl2_directboot.nds files to the root of your MicroSD Card.
+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
+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==
@@ Line 85: / Line 100: @@
 ===Screen capture===
-The screen capture can be preserved by keeping pushing the Select button for 3 seconds or more on an arbitrary screen.
+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).
-NDS stops when succeeding in preservation. Please open the made BMP file with Windows.
+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 the memory is insufficient, it is not possible to make it.
+When capturing on DSi, please check "Enable Screen Capture Function (DSi)" in the overall environment settings.
 ===Misc tools===
@@ Line 142: / Line 157: @@
 ==Controls==
-'''File list:'''
+===File list===
+'''Standard:'''
 Up/Down/Left/Right - Move cursor
@@ Line 148: / Line 164: @@
 A - Open file
-A (hold) - When music file, Open music player
+A (hold) - Start the music player if it's a music file
-B - Stop music
+B - Stop music (exit the folder when stopped)
 X/Y - Change volume
@@ Line 160: / Line 176: @@
 Select - Open sub menu
-Select (hold) - Get screen capture (exclude DSi)
+Select (hold) - Screen capture (DSi default to adjust brightness, can be changed in settings)
-'''Text reader:'''
+R Triple Click - Start standby mode (power off after 10 minutes of inactivity)
-Up/Down - Line scroll
+'''Key combos:'''
-Left/Right - Page scroll
+L/R+Touch - Start Notepad in new document creation mode
-A - Page scroll
+L+Left - Show MP3 control panel
-B - Back to file list
+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
-X/Y - Open bookmark save or load menu
+'''Key combos:'''
-Start/Select - Open setting window
+L/R+X/Y - Adjust backlight brightness
-'''Image viewer:'''
+===Image viewer===
+'''Standard:'''
 Up/Down/Left/Right - Screen scroll
@@ Line 184: / Line 232: @@
 B - Back to file list
-Start - Set to background image
+Start - Set current image as wallpaper
-Select - Open setting window
+Select - Open settings menu
 L/R - Start direct moving mode
-'''Movie player:'''
+'''Key combos:'''
+L/R+X/Y - Adjust backlight brightness
+===Video playback===
+'''Standard:'''
 Left/Right - Previous or next 5sec seeking
@@ Line 196: / Line 249: @@
 Up/Down - Previous or next 30sec seeking
-A - Toggle pause
+A - Pause video
 B - Back to file list
-Start/Select - Open setting window
+Start/Select - Open settings menu
 X/Y - Change volume
-==Media==
+'''Key combos:'''
-'''NDS HomeBrew #1 - Moonshell 2.10 in 2022''' ([https://www.youtube.com/watch?v=vpPwp2KS8-c Al1en99]) <br>
-<youtube>vpPwp2KS8-c</youtube>
+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
-==Known issues==
+==Screenshots==
-A bug that FileTrip Download Link moonshell sometimes stops in playing DPG isn't fixed this time.
+https://dlhb.gamebrew.org/dshomebrew/moonshell2.png
+https://dlhb.gamebrew.org/dshomebrew/moonshell5.png
-Message file update of notepad and submenu isn't done yet.
+https://dlhb.gamebrew.org/dshomebrew/moonshell3.png
+https://dlhb.gamebrew.org/dshomebrew/moonshell4.png
 ==Changelog==
-'''v2.10 stable'''
+'''v2.10 child zwai update 2012/05/04'''
-* Playback of MDX (software emulation so sound is worse than MDXOffline).
+* Fixed a bug causing abnormal termination near the end of DPG file playback.
-* Play only audio in movie.
+* Fixed a bug in implementing touch panel combination commands (unable to seek by long press).
-* Output audio in movie to ROMEO2.
+* Added an option to play DPG files on the lower screen to moonshl2.ini. Please refer to moonshl2_DPGOption.ini.
-* 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).
+'''v2.10 for child zwai 2010/08/31'''
-* Drastic update in MoonMemo (Check Right/Left, X/Y).
+* Added support for MDX file playback (since it's software emulation, the quality is lower than MDXOffline).
-* Fixed a bug that thumbnail wasn`t updated after modifying real image.
+* Added option to output only video audio (useful for web radio, etc.).
-* Added equalizer to music player. Use R+Up/Down/Left/Right or touchpanel to modify (same for ROMEO2).
+* Added support for outputting video audio from Romeo2.
-* Fixed a bug that auto DLDI patching wasn`t applied when you launch big homebrew.
+* A button long-press selection for playlist editor only within the same folder as playback mode.
-* You can control music playback in screen saver. Listen to sounds like "PiPi".
+* Added ChannelsMapSelector to the SELECT button submenu.
-* 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.
+* Significant changes to MoonMemo. (Try pressing the right/left, X/Y buttons).
-* Added ScreenSaver_ShowClock/ScreenSaver_ShowMusicInfo to moonshl2.ini [FileList] section to switch whether to show screensaver clock and music info.
+* Fixed bug where thumbnails were not updated when the content of an image changed in automatic thumbnail generation.
-* Fixed a bug that SJIS text couldn`t open in textreader if the memory wasn`t enough.
+* Added equalizer to music player. Adjust levels with R+up/down/left/right or touch screen. (Unified behavior with Romeo2).
-* Fixed a bug that jacket image wasn`t shown when you back to filelist from music player.
+* Fixed bug where automatic DLDI patch was not applied when launching large HomeBrew.
-* If you put cursor on BMP file, FileTrip Download Link moonshell shows simple preview.
+* 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.
-* In prompt to input new filename, you can erase all by pressing B but also cancel by pressing START/SELECT.
+* 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.
-* DPGEnc parameter was modified for recent CPU. You can encode 2-5x faster.
+* 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).
-Updates in text editor:
+Not Fixed:
-* Added "create new file" to SELECT submenu.
+* The bug where DPG video files may stop playing has not been fixed this time.
-* 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==
 * Author's website - http://home.att.ne.jp/blue/moonlight
 [[Category:Media Players on DS]]