you may want to have a look at Stevil's getting started manual, if this documentation is not clear enough.

There is another very good tutorial by izzo9mm especially for people that have a navigation software v8 or above.

TomPlayer software can be downloaded on sourceforge : a single click on the green button Download TomPlayer gives access to the last official delivery.

You can also find a repackaged version at HERE where there are also in development skins that are not yet in the official delivery… Beware that this version is graphically different : new French pictures for (loading/exiting), 2 new small skins and another TomPlayer icon. But Tomplayer binary is the same as the official version.

The downloaded software is a zip file that you have to uncompress on the hard disk. This archive contains the following directories :

• src : The source code can be found in this directory. Even if it may be interesting only for a few persons, it is provided because TomPlayer is free software.
• distrib : This directory is filled with the necessary items to install TomPlayer on a TomTom.
  • SDKRegistry : Files that enable to insert a TomPlayer icon into the navigation menu.
  • tomplayer : This directory is filled with TomPlayer software by itself, its configuration files and its skins.

Generally speaking, tomplayer directory can be copied anywhere on a media that can be read by your TomTom. According to your TomTom model, you can install it on a hard disk, internal flash or an external SD-Card. We highly recommend to install TomPlayer and media files on an “easy to change” support (in case an intensive usage would lead to reach the maximum number of write cycles of your Flash).

Most users copy the files by one of the following methods:

• They insert their SD-Card in a dedicated reader for their computer and copy the tomplayer directory on the amovible disk
• They connect their TomTom on its docking station, they stop TomTom Home if it is automatically launched and they copy tomplayer directory on the new mass storage.

Once Tomplayer has been copied, tomplayer.ini configuration file may have to be modified in order to set audio and video directories that are to be used by Tomplayer. This configuration file format is described in the following section.

In order to integrate TomPlayer icon the navigation software menu, you have to

1. Edit tomplayer.cap file and change the line

AppPath|/mnt/sdcard/tomplayer/|

to make it point to the place where tomplayer directory has been copied. For your information : If you have copied tomplayer directory on your storage root, the appropriate path is likely to be :

• whether the default path /mnt/sdcard/tomplayer/
• whether the following path /mnt/movinand/tomplayer/ (For instance, it is the right path when TomPlayer is stored on an external SD-Card on a TomTom GOx20)

2. copy tomplayer.cap and tomplayer.bmp files in SDKRegistry directory (This directory is on your main storage root. If it does not exists than create it.)

Note : Before the available patch for TomPlayer V0.1, it was necessary to create an empty file or a directory entitled nowatchdog on the root. It is no longer needed and you have to avoid to create such a file.

This section describes tomplayer.ini configuration file.

This file follows an INI type format similar to some windows configuration files. In the [general] section, the following parameters can be found :

• loading is the relative path the the picture that has to be displayed on TomPlayer start.
• exiting is the relative path the the picture that has to be displayed on TomPlayer end.
• filter_video lists the file extensions that have to be displayed in the video tab of TomPlayer IHM. Do not modify this unless you are perfectly aware of the consequences of your modifications.
• filter_audio lists the file extensions that have to be displayed in the audio tab of TomPlayer IHM. Do not modify this unless you are perfectly aware of the consequences of your modifications.
• video_dir parameter sets the default directory for searching video files. Tomplayer will display this directory on the video tab. Changing this parameter is often needed.For instance, when the video directory is not mounted on /mnt/sdcard but on /mnt/movinand you have to change the line according to the following :

video_dir=/mnt/movinand/video

• audio_dir parameter sets the default directory for searching audio files. Tomplayer will display this directory on the audio tab. Changing this parameter is often needed.For instance, when the audio directory is not mounted on /mnt/sdcard but on /mnt/movinand you have to change the line according to the following :

audio_dir=/mnt/movinand/audio

Warning : Every picture filenames of this file point to pictures for “small” screens that have a 320*240 resolution. Widescreen picture files for 480*272 screens exist in the skin directory. Their name is prefixed by ws_. Tomplayer automatically detects the screen format and adds the ws_ prefix to filenames if needed. So, never set directly ws_ filenames in tomplayer.ini configuration file even if you have a TomTom equipped with a widescreen.

: TODO configuration and skin filenames configuration

Note : Before Tomplayer V0.11, TomToms that have inverted XY coordinates were subject to specific manual configuration. This is no longer the case.