//Moonshell Version 0.2+9 by Infantile Paralysiser\\
//gbamp_cf.c by chishm                            \\
//GBAMP CF I/O  test r9 by SaTa                   \\
//English ReadMe by zubiac, Russian ReadMe by Kir \\

official site: http://mdxonline.dyndns.org/archives/nds/

------------------------
Moonshell functions:

Moonshell is a multi format-file player/viewer for the Nintendo DS.
It supports playing DVM videofiles, MP3/NSF soundfiles and viewing Jpeg/BMP/PNG/TXT images/pictures/files.
Moonshell uses both screens and touchscreen input.

------------------------
Needed things:

GBA Movie Player(avaiable at liksang.com) updated with chishm's firmware hack (get it here:http://www.geocities.com/chishm1/gbamp/flashmp_mb.zip   ;more info here:http://forum.gbadev.org/viewtopic.php?t=6325)
 or a 
GBA FlashCart (F2A)
Moonshell v.0.2+9 (get it here: http://mdxonline.dyndns.org/archives/nds/)
PassME (info here: http://www.dspassme.com/)
  or
FlashME (info here: http://ds.gcdev.com/dsfirmware/)
  or
WifiMe  (info here: http://www.aaronrogers.com/nintendods/wifime.php)

-------------------------
Starting Moonshell:

For use with GBAMP:
Download the moonshell.zip file(from http://mdxonline.dyndns.org/archives/nds/) and unzip it.
Flash the _BOOT_MP.nds file (togehther with DVM/MP3/NSF/Jpeg/BMP/PNG files of your choice; subdirs are also supported) to the root dir of your CF card.
Boot Moonshell via "FlashMe", "PassMe" or "WifiMe" and enjoy.

For use with Flashcart(F2A):
Download moonshell.zip file(from http://mdxonline.dyndns.org/archives/nds/) and unzip it.
Copy your DVM/MP3/NSF/Jpeg/BMP/PNG files into "files_gbfs" folder.
Run "WriteFile_gbfs"
Flash _BOOT_MP_gbfs.ds.gba to your FlashCart.
Boot Moonshell via "FlashMe" or "PassMe" and enjoy.

-------------------------
Changing Codepage:

Simply execute the cp???.bat file(in folder "ChangeCodePage") of your choice(see list below).
The _BOOT_MP.nds file will be updated.(Note for Flashcart user: run "WriteFiles_gbfs.bat" afterwards to create .ds.gba file)

Default CodePage settings:
cp0.bat    / ank only     / small memory package.
cp874.bat  / windows-874  / Thai (Windows)
cp932.bat  / shift-jis    / Japanese (Shift-JIS)
cp936.bat  / gb2312       / Chinese Simplified (GB2312)
cp950.bat  / big5         / Chinese Traditional (Big5)
cp1250.bat / windows-1250 / Central European Alphabet (Windows)
cp1251.bat / windows-1251 / Cyrillic Alphabet (Windows)
cp1252.bat / windows-1252 / Western Alphabet (Windows)
cp1253.bat / windows-1253 / Greek Alphabet (Windows)
cp1254.bat / windows-1254 / Turkish Alphabet
cp1255.bat / windows-1255 / Hebrew Alphabet (Windows)
cp1256.bat / windows-1256 / Arabic Alphabet (Windows)
cp1257.bat / windows-1257 / Baltic Alphabet (Windows)
cp1258.bat / windows-1258 / Vietnamese Alphabet (Windows)

---------------------------
Global.ini settings: 

Contents 

1. [System] 
  1.1 StartPath 
  1.2 FileSelectSubScreen 
  1.3 ClosedSholderButtons 
  1.4 MusicNext 
  1.5 FullScreenOverlaySubScreen

2. [TextPlugin] 
  2.1 SpacePixel

3. [Boot]
  3.1 hiddenAboutWindow
  3.2 hiddenHelpWindow
  3.3 hiddenDateTimeWindow
 

------------ 

1. [System] 



1.1 Startpath = //Path/to/folder  ( Default = // ) 

Defines folder to be displayed in FileBrowser after boot. 
Can be something like '//MPCF' (to start browsing directly from CF), 
or '//GBFS' (to start browsing directly from flashcart's GBFS ). 


1.2 FileSelectSubScreen = [0|1]  (Default = 1 ) 

Defines which screen is used to display FileBrowser. 
0 = touchscreen, 
1 = normal screen. 


1.3 ClosedSholderButtons = [0|1|2]  (Default = 0 ) 

Defines L and R buttons behaviour. 
0 = when DS is closed, L & R are disabled. 
1 = when DS is closed, L & R are functioning normally. 
2 = L & R buttons are always disabled  


1.4 MusicNext = [0|1|2|3] (Default = 3 ) 

Defines audio file playback mode. 
0 = Play once, then stop. 
1 = Repeat endlessly 
2 = Play once, then play next file 
3 = Play once, then play random file (shuffle) 

1.5 FullScreenOverlaySubScreen = [0|1] (Default = 1)

Defines which screen is used to display video in fullscreen mode

0 = Touchscreen
1 = Normal screen

2. [TextPlugin] 

2.1 SpacePixel = [N]  (Default = 1) 

Defines distance between two lines of text in pixels. 
N can be any integer in [1..191-FontHeightInPixels] range. 

3. [Boot]

3.1 hiddenAboutWindow = [0|1] (Default = 0)
Defines status of About window.

0 = About window is enabled
1 = About window is disabled

3.2 hiddenHelpWindow = [0|1] (Default = 0)
Defines status of Help window.

0 = Help window is enabled
1 = Help window is disabled

3.3 hiddenDateTimeWindow = [0|1] (Default = 0)
Defines status of DateTime window.

0 = DateTime window is enabled
1 = DateTime window is disabled


To apply these settings, you must run WriteFiles_IMFS.bat after making changes. 

---------------------------
Changing desktop theme:

Replace the .BMP file in folder ".shell"(in "files") with your own BMP file.
BMP image must be 256 x 192 pixels.
Run Writefiles_IMFS.bat to update the _BOOT_MP.nds file.
Flash _BOOT_MP.nds to your CF card.
(Note for flashcart user: Run Writefiles_gbfs.bat instead of Writefiles_IMFS.bat to update _BOOT_MP.ds.gba file)

---------------------------
F.A.Q.:

Q: Moonshell is not booting!
A: Makes sure you have updated your GBAMP with chishm's firmware-hack and do not forget that you have to use either PassMe,FlashMe or WifiMe to boot .nds files from GBAMP.

Q: I have a flashcart. Am I able to use Moonshell too or is it just for GBAMP?
A: You can use it too. Just read the "ReadMe" file above.

Q: I have a Jpeg picture which won't show up! Why?
A: 2 possible reasons:  1) Moonshell's Jpeg viewer doesn't support progressive Jpegs. Make sure you do not save them as that.
                        2) There is actualy a sizelimit for Jpegs. Maximum width is 16384 pixels.
                           16000 x 12800 24bitColor 40 MByte Jpeg files are confirmed to work but they show up VERY slow.

---------------------------
For any questions and problems using Moonshell go to [ http://forum.gbadev.org/viewtopic.php?t=6560&start=75&postdays=0&postorder=asc&highlight= ]
                            