iMenu step-by-step set-up tutorial

Development has stopped for iMenu and spinal_code's site will not be coming back up, but he has released the source code for iMenu here: http://filetrip.net/nds-downloads/flashcart-files/download-imenu-source-10-f32186.html
There you go. Anyone who wants to continue this project may do so, but understand this, 1. My code isn't usually very tidy, so might not be very readable. 2. It's been a long time since I even looked at this, I doubt I could offer any help regarding it. 3. I'm not 100% sure that this is the latest version, but it was the latest one I could find on my hard drive.
Be sure to check out "How to Update EOS" in the Misc. section.



First, some information about iMenu
iMenu%20replaces%20b3.3.jpg

spinal_cord said:
Having used the new Superkard DSTwo for a little while now, I decided to make a new menu for it. The official one, although functional, isn’t really to my liking, so I started work on a new one.

I based this design on the iPod touch/iPhone ’springboard’ so basically it shows up to twelve icons on the screen, four can be docked to the bottom, the other eight can be scrolled sideways.
Earlier version of beta v3
v1


Features of iMenu
  • Uses all icons directly from the official menu
  • Shows up to 12 icons per screen
  • Loads both homebrew .nds and .plg files, and now commercial ROMs too (see Miscellaneous)
  • Anti aliased icon text
  • Can be used as a direct replacement for the official menu
  • Better homebrew compatibility than the official menu
  • D-Pad control with partial stylus/finger control
  • Any size clock (digital or analog)
  • Move/edit/delete/create icons in iMenu itself, no need to mess with .ini files!
  • Shoulder Buttons 'flip' pages
  • Multibooting (see Miscellaneous)
  • Arg support to launch directly into files on supported homebrew (see Miscellaneous)

How to set up iMenu (this is updated as of EOS version 1.11 (6-30-11) and iMenu beta v3.3)



0. If you don't already have an archive extractor (winrar, 7zip, winzip, etc.), download this and install it with the default settings. (it will bug you to pay but won't force you)

1. If you already have stuff on your MicroSD card, back it all up to your computer, then format your card using this formatter. (download is at the bottom of the page)

2. Download the latest official DSTwo firmware package from filetrip.

3. Extract the official firmware package into the root of your MicroSD card. (see what is the root?))
3.5. Optional: Updating your DSTwo to work on a 3DS
If you only have access to a 3DS, it is important that you update your firmware to 1.15 before you update the firmware on your 3DS. If you have access to a DS phat/lite/i/XL then you can update on any of those devices without worry as long as you have the latest EOS on the DSTWO.

Firmware 1.09 - works on 3DS's prior to v2.0.0-2
Firmware 1.12 - works on 3DS's on v2.2.0-4 and prior
Firmware 1.13 - works on 3DS's on v3.0.0-6 and prior
Firmware 1.15 - works on 3DS's on v4.0.0-7 and prior

1. Download firmware 1.15.

2. Extract "dstwoupdate.dat" to the root of your microsd card.

3. Put your microsd card into your DSTwo and insert it into a DS phat/lite/i/XL or your 3DS.

4. Turn on the DS and start the DSTwo, once you get to the plugin menu it should show a popup saying "Update system *your current firmware here* - 1.15", press A here to start updating. Make sure that you do NOT turn off or close the DS until it is finished upgrading.

5. If you did not see the popup, trying renaming "dstwoupdate.dat" to "ds2update.dat", then try it again.

You should now be on firmware 1.15, and dstwoupdate.dat (or ds2update.dat) should no longer be on your MicroSD card if it updated correctly.

-----------

If you started the update but it didn't finish, and now the DSTwo isn't recognized, you just get "Update error, enter than wait 3 minutes"
still in the process of trying to figure out a fix, read this thread for more info
possible fix is to download this and extract system1.dat into your _dstwo folder, then try the firmware update again
4. Download the latest version of iMenu from spinal_cord's site temporarily offline, use the mirror. (Filetrip Mirror)
download%20this%20(imenu)_3.3.JPG
5. Extract imenu.rar to the root of your MicroSD card, let it replace _dstwo/dstwo.nds

6. Extract this to the root of your MicroSD card and let it replace everything it has to.

