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
 
Ok I have installed the iMenu as per instructions and it freezes at the loading imenu screen, I install and test EOS version 1.11 all ok then I load imenu it over writs 2 files/directories
What am I doing wrong
 
I think that also constitutes as a mess. iMenu looks for plugins on the first boot and you need plugins in order to have any icons, unless you are just using the DSGame one I think. Add in one or two plugins (correctly would be nice), and then try it.
 
CannonFoddr said:
Yet another poster that didn't follow the guide in the first post to the letter
laugh.gif
('missing plugin folder' - AGAIN)
Maybe Terminator SHOULD put that warning in the first post like I suggested
unsure.gif
People probably just come to this thread since it is the main iMenu one without even reading the thread title and then post their problems, never taking in the title.
 
I've encountered an issue with beta 3.3. When using the "dsgame" note, nds files boot up fine through button presses, but freeze at 2 white screens when attempted to boot through the touch screen interface.
 
I can confirm that bug^^^^

also i can answer my previous question, it doesn't change the global settings, so when u exit back to DSGame it will work like normal (you don't have to hold B)

Thanks to Sir_Voe's post on the homebrew bounty page and iMenu 3.3 the latest jenesisds will now work, you just have to put dsgame in the note line in the .ini file for it (the same way you do to load Commericial ROMs)

Edit: also the dock icons can't be selected with touch, it just selects the last icon that you has selected

also if you have a full screen of icons you can scroll to the right with the stylus even though nothing is over there

also there is a 0 on the top left of the top screen for no reason and the numbers change when you're using the stylus
 
considering how long the new icons section is going to take to finish i went ahead and completed the manual way to add new icons, now i just have that one bit left to finish


Edit: btw, when are you guys gonna start making commercial ROM icons?
 
"Edit: btw, when are you guys gonna start making commercial ROM icons"

@terminator I second that. Theres a cover art set for bagplug that might be nice
if it was converted to use for Imenu. Dont know if thats what you meant
for icons, but I wouldnt mind having those come up as a usuable
icon when selecting a commerical rom. Just a thought though.
 
I MIGHT have a look at those 'cover packs' & see how they look when resized & added to the iMenu icon template this weekend (if I'm not busy)

If they don't seem to bad - I'll give it a shot (but don't hold your breath though)
 
Whoa !!!! - Just downloaded the pack to have a look....... There over 5000 graphics to alter !!!!!
Admittedly a lot are 'similar' to one another [do we really need 6 similar looking icons for Pokemon Black ??] - so I think if/when I make a start I'll might just stick to the 'one of each type' & I don't think I'll bother 'tweaking them' after scaling etc - as that'll be TOO much work

I'm in work ATM, but I've experimented with a couple of covers (took about 5min just for 1 icon) to see what they look like at that size - don't seem too bad IMHO, just can't read the tiny writing clearly (not tried them on my DS though, they may be absolutely c***)
Pokemon.png
Sonic.png


What do you think ?? Any good ??

FYI - I rescaled the covers 'proportionally' to 48 Height x 53 Width, & just copied/pasted them into Spinal's 'GIMP Imenu template' - but had to 'move' them about a bit to hide the 'Nintendo DS' label down the left hand side to get more of the picture in.... just in case anyone else want to have a go

EDIT #1:
And as a suggestion - if anyone ELSE is considering doing some, I think some system should be in place so that we don't all end up doing the same ones (the first cover folder [DSi] has 138 in there, removing the 'duplicates' makes it come down to ~98 - so I MIGHT attempt this one)


EDIT #2: OK that didn't take as long as I thought (although my poor fingers hurt like hell using Copy/Paste shortcuts & renaming etc) but here's a start to the Commercial NDS Cover Icons, (although whether I keep at it I don't know)

As you will find out, these ONLY contain the covers found in Bagplug's 'DSi' folder (138 covers in total) & is not the whole pack - & you will also find out that quite a few covers don't 'scale down' quite as well to the 50x50 icon size - but what the hell, It's a start (you'll also notice I've done ALL the covers , so there's duplicates - too lazy to sort through them all)

iMenu 'BagPlug Covers Icons' [DSi Folder only]: http://filetrip.net/f24665-Imenu-NDS-Covers-Icons-1-0.html / mirror: http://www.mediafire.com/?oswasl6lro1en8b
24665-Image2.png

P.S. I'M CURRENTLY WORKING ON THE 'nds KOR' FOLDER

Edit #3: iMenu 'BagPlug Covers Icons' 'NDS Kor' cover Icons now done: http://filetrip.net/f24667-iMenu-NDS-Cover...Kor%5D-1-0.html / mirror: http://www.mediafire.com/?saqaqcwmc7hru2v

Only another ~5100 to go
unsure.gif
.... so I'm gonna take a break
grog.gif
& let some1 do some now
wink.gif
 
No problem - i'll leave the rest to you now.
Actually Here's a suggestion

@spinal : How about allowing ' showicon=2' which shows 'covers' on top screen,we can reuse the x & y positions and have a folder '/imenu/_covers/'. ( We could reuse bagplug covers) . I would guess Imenu would need to read nds header though


EDIT: Am I the only person doing this ????
unsure.gif


OK So I lied, had a couple of hours free while my car being serviced so I've made a start on the 'Bagplug NDS Rest' folder - Find it here

However IF anyone else wishes to create the necessary missing cover icons - May I suggest that you.......
> Do them in 'batches' (e.g. all covers from AC2E-ADZP)
> Download the latest pack & add their new cover icons to it
> Re-upload it as the 'next version' (e.g if you download v1.0, the next will be v2.0 etc)....

... Also Remember to add to the change log what Icons you've added so that no-one else starts doing the same ones

So the Current situation of 'Bagplug Covers to Imenu Icons' is.....
 
Man great work. If I only I knew how to do this a little bit I could offer my help. I do know
how to use flash and had to do that for a few classes, but I've never messed with any of these
photo editor apps/progs like photoshop, or gimp, but photoshop came with my adobe package for
school so I imagine you can use something like that for these right?? If you want to explain to
me how to do this correct(pm maybe) I can give it a shot. Maybe continue where you left off, if I can get the chance to do a little here and there, etc etc. I'm surprised none of the other guys that do the packs/icons offered to help or maybe they have a few other things going on. Nevertheless since I kind of came up with the suggestion and you so wonderfully started work on it( thanks for all that by the way)I want to at least maybe give it a little bit of a go you know. You have to explain the whole process to me step by step. I dont really know what I'd have to do to convert to the right resolution, etc etc.

Like these parts I would need to know what to do on

Do them in 'batches' (e.g. all covers from AC2E-ADZP)

and I've heard of the change log, not sure how I would add to that or not. I imagine this aint too much, I just aint really handy with those progs, but I'm thinking I could do a little of this. Let me know whats good CannonFoddr
 

Site & Scene News

Popular threads in this forum