Menu structure

From OpenTom

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))
TASK_PHONE_MENU

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

The following Items are recognized by the 8.010 firmware of a TomTom ONE XL

TASK_ABOUT
TASK_ADD_FAVORITE
TASK_ASK_CHANGE_OWNER
TASK_AVOID_ROUTE_LINE
TASK_BUDDIES
TASK_CENTER_ON_MAP
TASK_CHANGE_HOME_LOCATION
TASK_CONFIGURE_POI
TASK_CONFIRM_DELETE_ROUTE
TASK_CURSOR_INTO_POI
TASK_DELETE_MAP
TASK_DELETE_ROUTE
TASK_DIAL_POI
TASK_DOC_BROWSER
TASK_DOWNLOAD_MAP
TASK_DOWNLOAD_POI
TASK_DOWNLOAD_SCHEME
TASK_DOWNLOAD_VERSION_NUMBER
TASK_DOWNLOAD_VOICE
TASK_DO_ADD_FAVOURITE
TASK_EMPTY
TASK_EXIT_APP
TASK_HELP_GENERAL
TASK_HELP_ITINERARY
TASK_HELP_MAINMENU
TASK_HELP_MAPBROWSER
TASK_HELP_PLANNING
TASK_HELP_TRAFFIC
TASK_HELP_ZOOMING
TASK_IMAGE_BROWSER
TASK_IPOD
TASK_ITINERARY
TASK_JUKEBOX
TASK_LEFTHANDED
TASK_MAINTAIN_FAVORITES
TASK_MAINTAIN_POI
TASK_MANAGE_MAPS
TASK_MENU_DOWNLOAD
TASK_MENU_FIND_ALTERNATIVES
TASK_MENU_PHONE
TASK_MENU_PLAN_ATOB
TASK_MENU_PREFERENCES
TASK_MENU_RECALC_BLOCK
TASK_MENU_ROUTE_INSTRUCTIONS
TASK_MENU_TRAFFIC
TASK_MULTIMEDIA
TASK_NAVIGATE_TO
TASK_NEARBY_POICAT
TASK_NONE
TASK_PAGE
TASK_PAIR_WITH_PHONE
TASK_PLAN_TO_MAPLOC
TASK_PLAN_VIA
TASK_RDSTMC_SELECT_COUNTRY
TASK_RESET_SETTINGS
TASK_ROTATE_DISPLAY
TASK_SDK1
TASK_SDK2
TASK_SDK3
TASK_SDK4
TASK_SDK5
TASK_SDK6
TASK_SDK7
TASK_SDK8
TASK_SDK9
TASK_SERVICE_LOGIN
TASK_SET_BACKLIGHT
TASK_SET_BRIGHTNESS
TASK_SET_CLOCK_TYPE
TASK_SET_COLOR_SCHEMES
TASK_SET_COMPASS
TASK_SET_CRADLE
TASK_SET_DAY_COLOR_SCHEME
TASK_SET_DIST_UNITS
TASK_SET_GEO
TASK_SET_HIDEMAP
TASK_SET_KEYBOARD_SIZE
TASK_SET_KEYBOARD_TYPE
TASK_SET_LANGUAGE
TASK_SET_MAP
TASK_SET_NAME_DISPLAY
TASK_SET_NIGHT_COLOR_SCHEME
TASK_SET_PLANTYPE
TASK_SET_PROMPT
TASK_SET_SAFETY_SPEED
TASK_SET_STATUS
TASK_SET_TOLL
TASK_SET_VOICE
TASK_SET_VOLUME
TASK_SHOW_GPS_STATUS
TASK_SHOW_MAP
TASK_SHOW_ROUTE_DEMO
TASK_SHOW_ROUTE_INSTRUCTIONS
TASK_SHOW_STATUS
TASK_SHOW_WEATHER
TASK_STEP_ROUTE_INSTRUCTIONS
TASK_SWITCH_2D3D
TASK_SWITCH_ASN
TASK_SWITCH_BLUETOOTH
TASK_SWITCH_CLOCK
TASK_SWITCH_NIGHTVIEW
TASK_SWITCH_POI
TASK_SWITCH_SOUND
TASK_SWITCH_TIPS
TASK_TRAFFIC_ENABLE
TASK_TRAFFIC_EXPLAIN
TASK_TRAFFIC_REPLAN
TASK_TRAFFIC_SETTINGS
TASK_TRAFFIC_UPDATE
TASK_TRAFFIC_VIEW
TASK_TRAVEL_VIA
TASK_TUTORIAL

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. BLOCK_CURSOR describes a block of pages which may be displayed in the context of a chosen map location. At least the following tasks are applicable: TASK_PLAN_TO_MAPLOC, TASK_NEARBY_POICAT, TASK_CENTER_ON_MAP, TASK_DO_ADD_FAVOURITE, TASK_CURSOR_INTO_POI, TASK_TRAVEL_VIA.

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 (0x0d,0x0a). 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.

