Thread: How To: TomTom Custom Menu From OpenTom

The TomTom Wiki opentom.org has been off-line for about a year and seems to have been abandoned. Most of these instructions from that site are still current for version 8.xx and version 9.xx navcores. Version 9.xx Navcores may need a small change to the menu in order to work, that change is discussed in post #3 of this thread. You cannot do a custom menu on version 10.xx and later.
------------------------------------------------------------------------------------------------------------------------------
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 or 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.

1- Main menu block
Now paste the following into the file and save it

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|

2- Preferences menu block
If you would like to customize preferences menus, add the following at the end of previous file

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 navcore 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.

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 (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.