7. Replace all of your ROMs and save files etc. from the backup if you created one in step 1 (you can just put all of the folders of the back-up on the root of your card) DO NOT OVERWRITE ANYTHING!!!!!!

8. Optional: If you want your DSTwo's microsd card to show up as the card itself on your PC, just extract this to the root of your sd card. (it will take affect the next time you plug in your microsd card)
DS2%20icon%20drive.JPG
9. Optional: If you want cheats, just download this and extract usrcheat.dat into the _dstwo folder. All of the cheats will automagically appear for each supported game. (if you ever want to update your cheats just click on that link again for the newest version and overwrite the old usrcheat.dat with the new one)

10. If the first time you turn on your ds and load iMenu it adds in a catsfc and iMenu icon (as well as any other homebrew you have in your /_dstwoplug/ folder), just press select on them and delete them, as catsfc is the same exact thing as the SNES icon, except uglier, and the iMenu icon is useless.

The basic set-up of iMenu is complete, enjoy .


If you ever want to experiment with skins, you can find them here.
You may also find them here, although they are installed using different methods.


How to add new icons

If there is a folder in the download extract it to the root of your card, extract the .nds file to the _dstwoplug folder.

if you can't get it to work see if there was a readme included in the download and follow the instructions


After you've downloaded all of the homebrew you want and put everything in the proper place on your microsd card, follow the mini guide below and skip step 2.

If the homebrew you're looking for isn't listed, then you will need to get an icon from somewhere else (step 2 on the mini guide below)

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

First, you need to understand how the icons work:
for every single icon, there is a corresponding .ini file in /_iMenu/_ini
the title of the .ini does not matter, but you should name it the same as the application that it's loading for organization's sake

This is what DSGame.ini looks like
<!--c1--><div class="codetop">CODE</div><div class="codemain"><!--ec1-->[plug setting]
icon=/_imenu/_images/icons/dsgame.bmp
name=DSGame
file=/_dstwo/dsgame.nds
number=0
dock=1
note=Official DSTwo game loader.
arg=<!--c2--></div><!--ec2-->
The icon= line is for the picture, which should be in /_imenu/_images/icons

the name= line is what the icon will be named within iMenu when you load it up

the file= line links to the file that you are loading, in this case dsgame.nds

the number= line is where your icon will be placed in iMenu, this is no big deal because you can move it while inside iMenu

the dock= line is either 0 to not have that icon on the dock or 1 to have it on the dock, there can be no more than 4 on the dock

the note= line is just a note that some skins display it doesn't matter what you put there (if the icon is for a commercial game you must put "dsgame" here without the quote)

the arg= line is used to load something in homebrew automatically (example being to put the path to a SNES game with the homebrew being CATSFC to automatically load that game when the icon is pressed)
Did you read all that? Good, because you will need to understand it to know how to make your own icons.

1. Copy one of the .ini files in /_iMenu/_ini and rename it to the homebrew you will be loading with it.

2. If the icon you want isn't already in your microsd card in /_iMenu/_images/icons, you will need to either get an image from one of the icon packs or create the image yourself.
a. Check one of the various icon packs.
Icon pack by Cannonfoddr (in /Icons/iMenu (b3) 50x50 icons/)
Icon pack by VatoLoco (in /iMenu Icons/)
Icon pack by jurassicplayer
NDS game cover pack by Cannonfoddr (for commercial games)
b. These don't look as good because they have a border, but if you can't find it in the above packs, look for a .bmp icon in this wiki.
c. Make it yourself.
  • Start up GIMP
  • 'Open' up spinal_cord's beta3 GIMP icon template
  • 'Open' (as a new picture) a picture you'd like to use... Crop it,Modify it, 'Merge down' any layers then 'Resize' it etc (I find best resized to 44x44 pixels)
  • 'Select' > 'All'
  • 'Edit' > 'Copy'
Now the 'tricky' bit....
  • Select the icon template window & you should see in the 'Layers' window - there are 3 of them
    (from top to bottom they should be 'AppIconOverlay.png'/'Background'/'AppIconShadow.png' - the 'background' one has 2 icons together - a film reel & a black border)

  • Click on the LEFT ICON of 'Background' (the picture of a film reel)
  • 'Edit' > 'Paste'
