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
RoMee said:
I would have uploaded them for you, if you asked
but less work for me I guess

I'm in the middle of making matching dstwo skin..for my imenu skin
after that I'll make a few more for imenu..it's for a few friends, but I'll post/share it here too

EDIT:
okay, I uploaded them anyways
FF7 Cloud
Pokemon
Mario
CarbonMetal

I might make some changes to them later

I don't use imenu, so if there's an issue, plz let me know and I'll fix itthanks for uploading for me
yay.gif



QUOTE(Stevetry @ Oct 26 2010, 07:14 PM) i have firmware 1.8 will this work ?
as RoMee said, you mean 1.08, and yes it will
 

Terminator02

ヽ( 。 ヮ゚)ノ
OP
Member
Joined
Apr 10, 2010
Messages
4,516
Trophies
1
Location
Somewhere near monkat
XP
1,089
Country
United States
Stevetry said:
so i have to use the package from the site why not use just the eos download cuz the pakage is still at 1.07
yes, use the package from the site, the 1.08 update doesn't come in a package yet

the way to get 1.08 is to download the 1.08 version from here and replace everything in your card as a step between 3 and 4 (step 3.5?)

Edit: I added a new skin, it's not in the pack yet, check it out it's pretty cool
 

Terminator02

ヽ( 。 ヮ゚)ノ
OP
Member
Joined
Apr 10, 2010
Messages
4,516
Trophies
1
Location
Somewhere near monkat
XP
1,089
Country
United States
shakirmoledina said:
something tht will NEVER die (IMO) is torrent... ppl should move towards tht and take P2P as a second choice
the only P2P i used for a long time was Ares while limewire was slow and i hardly got what i wanted
I will get those skins up eventually... probably edit a bit of the format, won't happen til the weekend tho
 

RoMee

??
Member
Joined
Sep 3, 2010
Messages
2,314
Trophies
0
Location
??
Website
Visit site
XP
181
Country
United States
8BitWalugi said:
Just one question, does iMenu support standard commercial ROMs?

If it does, I might just change...

I don't think so..it just looks prettier..and hb compatibility was suppose to be improved
 

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,287
Country
8BitWalugi said:
RoMee said:
8BitWalugi said:
Just one question, does iMenu support standard commercial ROMs?
I don't think so..it just looks prettier..and hb compatibility was suppose to be improved
Damn. While homebrew is cool and all, I primarily use my DS2 for ROMs.
FYI - iMenu is a 'replacement GUI for the DSTwo plugin menu' - since the DSTwo own plugin menu is only capable of running homebrew as plugins then 'NO - it can't run Commercial ROM's from it'

In fact - Spinal USUALLY sticks to developing alternative 'Homebrew launchers' instead of 'Commercial ROM launchers', although IIRC he has in the past allowed room for 'Commercial loaders' to be used (i.e. YSMenu) with his launchers.
(I'm sure some1 will correct me if I'm wrong)

I would guess that IF some1 does come up with a way to launch ROM's from the DS plugin menu (i.e. a way to bypass the DLDI patching etc) - it MIGHT eventually appear in Spinal program, but I would guess you would lose the abilities of cheats and Multi-save slots.
Why not just run the DS_Game plugin & run the ROM from there ??
 

Uncle FEFL

OBJECTION!
Member
Joined
Sep 7, 2009
Messages
1,175
Trophies
0
Age
30
Location
PM me for Social Security information
XP
134
Country
United States
It seems to be that I'm the only one so far having problems...
frown.gif


None of my homebrew files are working, they just go to blank black screens. My plg's are working fine, as well as the EOS menu. Here's an example of one of my homebrew setups:

Code:
[plug setting]
icon=/_imenu/_images/MoonShell2.bmp
mask=/_imenu/_images/MoonShell2_mask.bmp
name=MoonShell
file=/_imenu/_homebrew/Moonshell2.nds
dock=1

Never mind. Instead of directing my .NDS files to "homebrew," I directed them to the "_plg" folder and now they're working.
smile.gif
 

Terminator02

ヽ( 。 ヮ゚)ノ
OP
Member
Joined
Apr 10, 2010
Messages
4,516
Trophies
1
Location
Somewhere near monkat
XP
1,089
Country
United States
Uncle FEFL said:
It seems to be that I'm the only one so far having problems...
frown.gif


None of my homebrew files are working, they just go to blank black screens. My plg's are working fine, as well as the EOS menu. Here's an example of one of my homebrew setups:

Code:
[plug setting]
icon=/_imenu/_images/MoonShell2.bmp
mask=/_imenu/_images/MoonShell2_mask.bmp
name=MoonShell
file=/_imenu/_homebrew/Moonshell2.nds
dock=1

Never mind. Instead of directing my .NDS files to "homebrew," I directed them to the "_plg" folder and now they're working.
smile.gif
that's weird, it should work no matter where the file is located, maybe because it was in the _iMenu folder... well at least you got it working
 

Terminator02

ヽ( 。 ヮ゚)ノ
OP
Member
Joined
Apr 10, 2010
Messages
4,516
Trophies
1
Location
Somewhere near monkat
XP
1,089
Country
United States
I've added iPlayer into the set-up folder, it should appear with everything else in the first page, finally filling in that empty slot
smile.gif


Edit: btw, i just used the default iPlayer icon, so you can see part of the border, but i think it looks ok

Edit 2: i just realized i still haven't finish the skins section lol, i'm a terrible procrastinator >.>
 

Terminator02

ヽ( 。 ヮ゚)ノ
OP
Member
Joined
Apr 10, 2010
Messages
4,516
Trophies
1
Location
Somewhere near monkat
XP
1,089
Country
United States
I finally put the iPhone 4 skin in the full pack of skins, i guess I'll put proper previews for each skin soon, haven't really seen any new skins, so if anyone knows about any just feel free to tell me

Edit: everything is finished, updated RoMee's links to conform to my format too
 

spinal_cord

Knows his stuff
Member
Joined
Jul 21, 2007
Messages
3,224
Trophies
1
Age
43
Location
somewhere
Website
spinalcode.co.uk
XP
3,366
Country
Just a little note, the next release of iMenu might be a little different to set up. (I'm not suggesting that a release will be soon, I'm a little lazy, but eventually it will probably work a little different)
tongue.gif


[edit] Oh, technically, i'm spinal_cord not spinal_code, (spinal_code is the website, spinal_cord is the person) but just plain spinal will do in most cases
smile.gif
 

Terminator02

ヽ( 。 ヮ゚)ノ
OP
Member
Joined
Apr 10, 2010
Messages
4,516
Trophies
1
Location
Somewhere near monkat
XP
1,089
Country
United States
spinal_cord said:
Just a little note, the next release of iMenu might be a little different to set up. (I'm not suggesting that a release will be soon, I'm a little lazy, but eventually it will probably work a little different)
tongue.gif


[edit] Oh, technically, i'm spinal_cord not spinal_code, (spinal_code is the website, spinal_cord is the person) but just plain spinal will do in most cases
smile.gif
i was really confused about that lol, i had some as spinal_code and others as spinal_cord, but I realized this and changed them all to code, guess I'll just switch them all back

also, maybe you could make a version that works the same as the official plug-in menu (files go in the same place) as a noob friendly version, and then you could have one like it is now except with the ability to control where all of your icons are and (maybe?) the ability move them from the DS itself
 

Site & Scene News

Popular threads in this forum

General chit-chat
Help Users
  • No one is chatting at the moment.
    Xdqwerty @ Xdqwerty: good night