Menu structure
From OpenTom
Contents |
About
Ever wanted to reorganise your Tom Tom Go's menus? Want that special option on the first screen not 3 clicks in? Well you can.
Starting with the default menu
First of all you need to create a folder called:
SDKRegistry
in the root of your TomTom system's SD card or
/TomTom/SDKRegistry
in the first level (the root) of your PDA system.
Within that folder create a file called:
TomTom.mnu
Both the folder and the file names are case sensitive. Now paste the following into the file and save it
1- Main menu block
MENUBLOCK|BLOCK_MAIN|BTM_GPS_POSITION| MENUPAGE|TASK_PAGE1|Main Menu 1 of 3| MENUITEM|TASK_NAVIGATE_TO| MENUITEM|TASK_MENU_FIND_ALTERNATIVES| MENUITEM|TASK_DELETE_ROUTE| MENUITEM|TASK_ADD_FAVORITE| MENUITEM|TASK_MENU_PREFERENCES| MENUITEM|TASK_PAGE2| MENUPAGE|TASK_PAGE2|Main Menu 2 of 3| MENUITEM|TASK_MENU_PLAN_ATOB| MENUITEM|TASK_SHOW_MAP| MENUITEM|TASK_MENU_ROUTE_INSTRUCTIONS| MENUITEM|TASK_MENU_PHONE| MENUITEM|TASK_ITINERARY| MENUITEM|TASK_PAGE3| MENUPAGE|TASK_PAGE3|Main Menu 3 of 3| MENUITEM|TASK_SHOW_WEATHER| MENUITEM|TASK_MENU_DOWNLOAD| MENUITEM|TASK_MENU_TRAFFIC| MENUITEM|TASK_TUTORIAL| MENUITEM|TASK_SHOW_GPS_STATUS| MENUITEM|TASK_PAGE1|
If you would like to customize preferences menus, add the following at the end of previous file
2- Preferences menu block
MENUBLOCK|BLOCK_PREF|BTM_GPS_POSITION| MENUPAGE|TASK_PAGE4|Préférences 1/6| MENUITEM|TASK_SWITCH_NIGHTVIEW| MENUITEM|TASK_SWITCH_2D3D| MENUITEM|TASK_SET_HIDEMAP| MENUITEM|TASK_SWITCH_POI| MENUITEM|TASK_SWITCH_SOUND| MENUITEM|TASK_PAGE5| MENUPAGE|TASK_PAGE5|Préférences 2/6| MENUITEM|TASK_SET_VOLUME| MENUITEM|TASK_MAINTAIN_FAVORITES| MENUITEM|TASK_CHANGE_HOME_LOCATION| MENUITEM|TASK_MANAGE_MAPS| MENUITEM|TASK_MAINTAIN_POI| MENUITEM|TASK_PAGE6| MENUPAGE|TASK_PAGE6|Préférences 3/6| MENUITEM|TASK_SET_STATUS| MENUITEM|TASK_SET_CLOCK_TYPE| MENUITEM|TASK_ROTATE_DISPLAY| MENUITEM|TASK_SET_COLOR_SCHEMES| MENUITEM|TASK_SET_BRIGHTNESS| MENUITEM|TASK_PAGE7| MENUPAGE|TASK_PAGE7|Préférences 4/6| MENUITEM|TASK_SET_PLANTYPE| MENUITEM|TASK_SET_TOLL| MENUITEM|TASK_SET_COMPASS| MENUITEM|TASK_SET_VOICE| MENUITEM|TASK_SET_LANGUAGE| MENUITEM|TASK_PAGE8| MENUPAGE|TASK_PAGE8|Préférences 5/6| MENUITEM|TASK_SET_DIST_UNITS| MENUITEM|TASK_LEFTHANDED| MENUITEM|TASK_SET_KEYBOARD_SIZE| MENUITEM|TASK_SET_NAME_DISPLAY| MENUITEM|TASK_SWITCH_TIPS| MENUITEM|TASK_PAGE9| MENUPAGE|TASK_PAGE9|Préférences 6/6| MENUITEM|TASK_SWITCH_BLUETOOTH| MENUITEM|TASK_ABOUT| MENUITEM|TASK_SET_CRADLE| MENUITEM|TASK_SWITCH_ASN| MENUITEM|TASK_RESET_SETTINGS| MENUITEM|TASK_PAGE4|
This will exactly replicate the existing main menu pages and structure (only GO 300), and the preferences menu pages (all GO). Pages start with the command MENUPAGE, individual menu items start with MENUITEM.
Additional Options
In addition to the basic menu items, you can also change the icon and text for each item. The following should illustrate how this is done:
MENUITEM|MENUCOMMAND|"ICONFILE"|"TEXT DESCRIPTION"|
As an example,
MENUITEM|TASK_NAVIGATE_TO|"myicon.bmp"|"Travel!"|
will replace the Navigate to icon and the text underneath will be Travel!
(Bitmap option doesn't work with app-versions prior to 5.202)
Example
Let's look at the text you just pasted into tomtom.mnu, change the line
MENUITEM|TASK_ADD_FAVORITE|
to
MENUITEM|TASK_SET_MAP|
and save the file. Once your Go restarts you'll notice that the "Add Favourite" option on the first page (when you press the centre of the screen) has changed to "Switch Map". Below is a list of the available options:
Available options
Buttons
BTM_GPS_POSITION BTM_DONE BTM_CAM_INFO
Tasks
TASK_NONE TASK_EMPTY TASK_MENU_PREFERENCES <- this item call automatically block_pref menu block (see example). TASK_SWITCH_ASN TASK_SET_VOICE TASK_SET_LANGUAGE TASK_SET_DIST_UNITS TASK_SET_CLOCK_TYPE TASK_SET_GEO (1) TASK_SWITCH_TIPS TASK_SET_VOLUME TASK_SWITCH_SOUND TASK_SHOW_STATUS TASK_SHOW_GPS_STATUS TASK_SET_BRIGHTNESS TASK_SET_BACKLIGHT (2) TASK_RESET_SETTINGS TASK_SWITCH_BLUETOOTH TASK_SWITCH_CLOCK (1) TASK_LEFTHANDED TASK_ROTATE_DISPLAY TASK_SET_KEYBOARD_SIZE <- if you use this, keyboard_type is automatically used after. TASK_SET_KEYBOARD_TYPE TASK_SET_PROMPT (2) TASK_SET_COMPASS TASK_SET_STATUS TASK_SWITCH_NIGHTVIEW TASK_SET_COLOR_SCHEMES TASK_SET_DAY_COLOR_SCHEME TASK_SET_NIGHT_COLOR_SCHEME TASK_CHANGE_HOME_LOCATION TASK_MAINTAIN_FAVORITES TASK_ADD_FAVORITE TASK_SET_SAFETY_SPEED (1) TASK_SWITCH_2D3D TASK_SET_MAP TASK_DELETE_MAP TASK_SHOW_MAP TASK_SET_HIDEMAP TASK_SWITCH_POI TASK_CONFIGURE_POI TASK_MAINTAIN_POI TASK_MENU_RECALC_BLOCK TASK_AVOID_ROUTE_LINE TASK_PLAN_VIA TASK_MENU_FIND_ALTERNATIVES TASK_ASK_CHANGE_OWNER (1) TASK_MENU_TRAFFIC TASK_TRAFFIC_SETTINGS TASK_TRAFFIC_ENABLE TASK_TRAFFIC_UPDATE TASK_TRAFFIC_REPLAN TASK_TRAFFIC_VIEW TASK_TRAFFIC_EXPLAIN TASK_NAVIGATE_TO TASK_MENU_PLAN_ATOB TASK_DELETE_ROUTE TASK_CONFIRM_DELETE_ROUTE TASK_SET_TOLL TASK_SET_PLANTYPE TASK_SET_CRADLE TASK_SHOW_ROUTE_DEMO TASK_MENU_ROUTE_INSTRUCTIONS TASK_SHOW_ROUTE_INSTRUCTIONS TASK_STEP_ROUTE_INSTRUCTIONS TASK_ABOUT TASK_ITINERARY TASK_TUTORIAL TASK_EXIT_APP TASK_SET_NAME_DISPLAY TASK_SHOW_WEATHER TASK_MANAGE_MAPS TASK_MENU_DOWNLOAD TASK_DOWNLOAD_MAP TASK_DOWNLOAD_POI TASK_DOWNLOAD_VOICE TASK_DOWNLOAD_SCHEME TASK_DOWNLOAD_VERSION_NUMBER TASK_SERVICE_LOGIN (2) TASK_HELP_GENERAL TASK_HELP_MAINMENU TASK_HELP_MAPBROWSER TASK_HELP_ZOOMING TASK_HELP_TRAFFIC TASK_HELP_ITINERARY TASK_HELP_PLANNING TASK_MENU_PHONE TASK_PAIR_WITH_PHONE (1) TASK_DIAL_POI BLOCK_MAIN BLOCK_PREF TASK_SDK (or TASK_SDK(n) see below) TASK_PAGE (better: TASK_PAGE(n))
Following items obtained on a GO 910, may apply to other models
TASK_BUDDIES TASK_DOC_BROWSER TASK_IMAGE_BROWSER TASK_IPOD TASK_JUKEBOX TASK_MULTIMEDIA TASK_PLAN_TO_MAPLOC TASK_NEARBY_POICAT TASK_CENTER_ON_MAP TASK_DO_ADD_FAVOURITE TASK_CURSOR_INTO_POI TASK_TRAVEL_VIA
Following Items are found on a TomTom ONE V3
TASK_RDSTMC_SELECT_COUNTRY
Applications
There are 9 TASKs for 9 plugin applications:
TASK_SDK1 ... TASK_SDK9
Previous Page Button
MENUITEM|TASK_PAGE1|"back.bmp"|"go back"
You can place a file back.bmp in SDKRegistry.
Keywords
MENUBLOCK MENUPAGE MENUITEM COMMAND GEONAME
1) not visible on screen. 2) usefull item and not used by default.
Menu Blocks
There are three types of menu block,
BLOCK_MAIN BLOCK_PREF BLOCK_CURSOR
The BLOCK_MAIN deals with the main menu pages, the BLOCK_PREF deals with the options that appear in the Change Preferences pages. To make changes to the BLOCK_PREF add a line to the bottom of your .mnu file
Look at the original menu structure, in the first block menu (BLOCK_MAIN) , MENUITEM|TASK_MENU_PREFERENCES| item call MENUBLOCK|BLOCK_PREF|BTM_GPS_POSITION| (the second block menu).
MENUBLOCK|BLOCK_PREF|BTM_GPS_POSITION|
This begins the preferences block. You also need to add a MENUPAGE entry
MENUPAGE|TASK_PAGE4|Preferences 1
Note that the number in the TASK_PAGE (4) is a continuation of the previous MENUPAGE TASK_PAGE (3) entry from the BLOCK_MAIN, ie TASK_PAGE counts start at 1 and go up every time you add a page, regardless of which block it appears in.
Here's a quick example, which if appended to the menu listing Starting with the default menu will change the preferences screen to only allow the flipping of the screen orientation
MENUBLOCK|BLOCK_PREF|BTM_GPS_POSITION| MENUPAGE|TASK_PAGE4|Preferences 1| MENUITEM|TASK_ROTATE_DISPLAY|
Additional notes
Bear in mind, that the GO runs Linux as its operating system and that file and directory names are case sensitive.
Lines within the menu definition file must be terminated by a Linefeed character (0x0a) or a Carriage Return / Linefeed combination (0x0a,0x0d). Macintosh users must take care of that, as their editors normally don't insert a Linefeed.
These options have been tested in software versions 5.1, 5.2, and 5.440 successfully. It may work with other releases, too.
Look here too
If you don't want to use a text editor to change your menus, but prefer an easier interface, you can download a menu designer (for Windows only) from http://www.gregoryduncan.com/ttmd/index.php. However, you can't change individual icon labels, or the icon graphics using this application.
With skuX's menu builder for TomTom Navigator 5.x you can build your menus on-line, but this tool seems currently not have all the TomTom GO menu icons.