Now 'File' > 'Save as' > 'whatever you want to call it.bmp' > Merge visible layer/Export > Save
d. If you don't see the icon you want and do not wish to make it yourself, request your icon(s) in this thread, then use default.bmp file which can be found in /_imenu/_images/icons/ until your request is filled.
e. Put the image you created or obtained in /_iMenu/_images/icons.​

3. Put the homebrew that you want to assign the icon to in the /_dstwoplug folder (it isn't required to be in here, but for organization's sake just put it here)

4. Go back to /_iMenu/_ini. Edit the .ini file you created in step one to correspond to all of the correct files.

You should now see the new icon with the name you assigned it when you boot into iMenu.


How to theme iMenu

Spinal added a page for themes on his website. temporarily offline, check out Cannonfoddr's post and Hoodz post for a few themes

Just click on the name below the picture to download a .rar package and extract the _iMenu folder to the root of your microsd card.
I recommend downloading "sedstwo" to match with the rest of the skin in the "How to skin the rest of your DSTwo" section.



If you are interested in making your own theme you may want to know what you can edit, Cannonfoddr has made a nice bit about what each thing does in the settings:
You need to use either Windows 'Notepad' (or similar) or DSOrganise/Moonshell2 'TextEdit' feature to change these

Settings.ini
<!--c1--><div class="codetop">CODE</div><div class="codemain"><!--ec1-->[main]
toptext=ffffff
topshaddow=000000
bottomtext=ffffff
bottomshaddow=000000

showinfoicon=0
infoix=0
infoiy=60

showinfoname=0
infonx=4
infony=110
nametext=EF73B5
nametextshaddow=ffffff

showinfonote=0
infonox=4
infonoy=122
notetext=EF73B5
notetextshaddow=ffffff

showday=1
dayx=4
dayy=0
daytext=ffffff
dayshaddow=000000

showdate=1
datex=90
datey=0
datetext=ffffff
dateshaddow=000000

quietboot=1
hideicontext=0<!--c2--></div><!--ec2-->
  • toptext=,topshaddow=
    Not used - Left over from beta3(.0)

    bottomtext=,bottomshaddow=
    Defines the colours used to display the text underneath the Icons on bottom screen

    showinfoicon=0/1
    0= Do not show icon on top screen, 1=Show icon on top screen
    infoix=, infoiy=
    Position to show 'Icon' on top screen

    showinfoname=0/1
    0= Don't show Icons name on top screen, 1= Show icon name on top screen
    infonx=, infony=
    Postion on top screen to show Icon's name
    nametext=, nametextshadow=
    Defines the colour of the icon names text, & it's 'shadow'

    showinfonote=0/1
    0= Do not show the text stored in the INI 'note=' line, 1= Show the text in 'name='
    infonox=, infonoy=
    Position on top screen to display the 'note=' text
    notetext=, notetextshadow=
    Defines the colour(s) used to display the text stored in 'note='

    showday=0/1
    0=Do not show today's day (Monday-Sunday) on top screen, 1=Show today's day on top screen
    dayx=, dayy=
    Position on top screen to show the date
    daytext=, dayshadow=
    Defines the colour(s) used to display the Day name

    showdate=0/1
    0= Do not show the date (dd/month) on top screen, 1= Display the date
    datex=, datey=
    Position on top screen to display the date
    datetext=, dateshaddow=
    Defines the colour(s) used to display the date

    quietboot=0/1
    0=When booting up display text on what iMenu is doing, 1=only show a (virtually) blank bootup screen with 'iMenu' title on it
    hideicontext=0/1
    0=All Icons on bottom screen will show the name underneath, 1=Only Icon graphics are displayed

Skins for iMenu b1 (these are very old and do not work on the newer version of iMenu)

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

How to skin the rest of your DSTwo

This is my recommended skin just to start you off, you can later change anything to how you want it.

1. Download the DSTwo Skin Installer by Stormwave.

2. Extract "7z.dll", "DSTwo Skin Installer.exe", and "SkinInstaller.ico" anywhere you want on your computer (with all of the files in the same folder).

3. Double click "DSTwo Skin Installer.exe" and press "Associate ds2skin".