3-30-2011 New Information about invoking whole portions of the hard-coded menu in your custom menu using navcore version 8.xx & 9.xx

There is a way to capture the whole internal hard-coded preferences menu into your custom menu which allows all the internal commands in the preferences menu to be available for use in your custom menu.

1.If you do not define a MENUBLOCK|BLOCK_PREF| in the TomTom.mnu file then the Navcore built in menu will kick in with the MENUITEM|TASK_MENU_PREFERENCES| command. Seems it defaults to the internal menu for lack of anywhere else to go. That then makes all the commands under the "Options" (in Easymenu) or "Preferences" (non Easymenu) hard-coded menu available as if you are in the built-in menu system. The XXL550 with Easymenu has 3-pages of these, the XLIQ Routes has 6-pages, other TT's you can get up to an additional 8-pages in a custom menu with just this single menu command.

2.One other quirk related to this, if you have a third party program like switchmenu or tripmaster that uses a .cap file and .bmp in the SdkRegistry, the custom menu will add the third party programs to the last page of the "Options" (Easymenu) or "Preferences" (regular menu) automatically, without needing to add or reference the MENUITEM|TASK_SDK command. This is only if you do not define a MENUBLOCK|BLOCK_PREF| and use MENUITEM|TASK_MENU_PREFERENCES| in your custom menu. The built-in menu has always added third-party icons with just a .cap and .bmp in the SdkRegistry but this was an unknown custom menu feature, another indication that this is accessing the hard-coded menu via this tweak.

I'm attaching a custom menu, which uses the quirks mentioned above, to this post if anyone wants to look at it or play with it. It's a zip file, has the TomTom.mnu and assorted .bmp files that work with this custom menu and also includes the switchmenu program with a modified cap file that lets the switchmenu script run from the SdkRegistry. Switchmenu allows switching between regular and custom menus without connecting to the computer, similar to the TTmenu. Just unzip or copy the whole contents to the SdkRegistry.

You can download an example menu that shows how it's done from here http://home.earthlink.net/~russellbaker/SdkRegistry.zip

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.

How to create your own color schemes

Table of Tasks (With Images)

The following tasks can be used in the Main Menu Block **BLOCK_MAIN**
& the Preferences Menu Block **BLOCK_PREF**
Main Menu 1 of 3
«taskname»	x30 «icon»	x40 «icon»	«description»
TASK_NAVIGATE_TO			Navigate to
TASK_MENU_FIND_ALTERNATIVES			Go to "Find alternative" menu
NOT AVAILABLE (Help Me)			Help Me is not an available task You can still access the guides in the document viewer but no Drive, Walk, etc., buttons
TASK_MENU_PHONE			Mobile phone
TASK_MENU_DOWNLOAD			Download extras Switched with "Mobile phone" if mobile is present!
TASK_MENU_PREFERENCES			Change Preferences (View Preferences Menu Block BLOCK_PREF)
Main Menu 2 of 3
«taskname»	x30 «icon»	x40 «icon»	«description»
TASK_MENU_PLAN_ATOB			Advanced planning
TASK_SHOW_MAP			Browse map
NOT AVAILABLE (Map corrections)			Must use browse map or quick menu to access Map corrections
TASK_ADD_FAVORITE			Add favourite
TASK_MULTIMEDIA			Go to multimedia menu
Main Menu 3 of 3
«taskname»	x30 «icon»	x40 «icon»	«description»
TASK_MENU_TRAFFIC			TomTom Traffic
TASK_MENU_DOWNLOAD			Go to "Downloads" menu
TASK_MENU_PHONE			Mobile phone
TASK_CONFIRM_DELETE_ROUTE			Clear Route with asking the user confirmation first
TASK_MENU_ROUTE_INSTRUCTIONS			Show the menu with options for vieuwing route
TASK_ITINERARY			Itinerary planning
Preferences 1 of 8
«taskname»	x30 «icon»	x40 «icon»	«description»
TASK_SWITCH_NIGHTVIEW			Switch to night view mode
TASK_CONFIGURE_POI			Choose which types of POI to show
NOT AVAILABLE (Saftey Preferences)			Not an available task Also no way to access this
NOT AVAILABLE (Voice Preferences)			Not an available task You can use two others though
TASK_SWITCH_SOUND			Enable/disable sound
Preferences 2 of 8
«taskname»	x30 «icon»	x40 «icon»	«description»
TASK_SET_VOLUME			Adjust the voice volume
TASK_MAINTAIN_FAVORITES			Maintain the list of favorites
TASK_CHANGE_HOME_LOCATION			Specify new home location
TASK_MANAGE_MAPS			Go to "Manage maps" menu
TASK_MAINTAIN_POI			Go to POI maintenance menu
Preferences 3 of 8
«taskname»	x30 «icon»	x40 «icon»	«description»
NOT AVAILABLE (Change Car Symbol)			Not an available task Also no way to access this
TASK_SWITCH_2D3D			Switch between 2D and 3D navigation view
NOT AVAILABLE (Hide Lane Images)			Not an available task Also no way to access this
TASK_SET_COLOR_SCHEMES			Choose day and night color schemes
TASK_SET_BRIGHTNESS			Adjust the brightness level for the device
Preferences 4 of 8
«taskname»	x30 «icon»	x40 «icon»	«description»
TASK_SET_STATUS			Specify the information to show at the bottom of navigation view
TASK_ABOUT			show Navigator information screen
NOT AVAILABLE (AutomaticZooming)			Not an available task Also no way to access this
NOT AVAILABLE (Quick Menu Preferences)			Not an available task Also no way to access this
TASK_TUTORIAL			Guided tour
NOT AVAILABLE (Voice Control Preferences)			Not an available task Also no way to access this
TASK_SET_NAME_DISPLAY			specify naming preferences for map/navigation views
Preferences 5 of 8
«taskname»	x30 «icon»	x40 «icon»	«description»
TASK_SET_DIST_UNITS			Choose distance units
TASK_LEFTHANDED			Switch between lefthanded and righthanded UI
TASK_SET_KEYBOARD_SIZE			Set preferences (size and type) of the on-screen keyboard
TASK_SET_PLANTYPE			Set the preferences for route planning
TASK_SET_TOLL			Set the preferences for toll roads
Preferences 6 of 8
«taskname»	x30 «icon»	x40 «icon»	«description»
TASK_ASK_CHANGE_OWNER			Set Owner
NOT AVAILABLE (Speaker Preferences)			Not an available task Also no way to access this
TASK_SET_CRADLE			Set cradle preferences This also appears to produce the traffic icon
NOT AVAILABLE (Music Preferences)			Not an available task Also no way to access this
NOT AVAILABLE (Start-Up Preferences)			Not an available task Also no way to access this
Preferences 7 of 8
«taskname»	x30 «icon»	x40 «icon»	«description»
TASK_SWITCH_BLUETOOTH			Enable/disable bluetooth connectivity
NOT AVAILABLE (Disable Wireless Data)			Not an available task Can use BlueTooth Preferences to access this
NOT AVAILABLE (Send/Receive Files)			Not an available task Also no way to access this
TASK_SERVICE_LOGIN			Perform login to the TomTom Plus services
NOT AVAILABLE (Battery Saving Preferences)			Not an available task Also no way to access this
Preferences 8 of 8
«taskname»	x30 «icon»	x40 «icon»	«description»
TASK_SET_LANGUAGE			Choose application language
TASK_SET_CLOCK_TYPE			Set clock type
NOT AVAILABLE (Show Fewer Menu Options)			Not an available task Also no way to access this
TASK_SWITCH_TIPS			Enable/disable tips
TASK_RESET_SETTINGS			Restore original application settings