Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

MoonShell: Difference between revisions

From GameBrew
m (Text replacement - "type=Media players" to "type=Media Players")
(update some info and old versions..)
Line 4: Line 4:
|description=Well known multimedia player.
|description=Well known multimedia player.
|author=Moonlight, Infantile Paralysiser
|author=Moonlight, Infantile Paralysiser
|lastupdated=2010/08/31
|lastupdated=2012/05/04
|type=Media Players
|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
|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==
==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==
==User guide==
Line 85: Line 100:


===Screen capture===
===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===
===Misc tools===
Line 142: Line 157:


==Controls==
==Controls==
'''File list:'''
===File list===
'''Standard:'''


Up/Down/Left/Right - Move cursor
Up/Down/Left/Right - Move cursor
Line 148: Line 164:
A - Open file
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
X/Y - Change volume
Line 160: Line 176:
Select - Open sub menu
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
Up/Down/Left/Right - Screen scroll
Line 184: Line 232:
B - Back to file list
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
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
Left/Right - Previous or next 5sec seeking
Line 196: Line 249:
Up/Down - Previous or next 30sec seeking
Up/Down - Previous or next 30sec seeking


A - Toggle pause
A - Pause video


B - Back to file list
B - Back to file list


Start/Select - Open setting window
Start/Select - Open settings menu


X/Y - Change volume
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==
==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==
==External links==
* Author's website - http://home.att.ne.jp/blue/moonlight
* Author's website - http://home.att.ne.jp/blue/moonlight


[[Category:Media Players on DS]]
[[Category:Media Players on DS]]

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

MoonShell
Moonshell.png
General
AuthorMoonlight, Infantile Paralysiser
TypeMedia Players
Version2.1.0 child zwai
LicenseGPL-2.0
Last Updated2012/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) 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

moonshell2.png moonshell5.png

moonshell3.png moonshell4.png

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

Advertising: