From WikiTemp, the GBAtemp wiki
Line 27: Line 27:
  
 
== How do I install YSMenu? ==
 
== How do I install YSMenu? ==
 +
<span style="color:#CC0000;">If you have an R4 there's installation instructions [http://gbatemp.net/index.php?showtopic=97615 Here]</span>
 +
 
To install TTMenu and YSMenu for DSTT, It's recommended that you make a backup of your microSD card, reformat it using the [http://panasonic.jp/support/global/cs/sd/download/sd_formatter.html Panasonic formatter], then follow these directions carefully:
 
To install TTMenu and YSMenu for DSTT, It's recommended that you make a backup of your microSD card, reformat it using the [http://panasonic.jp/support/global/cs/sd/download/sd_formatter.html Panasonic formatter], then follow these directions carefully:
  
Make sure you have the newest version of YSMenu (see above for directions on how to obtain it), the official TTMENU folder, and the fake-killer-disabled TTMENU.DAT from this archive: [http://gbatemp.net/index.php?download=4086 http://gbatemp.net/index.php?download=4086]
+
Make sure you have the newest version of YSMenu, the official TTMENU folder, and the fake-killer-disabled TTMENU.DAT from this archive: [http://gbatemp.net/index.php?download=4086 http://gbatemp.net/index.php?download=4086]
  
 
:* Unzip the official TTMenu archive. Place ONLY the "TTMENU" folder onto your microSD card.  
 
:* Unzip the official TTMenu archive. Place ONLY the "TTMENU" folder onto your microSD card.  
<span style="color:#990000;">
+
<span style="color:#AA0000;">
 
:    '''Do NOT copy TTMENU.DAT from the official menu as it contains fake-killer code.'''
 
:    '''Do NOT copy TTMENU.DAT from the official menu as it contains fake-killer code.'''
 
:    '''This will destroy your DSTT card if it's a "fake" '''
 
:    '''This will destroy your DSTT card if it's a "fake" '''
Line 64: Line 66:
 
When you're done, you should have the following files and folders on your microSD card:
 
When you're done, you should have the following files and folders on your microSD card:
  
<span style="color:#006699;">
 
 
   YSMenu.nds (YSMenu)
 
   YSMenu.nds (YSMenu)
 
   TTMenu.nds (fake-killer-disabled version of TTMenu)
 
   TTMenu.nds (fake-killer-disabled version of TTMenu)
Line 78: Line 79:
 
   Games (games folder)
 
   Games (games folder)
 
       |_ your .nds files go here
 
       |_ your .nds files go here
</span>
+
 
 
== How do you use it ? ==
 
== How do you use it ? ==
 
:* Use 'D-pad' to move (Up/Down - Move by 1 file, Left/Right - Move a Page at a time)
 
:* Use 'D-pad' to move (Up/Down - Move by 1 file, Left/Right - Move a Page at a time)
Line 86: Line 87:
 
:**  If file is SAV: Press [A] to create a backup ('BAK')
 
:**  If file is SAV: Press [A] to create a backup ('BAK')
 
:**  If file is BAK: Press [A] to restore & overwrite existing SAV
 
:**  If file is BAK: Press [A] to restore & overwrite existing SAV
:* Press [ B ] to Exit or go back  
+
:* Press [B] to Exit or go back  
 
:* Highlight any file and press [X] to Delete
 
:* Highlight any file and press [X] to Delete
 
:* Press [Start] to be able to select either 'Passme' function / 'Boot to GBA' or return to normal 'DS Menu' (the one that contains Pictochat & Settings)
 
:* Press [Start] to be able to select either 'Passme' function / 'Boot to GBA' or return to normal 'DS Menu' (the one that contains Pictochat & Settings)
Line 95: Line 96:
 
== Customising ? ==  
 
== Customising ? ==  
 
Unfortunately YSMenu does not allow much in the way of customising Skins/Themes like a R4 or Acekard.
 
Unfortunately YSMenu does not allow much in the way of customising Skins/Themes like a R4 or Acekard.
:although it does allow you to have a different background showing on both screens.
+
<br/>
 +
although it does allow you to have a different background showing on both screens.
  
 
To do this all that's needed is 2 pictures of size 256 x 192 labelled 'YSMenu1.bmp' (for the top screen) and 'YSMenu2.bmp' (for the bottom screen).
 
To do this all that's needed is 2 pictures of size 256 x 192 labelled 'YSMenu1.bmp' (for the top screen) and 'YSMenu2.bmp' (for the bottom screen).
Line 104: Line 106:
  
 
<span style="color:#006699;">
 
<span style="color:#006699;">
:[FILELIST]
+
[FILELIST]
: ; COLOR = BIT15 | BGR(5bit x3)
+
; COLOR = BIT15 | BGR(5bit x3)
:COLOR_PATH=0xFFFF (Ink colour of the Directory Path shown @ top of top screen)
+
COLOR_PATH=0xFFFF (Ink colour of the Directory Path shown @ top of top screen)
:COLOR_FILE=0xFFFF (Ink colour of Filename (nds/txt/gba etc) on top screen)
+
COLOR_FILE=0xFFFF (Ink colour of Filename (nds/txt/gba etc) on top screen)
:COLOR_FOLDER=0x80FF (Ink colour of Folders on top screen)
+
COLOR_FOLDER=0x80FF (Ink colour of Folders on top screen)
:COLOR_SELECT=0xFC00 (Background colour of Filename when highlighted)
+
COLOR_SELECT=0xFC00 (Background colour of Filename when highlighted)
:COLOR_SELTEXT=0x801F (Ink colour of filename when highlighted)
+
COLOR_SELTEXT=0x801F (Ink colour of filename when highlighted)
:-
+
-
:[FILEINFO]
+
[FILEINFO]
:COLOR_TEXT=0x80F0 (Ink colour of Text shown in bottom screen)
+
COLOR_TEXT=0x80F0 (Ink colour of Text shown in bottom screen)
:DRAW_FRAME=true (Set to 'false' with NOT display a background box on bottom screen behind Game title text)
+
DRAW_FRAME=true (Set to 'false' with NOT display a background box on bottom screen behind Game title text)
 
</span>
 
</span>
  
To determine the Hex code for the colour you can pop along to [http://www.conradshome.com/html2bgr15/ http://www.conradshome.com/html2bgr15/] to make things easier
+
To determine the Hex code for the colour you can pop along to [http://www.conradshome.com/html2bgr15/ http://www.conradshome.com/html2bgr15/] that make it easier
  
There is a homebrew software called 'SkinselecterYS' [http://www7.atpages.jp/torasoft/ Here] that can be used to swap the background Pictures/Colour scheme. Unfortunately the readme file is in Japanese but you can see how to use it in [http://gbatemp.net/index.php?showtopic=142136&st=15 This Thread]
+
There is also a homebrew software called 'SkinselecterYS' [http://www7.atpages.jp/torasoft/ Here] that can be used to swap the background Pictures/Colour scheme of multiple Skins installed on the DSTT.
 +
<br/>Unfortunately the readme file is in Japanese but you can see how to use it in [http://gbatemp.net/index.php?showtopic=142136&st=15 This Thread]
  
 
== 'YSMenu.ini' Options ==
 
== 'YSMenu.ini' Options ==
'''[YSMENU]'''
+
;[YSMENU]
 
:You can change the language by place a ';' in front of any of the 'LITERALS=' to disable it & remove the ';' to enable it (As mentioned before in 'Setting up')
 
:You can change the language by place a ';' in front of any of the 'LITERALS=' to disable it & remove the ';' to enable it (As mentioned before in 'Setting up')
 
:Further down the file you will find sections labelled [LITERALS_???] (where ??? is a language e.g JAP).
 
:Further down the file you will find sections labelled [LITERALS_???] (where ??? is a language e.g JAP).
Line 129: Line 132:
 
:In theory you could create additional languages by copying/Pasting an existing [LITERALS_???] section (Changing the section header to something else like '[LITERALS_GER]' for German) & changing the text in the section, then by adding a LITERALS=LITERALS_GER under [YSMENU]
 
:In theory you could create additional languages by copying/Pasting an existing [LITERALS_???] section (Changing the section header to something else like '[LITERALS_GER]' for German) & changing the text in the section, then by adding a LITERALS=LITERALS_GER under [YSMENU]
  
'''SORT_BY_TIME='''
+
;SORT_BY_TIME=
 
:Changing this to 'True' will cause the files to be shown depending upon the time they were last used instead of the normal 'alphabetically sorted'.  
 
:Changing this to 'True' will cause the files to be shown depending upon the time they were last used instead of the normal 'alphabetically sorted'.  
 
:In other words the games you play more often will appear near the top, while the lesser played ones are at the bottom. (this is determined by the game SAV time stamp)
 
:In other words the games you play more often will appear near the top, while the lesser played ones are at the bottom. (this is determined by the game SAV time stamp)
  
'''VERSION='''
+
;VERSION=
 
:Whatever is put here will replace the 'Yasu Software - YS menu' text @ the bottom of the touch screen.
 
:Whatever is put here will replace the 'Yasu Software - YS menu' text @ the bottom of the touch screen.
 
:When touched - the version text will still be shown in Black ink though
 
:When touched - the version text will still be shown in Black ink though
  
'''NO_DEL='''
+
;NO_DEL=
 
:Changing this to 'true' will prevent you from using the [X] button to delete files.
 
:Changing this to 'true' will prevent you from using the [X] button to delete files.
 
:Handy if you want to prevent any little ones from deleting your current SAV by mistake
 
:Handy if you want to prevent any little ones from deleting your current SAV by mistake
  
'''DEFAULT_DMA=''' / '''DEFAULT_RESET='''
+
;DEFAULT_DMA= / DEFAULT_RESET=
 
:Change from 'false' to 'true' (or 'true' to 'false') will cause all programs to have the appropriate option box ticked/unticked by default
 
:Change from 'false' to 'true' (or 'true' to 'false') will cause all programs to have the appropriate option box ticked/unticked by default
  
'''EXT_APP1_FILE=''' / '''EXT_APP1_NAME='''
+
;EXT_APP1_FILE= / EXT_APP1_NAME=
 
:This will cause an extra button to appear when you press [Start] for the 'Passme' / 'Boot GBA' option screen
 
:This will cause an extra button to appear when you press [Start] for the 'Passme' / 'Boot GBA' option screen
 
:Clicking on the extra button will start the program mentioned in 'EXT_APP1_FILE'
 
:Clicking on the extra button will start the program mentioned in 'EXT_APP1_FILE'
 
:You can in fact have more than just the one extra button - Just by adding 'EXT_APP2_FILE=' and 'EXT_APP2_NAME=' (up to 'EXT_APP9_FILE'/'EXT_APP9_NAME')
 
:You can in fact have more than just the one extra button - Just by adding 'EXT_APP2_FILE=' and 'EXT_APP2_NAME=' (up to 'EXT_APP9_FILE'/'EXT_APP9_NAME')
  
'''[FILETYPE]'''
+
;[FILETYPE]
 
:Adding a file format will allow that particular file to show up in YSMenu file browser (e.g. TXT/BMP/MP3 etc).  
 
:Adding a file format will allow that particular file to show up in YSMenu file browser (e.g. TXT/BMP/MP3 etc).  
 
:Note that I haven't figured out how to launch an appropiate program for any additional formats or even if it's possible
 
:Note that I haven't figured out how to launch an appropiate program for any additional formats or even if it's possible
Line 155: Line 158:
 
:Some files have already been set up for GBA/NES/NeoGeo/Sega Master System and WonderSwan [?!?] emulation  
 
:Some files have already been set up for GBA/NES/NeoGeo/Sega Master System and WonderSwan [?!?] emulation  
 
:- these require additional programs installed into the YSMenu folder, along with a Slot 2 Flash card like the EZ3-in-1, to work
 
:- these require additional programs installed into the YSMenu folder, along with a Slot 2 Flash card like the EZ3-in-1, to work
 +
 +
 +
== Downloads==
 +
 +
{| border="1" cellpadding="0" cellspacing="1"
 +
! colspan="3" |Skins
 +
|-
 +
|YSDSTT: [http://gbatemp.net/index.php?download=5171 Download]
 +
|GBATemp: [http://gbatemp.net/index.php?download=4833 Download]
 +
|Zelda: [http://gbatemp.net/index.php?download=4696 Download]
 +
|-
 +
|NDS menu: [http://gbatemp.net/index.php?download=3082 Download]
 +
|Beatles: [http://gbatemp.net/index.php?download=4243 Download]
 +
|Sephiroth: [http://gbatemp.net/index.php?download=5038 Download]
 +
|-
 +
|NintendoVN: [http://gbatemp.net/index.php?download=3291 Download]
 +
|Dodge Viper: [http://gbatemp.net/index.php?download=4689 Download]
 +
|Rockstar: [http://gbatemp.net/index.php?download=5080 Download]
 +
|-
 +
! colspan="3" | Others
 +
|-
 +
|Fake-killer-disabled TTMENU.DAT: [http://gbatemp.net/index.php?download=4086 Download]
 +
|YSMenu Automated Installer: [http://gbatemp.net/index.php?download=4809 Download]
 +
|SkinselecterYS (Homebrew): [http://www7.atpages.jp/torasoft/ Download]
 +
|-
 +
|Panasonic MicroSD formatter: [http://panasonic.jp/support/global/cs/sd/download/sd_formatter.html Download]
 +
|
 +
|
 +
|}
  
 
== Credits ==
 
== Credits ==

Revision as of 16:57, 26 March 2009

YSMenu

What Is YSMenu ?

YSMenu is a homebrew version of the ttmenu that loads faster than the original menu and looks similar to an unskinned r4 menu.

Advantages of YSMenu over TTMenu:
+ It sorts the roms alphabetically (TTMenu sorts by order of installation)
+ It shows folders allowing you to organize your roms into separate 'Groups'
(TTMenu shows all 'NDS' file in one long list [even 'plugins' from programs like moonshell2])
+ It attempts to patch the browser and GBA games without having to use a separate loader program
+ It runs emulated programs directly in the emulator in one step.
Disadvantages of YSMenu over TTMenu:
- Not graphically 'Pretty'
- It doesn't support Multiple 'Skins/Themes' (It's possible using 3rd party Homebrew - see later)
- Uses Official DSTT loaders - so any problems with DSTT then this will not fix them
- Default Language/Help is Japanese, so some editing required to get English

Where do I get it?

YSMenu is created by Yasu who doesn’t want anyone to link to any pages other than his home page.

Yasu’s home page is http://home.usay.jp/. It's mostly in Japanese, but to get YSMenu, follow these directions:
  • Click the "ETC" button in the main menu near the top beneath the title.
  • Select "Nintendo DS" (second item) from the table.
  • Search for "DS(T_T)DS" (CTRL-F) or just scroll about 2/3 of the way down until you see the heading in blue.
  • There is a scrollable text area beneath that heading. Select the first item in the scollable list (currently "2009/03/21") to download the latest version.

How do I install YSMenu?

If you have an R4 there's installation instructions Here

To install TTMenu and YSMenu for DSTT, It's recommended that you make a backup of your microSD card, reformat it using the Panasonic formatter, then follow these directions carefully:

Make sure you have the newest version of YSMenu, the official TTMENU folder, and the fake-killer-disabled TTMENU.DAT from this archive: http://gbatemp.net/index.php?download=4086

  • Unzip the official TTMenu archive. Place ONLY the "TTMENU" folder onto your microSD card.

Do NOT copy TTMENU.DAT from the official menu as it contains fake-killer code.
This will destroy your DSTT card if it's a "fake"

  • Unzip the YSMenu archive.
  • Create a folder named "YSMenu" on your microSD card.
  • Place a copy of the fake-killer-disabled "TTMENU.DAT" into the same folder as the "ttextract.exe" program on your PC.
  • Run "ttextract.exe" on your PC.
  • Place the two resulting files ("ttdldi.dat" and "ttpatch.dat") into the "YSMenu" folder on your microSD card.
  • (a) If you want "YSMenu" to be your default menu, rename the fake-killer-disabled "TTMENU.DAT" to "TTMenu.nds" and place it onto the root (top level) of your microSD card.
    • Then place a copy of "YSMenu.nds" onto the root of your microSD card.
    • Then make a copy of "YSMenu.nds" & rename that to "TTMENU.DAT" & place it also on the root of your microSD card.
  • (b) If you want "TTMenu" to be the default menu, place a copy of the fake-killer-disabled TTMENU.DAT onto the root (top level) of your microSD card.
    • Then place a copy of "YSMenu.nds" onto the root of your microSD card.
    • Then make a copy of "TTMENU.DAT" & rename it to "TTMenu.nds" on the root of your card.

You should now have "TTMenu.nds", "YSMenu.nds", and "TTMENU.DAT" (a copy of "TTMENU.DAT" or "YSMenu.nds" depending on your choice) on the root of your microSD card.

  • Edit "YSMenu.ini". Place a semi-colon in front of the line that says "LITERALS=LITERALS_JPN" & Remove the semi-colon from the line that says "LITERALS=LITERALS_ENG".
  • Save your changes to "YSMenu.ini" and place it into the "YSMenu" folder on your microSD card.
  • Make a new folder named "Games" and put a few .nds files in it.
  • Use the "safely remove hardware" utility before removing your microSD card from your PC
  • Place the DSTT into the NDS, place the microSD card into the DSTT, and turn on the NDS.

That should be it.

If you are using TTMenu as your default, simply run "YSMenu.nds" to get to YSMenu. Otherwise, it should launch directly into YSMenu and you can run "TTMenu.nds" to get back to TTMenu.

When you're done, you should have the following files and folders on your microSD card:

  YSMenu.nds (YSMenu)
  TTMenu.nds (fake-killer-disabled version of TTMenu)
  TTMENU.DAT (a copy of whichever of the above two you want as your default menu)
  YSMENU (YSMenu firmware folder)
     |_ YSMenu.ini (YSMenu init file)
     |_ ttdldi.dat (extracted from the fake-killer-disabled loader using ttextract.exe)
     |_ ttpatch.dat (extracted from the fake-killer-disabled loader using ttextract.exe)
     |_ YSMenu1.bmp (optional skin: See later)
     |_ YSMenu2.bmp (optional skin:See later)
  TTMENU (official firmware folder)
     |_ all the files from the official TTMENU folder are here
  Games (games folder)
     |_ your .nds files go here

How do you use it ?

  • Use 'D-pad' to move (Up/Down - Move by 1 file, Left/Right - Move a Page at a time)
  • Highlight a file and press [A] to Launch
    • If file is NDS: Press [Y] to select cheat codes
    • If file is GBA: Press [Y] to just load GBA to PSRAM in slot 2 (What is PSRAM? - See This)
    • If file is SAV: Press [A] to create a backup ('BAK')
    • If file is BAK: Press [A] to restore & overwrite existing SAV
  • Press [B] to Exit or go back
  • Highlight any file and press [X] to Delete
  • Press [Start] to be able to select either 'Passme' function / 'Boot to GBA' or return to normal 'DS Menu' (the one that contains Pictochat & Settings)
  • Press [Select] to change file listing to show: Only 'nds' / Only 'Sav'/ All files (even hidden)
  • Tap the top left of the touch screen to alter screen brightness
  • Tap on 'Yasu Software - YS menu' will reveal the Version you have (In black ink, so you may not be able to read it if you have a dark background)

Customising ?

Unfortunately YSMenu does not allow much in the way of customising Skins/Themes like a R4 or Acekard.
although it does allow you to have a different background showing on both screens.

To do this all that's needed is 2 pictures of size 256 x 192 labelled 'YSMenu1.bmp' (for the top screen) and 'YSMenu2.bmp' (for the bottom screen). These need to be placed in the 'YSMenu' folder on your MicroSD card

You can also alter the colours of the text used for Directory Path/File names etc by editing the 'YSMenu.ini' file also found in the YSMenu folder The section required is

[FILELIST]
; COLOR = BIT15 | BGR(5bit x3)
COLOR_PATH=0xFFFF (Ink colour of the Directory Path shown @ top of top screen)
COLOR_FILE=0xFFFF (Ink colour of Filename (nds/txt/gba etc) on top screen)
COLOR_FOLDER=0x80FF (Ink colour of Folders on top screen)
COLOR_SELECT=0xFC00 (Background colour of Filename when highlighted)
COLOR_SELTEXT=0x801F (Ink colour of filename when highlighted)
-
[FILEINFO]
COLOR_TEXT=0x80F0 (Ink colour of Text shown in bottom screen)
DRAW_FRAME=true (Set to 'false' with NOT display a background box on bottom screen behind Game title text)

To determine the Hex code for the colour you can pop along to http://www.conradshome.com/html2bgr15/ that make it easier

There is also a homebrew software called 'SkinselecterYS' Here that can be used to swap the background Pictures/Colour scheme of multiple Skins installed on the DSTT.
Unfortunately the readme file is in Japanese but you can see how to use it in This Thread

'YSMenu.ini' Options

[YSMENU]
You can change the language by place a ';' in front of any of the 'LITERALS=' to disable it & remove the ';' to enable it (As mentioned before in 'Setting up')
Further down the file you will find sections labelled [LITERALS_???] (where ??? is a language e.g JAP).
By altering the text to the right of the '=' You can get YSMenu to display whatever you like (e.g. if you change 'LOADING=Please Wait...' then YSMenu will show 'Please Wait...' instead of 'Loading...')
In theory you could create additional languages by copying/Pasting an existing [LITERALS_???] section (Changing the section header to something else like '[LITERALS_GER]' for German) & changing the text in the section, then by adding a LITERALS=LITERALS_GER under [YSMENU]
SORT_BY_TIME=
Changing this to 'True' will cause the files to be shown depending upon the time they were last used instead of the normal 'alphabetically sorted'.
In other words the games you play more often will appear near the top, while the lesser played ones are at the bottom. (this is determined by the game SAV time stamp)
VERSION=
Whatever is put here will replace the 'Yasu Software - YS menu' text @ the bottom of the touch screen.
When touched - the version text will still be shown in Black ink though
NO_DEL=
Changing this to 'true' will prevent you from using the [X] button to delete files.
Handy if you want to prevent any little ones from deleting your current SAV by mistake
DEFAULT_DMA= / DEFAULT_RESET=
Change from 'false' to 'true' (or 'true' to 'false') will cause all programs to have the appropriate option box ticked/unticked by default
EXT_APP1_FILE= / EXT_APP1_NAME=
This will cause an extra button to appear when you press [Start] for the 'Passme' / 'Boot GBA' option screen
Clicking on the extra button will start the program mentioned in 'EXT_APP1_FILE'
You can in fact have more than just the one extra button - Just by adding 'EXT_APP2_FILE=' and 'EXT_APP2_NAME=' (up to 'EXT_APP9_FILE'/'EXT_APP9_NAME')
[FILETYPE]
Adding a file format will allow that particular file to show up in YSMenu file browser (e.g. TXT/BMP/MP3 etc).
Note that I haven't figured out how to launch an appropiate program for any additional formats or even if it's possible
Some files have already been set up for GBA/NES/NeoGeo/Sega Master System and WonderSwan [?!?] emulation
- these require additional programs installed into the YSMenu folder, along with a Slot 2 Flash card like the EZ3-in-1, to work


Downloads

Skins
YSDSTT: Download GBATemp: Download Zelda: Download
NDS menu: Download Beatles: Download Sephiroth: Download
NintendoVN: Download Dodge Viper: Download Rockstar: Download
Others
Fake-killer-disabled TTMENU.DAT: Download YSMenu Automated Installer: Download SkinselecterYS (Homebrew): Download
Panasonic MicroSD formatter: Download

Credits

Most of this is already in the forums somewhere done by other people, So Many Thanks to the following :-

KermitFrog - For Putting it all together & adding the 'YSMenu.ini' info
Bri - For 'Where to get it'/Installation
Ozzymud - For creating the 15Bit color converter webpage
Bidoofguy - For figuring out how to use 'SkinSelecterYS'
Apocalypticvisionary / Swip / 8BitWalugi - For other small little titbits of info on YSmenu Usage