4. If you haven't yet, make sure you have your MicroSD card plugged into your computer.

5. Download the Limited Edition DSTwo skin (orange version).

6. Extract "LEDS2-Orange.ds2skin" to wherever you want on your computer, then double click it.

7. You will see a window with all of the skins that it is going to install, uncheck the "Loading Screen" box.
8. Then press the Start button and wait for the skin to finish installing.

Your skin is now successfully installed.


If you ever want to experiment with skins, you can find them here.
You may also find them here, although they are installed using different methods.


Miscellaneous

How multibooting works:
- New boot menu -
Holding L+R during booting will load a file selector, press 'A' to load a different menu one time, Press 'Start' to change the default menu.
This is 100% compatible with BAGPlug and other homebrew, you can even set moonshell or the original plugin menu as default and change them whenever you like. Have a look in _dstwo/boot.ini to figure out how it is set up!​
How to Update EOS
1) Delete "plgargs.dat" off of the root of your MicroSD card
2) Download the latest EOS from here
3) When you open up the latest EOS in your archiver, rename dstwo.nds to _dstwo.nds (in the /_dstwo/ folder)
4) Extract all of the files to the root of your MicroSD Card like normal and let everything overwrite.​
How to Update iMenu (of same versions e.g. Beta3.2 to beta 3.3) by Cannonfoddr:
1) Backup the '/_imenu/' folder from your Memory card
2) Download & install the latest version of iMenu from Spinal's website
3) Copy back the '/_imenu/'_ini/' folder, overwriting any existing INI (If you don't you may find some Icons have 'moved' places)

IF you have done any theme/skin/clock alterations:-
> Copy over from your backup the '/_imenu/_images/gui/' folder, 'clock.ini' and 'settings.ini' files

IF you have added any new Icons to iMenu:-
> Copy over the [added] icons from your '/_imenu/_images/icons/' backup into the same folder on your Memory card​
How to load commercial ROMs from iMenu:
Just put dsgame in the note line in your .ini file, see the example below.
[plug setting]
icon=/_imenu/_images/icons/*Whatever Icon Graphic You Want*.bmp
name=*Name of Commercial ROM*
file=/DSgames/*Commercial ROM*.nds
number=0
dock=0
note=dsgame
arg=
You can get game icons from Cannonfoddr's NDS game cover pack
How to get DSDoom to work:
How to get jEnesisDS to work:
Put dsgame in the note line of the .ini file, such as with commercial ROMs, if it still doesn't work try an older version of jEnesisDS​
How arg works:
Arg is a method to automatically launch up a specified file when you start up the homebrew (such as a game in an emulator) using a custom icon with an arg line in the .ini file (see "How the icons in iMenu work" under the "How to add new icons (homebrew)" section). Currently the main homebrew that support it are CATSFC and IkuReader.

To create arg icons set the .ini file up just like the homebrew's .ini file, except have the arg= line point towards the file you want to load.
[plug setting]
icon=/_imenu/_images/icons/*Whatever Icon Graphic You Want*.bmp
name=*Name of SNES Game*
file=/_dstwoplug/CATSFC.plg
number=0
dock=0
note=
arg=/CATSFC/gamepak/*SNES Game*.smc


Shameless plug

Would you like to know how to get game guides or pictures that you can access from the real-time menu while playing DS2 games? Would you like to know how to create high quality videos for viewing in Moonshell 2?

Just click here
 

Terminator02

ヽ( 。 ヮ゚)ノ
OP
Member
Joined
Apr 10, 2010
Messages
4,516
Trophies
1
Location
Somewhere near monkat
XP
1,089
Country
United States
I have my DSTWO set to autoboot imenu, and I'm having trouble getting rom loading working right. I can load a rom, but when I try to go back, it takes me to the DSGame menu and won't let me exit. Also I can't get my icons to show up right.
It's going to take you to DSGAME when you exit a game through the in-game menu, you have to back out of DSGAME with B to go back to the plugin menu (iMenu in your case).
 

drakorex

Well-Known Member
Member
Joined
Jan 19, 2011
Messages
1,882
Trophies
0
XP
1,077
Country
United States
after adding so many games to the imenu, it seems to freeze while loading, and two corrupted files are found in the ini folder
 

drakorex

Well-Known Member
Member
Joined
Jan 19, 2011
Messages
1,882
Trophies
0
XP
1,077
Country
United States
Anyone got jEnesisDS Working from imenu? I put dsgame in the note section of the ini, but it keeps taking me to dsgame.
 

CannonFoddr

Regular GBATemp Lurker
Member
Joined
Sep 23, 2006
Messages
4,134
Trophies
1
Age
56
Location
Sitting by computer
Website
www.youtube.com
XP
1,285
Country
Can anyone help out with a new link to "spinal_cord's beta3 GIMP icon template" it is dead.


I know this thread is slightly old but I am renovating my DSTWO because I only play ORAS on my 3DS.

Thanks

Not sure what you actually mean - its been such a long time since I looked - but am I assuming you want the psd templates to make your own icons up ?
If so the Plugin page (https://gbatemp.net/threads/supercard-dstwo-plug-ins.229551/) has a couple of links to icon templates

http://www.mediafire.com/?dmuz4zgmlgm (template 1)
http://www.mediafire.com/?zmlmwryziy0 (template 2)

I'm not sure but I don't think the b3 icon changed at all from the original b1 version
 
  • Like
Reactions: VatoLoco

R4Liam

Artsy Dude
Member
Joined
Jul 7, 2009
Messages
602
Trophies
1
Age
31
Location
UK
Website
youtube.com
XP
541
Country
Not sure what you actually mean - its been such a long time since I looked - but am I assuming you want the psd templates to make your own icons up ?
If so the Plugin page (https://gbatemp.net/threads/supercard-dstwo-plug-ins.229551/) has a couple of links to icon templates

http://www.mediafire.com/?dmuz4zgmlgm (template 1)
http://www.mediafire.com/?zmlmwryziy0 (template 2)

I'm not sure but I don't think the b3 icon changed at all from the original b1 version


Yes! That's what I was after, thanks man.
 

hereforhelp

New Member
Newbie
Joined
Jan 8, 2015
Messages
1
Trophies
0
XP
83
Country
Congo, Democratic Republic of the
I know this is old but I want it to work anyways and I am getting nowhere, if anyone can help the noobiest of noobs... well thats just swell. I have no issues getting the DSTwo setup and working on a 3ds with various emulator plugins and games. Once I get to step 5 though it gets rough. The most progress I've got was to get the imenu loading screen on top with black on the bottom.

Working on a mac - and with my current setup I don't have a great way to just extract to the root and replace what I need, so I'm doing a lot of that manually (and likely wrong)

So restarting this process again from a formatted card with DStwo basically setup and working, I have at the root:
/ _dstwo (all files left as is so far)
/_dstwoplug (added nes for testing)
/Roms (3 .nes games to test)
ds2boot.dat (updated for 3ds)


I have iMenu from the filetrip mirror for step 5, and the iMenu setup files for step 6 and now just need to figure out how to add them in. I've tried manually copying _dstwo.nds, boot.ini, and rewriting the dstwo.nds into the _dstwo folder, and then adding the _iMenu folder and contents to the root. So two good questions here - is that even the right setup for step 5? and is there a better way (free) to unzip this stuff to just streamline it all.


So from here I'm still not sure if I pulled off step 5 at all, and step 6 just says "Extract this to the root of your MicroSD card and let it replace everything it has to" ...considering I'm trying to replicate this by manually moving the files this has me completely lost..
 

nyseiru

New Member
Newbie
Joined
Mar 27, 2016
Messages
3
Trophies
0
Age
42
XP
51
Country
United States
Seems like a few people are having trouble with this new 'AutorunLastRom' business, so maybe this will help

1) Download the 'DSTwoNDSLoader.nds' from here or here (note - it looks like the names been changed to 'nds.dstwoNDSloader.nds')
2) Download the 'DStwoiniClear.nds' from here
3) Place both files anywhere you like (I suggest in the '/_iMenu/' folder)

4) Edit the existing 'DSGame' icon from within iMenu, so that's it's similar to this
Code:
Icon:dsgame.bmp
Name:NDS Games
File:dstwoiniclear.nds
Note:Normal DS_Game menu
Arg:
ININame:dsgame.ini
5) Create as many new Icons for each DS game you wish to run from iMenu, having it's INI file similar to
Code:
Icon: {WhateverYouLike}.bmp
Name: {name of ROM}
File:nds.dstwoNDSLoader.nds
Note:
Arg:/{wherever your DSGames are stored}/NameOfROM.nds
IniName:{WhateverYouLike}.ini
so for example, if the game is 'Animal Crossing' it would look something like this
Code:
Icon: ACWW.bmp
Name: Animal Crossing
File:nds.dstwoNDSLoader.nds
Note:
Arg:/dsgames/Animal Crossing Wild World.nds
IniName:ACWW.ini

Now, IF you want to play your ROM - use the appropriate Icon you made for it OR IF you wish to go to the 'normal' DS game menu (if you want to change the Hotkeys etc) - Use the usual 'DS Game' icon

@A Gay Little Cat Boy: You HAVE updated to the latest Firmware (v1.11) haven't you ?? - it sounds like you've not got the 'AutorunLastRom'. Have a look in your '/_DStwo/ 'globalsettings.ini'. Have you got a 'lastromrun=' line ??

I recently bought a DSTwo plus and have it all setup - but have noticed that apparently the DSTwo Plus will not default to the last used NDS Rom Directory when using DSGame.nds

I have successfully set up iMenu (which is awesome btw) and have it set up to load DSGame without a game and also using the method above to load a nds game directly.

my question is, is there a way to use this to set the default directory that will be loaded with DSGame instead of the Root? All my games are in /Games/ and i would prefer not to show the OS folders initially.

I have tried teh above but setting the file to just a folder, but no luck

thanks
 

Site & Scene News

Popular threads in this forum

General chit-chat
Help Users
  • No one is chatting at the moment.
  • ZeroT21 @ ZeroT21:
    it wasn't a question, it was fact
  • BigOnYa @ BigOnYa:
    He said he had 3 different doctors apt this week, so he prob there. Something about gerbal extraction, I don't know.
    +1
  • ZeroT21 @ ZeroT21:
    bored, guess i'll spread more democracy
  • LeoTCK @ LeoTCK:
    @K3Nv2 one more time you say such bs to @BakerMan and I'll smack you across the whole planet
  • K3Nv2 @ K3Nv2:
    Make sure you smack my booty daddy
    +1
  • LeoTCK @ LeoTCK:
    telling him that my partner is luke...does he look like someone with such big ne
    eds?
  • LeoTCK @ LeoTCK:
    do you really think I could stand living with someone like luke?
  • LeoTCK @ LeoTCK:
    I suppose luke has "special needs" but he's not my partner, did you just say that to piss me off again?
  • LeoTCK @ LeoTCK:
    besides I had bigger worries today
  • LeoTCK @ LeoTCK:
    but what do you know about that, you won't believe me anyways
  • K3Nv2 @ K3Nv2:
    @BigOnYa can answer that
  • BigOnYa @ BigOnYa:
    BigOnYa already left the chat
  • K3Nv2 @ K3Nv2:
    Biginya
  • BigOnYa @ BigOnYa:
    Auto correct got me, I'm on my tablet, i need to turn that shit off
  • K3Nv2 @ K3Nv2:
    With other tabs open you perv
  • BigOnYa @ BigOnYa:
    I'm actually in my shed, bout to cut 2-3 acres of grass, my back yard.
  • K3Nv2 @ K3Nv2:
    I use to have a guy for that thanks richard
  • BigOnYa @ BigOnYa:
    I use my tablet to stream to a bluetooth speaker when in shed. iHeartRadio, FlyNation
  • K3Nv2 @ K3Nv2:
    While the victims are being buried
  • K3Nv2 @ K3Nv2:
    Grave shovel
  • BigOnYa @ BigOnYa:
    Nuh those goto the edge of the property (maybe just on the other side of)
  • K3Nv2 @ K3Nv2:
    On the neighbors side
    +1
  • BigOnYa @ BigOnYa:
    Yup, by the weird smelly green bushy looking plants.
    K3Nv2 @ K3Nv2: https://www.the-sun.com/news/10907833/self-checkout-complaints-new-target-dollar-general-policies...