Le logiciel TomPlayer est accessible au téléchargement sur sourceforge : un simple click sur le bouton vert Download TomPlayer donne accès à la dernière version officiellement délivrée.

Vous pouvez aussi le trouver ICI en même temps que les skins actuellement développés pour lui et qui ne sont pas encore inclus dans la livraison officielle… Attention cependant, cette version est “remaniée” graphiquement, car elle contient les images “loading/exiting” en français, et des icônes pour TomPlayer. Sinon, le soft et le pack de skins de base sont identiques.

Le Logiciel téléchargé se présente sous la forme d'une archive zip qu'il convient de décompresser sur le disque dur. Cette archive contient, entres autres, les répertoires suivants :

• src : Il s'agit du répertoire contenant le code source du logiciel et qui n'intéresse sans doute que les développeurs. Cependant, en sa qualité de logiciel libre, ce soft est livré avec son code source.
• distrib : Ce répertoire contient les éléments permettant l'installation sur le TomTom
  • SDKRegistry : Ce répertoire contient les fichiers permettant l'intégration de l'icone TomPlayer dans le menu du logiciel de navigation.
  • tomplayer : Ce répertoire contient le logiciel lui même, ses fichiers de configuration ainsi que ses ressources graphiques.

Dans l'absolu, le répertoire tomplayer peut être copié n'importe où sur un support accessible à votre TomTom. Selon votre modèle, cela peut être un disque dur, la flash interne de TomTom ou encore une carte SD-Card externe. Nous conseillons d'installer TomPlayer et vos fichiers Audio/Video sur un support aisé à remplacer au cas où une utilisation intensive vous conduirait à atteindre le nombre de cycles d'écriture maximal que ces supports peuvent endurer.

De façon courante, les utilisateurs procèdent à cette copie:

• Soit en insérant leur SD card dans un lecteur dédié du PC et en procédant à une copie sur le disque amovible. cette solution est avantageuse car elle permet d'utiliser une SD Card de 2 Go (attention à ne pas aller au-delà de cette capacité et ne pas prendre de carte HC pour des problèmes de reconnaissance par le TT).
• Soit en connectant leur TomTom sur sa docking station et en arrêtant TomTom Home s'il se lance afin de pouvoir simplement procéder à une copie sur le périphérique de masse qui apparait alors.

Une fois tomplayer copié, il faut penser à adapter le fichier de configuration tomplayer.ini pour y indiquer les répertoires audio et vidéo qu'il doit utiliser. Le format du fichier de configuration est expliqué en détails dans la section suivante.

Afin d'intégrer une icone TomPlayer dans le menu du logiciel de navigation, il convient :

1. D'éditer le fichier tomplayer.cap et d'adapter la ligne

AppPath|/mnt/sdcard/tomplayer/|

afin de pointer vers le chemin correspondant au lieu d'installation du répertoire tomplayer. A titre d'information, si vous avez copié le répertoire tomplayer sur la racine de votre support de stockage, il est probable que le chemin à utiliser soit :

• Directement le chemin proposé /mnt/sdcard/tomplayer/
• ou bien le chemin suivant /mnt/movinand/tomplayer/ (c'est notamment le chemin à utiliser si tomplayer est stocké sur la sdcard externe d'un TT GOx20)

2. De copier les fichiers tomplayer.cap et tomplayer.bmp dans le répertoire SDKRegistry qui se trouve à la racine de votre support de stockage hébergeant le logiciel de navigation. Si ce répertoire SDKRegistry n'existe pas, créez le.

Note : Avant le patch disponible avec la version V0.10 de Tomplayer, il était nécessaire de créer un répertoire ou un fichier vide nommé nowatchdog à la racine mais ce n'est plus nécessaire. C'est même fortement déconseillé.

Cette section explique le contenu du fichier de configuration tomplayer.ini.

Ce fichier adopte une syntaxe de type fichier INI que l'on rencontre, par exemple, sous Windows. Dans la section [general] , on trouve les paramètres suivants :

• loading qui pointe vers le chemin relatif de l'image à afficher lors du démarrage de tomplayer.
• exiting qui pointe vers le chemin relatif de l'image à afficher lors de la sortie de tomplayer.
• filter_video liste les extensions de fichiers à afficher dans l'onglet video. Nous déconseillons de modifier cette variable à moins d'être certain de ce que vous faites.
• filter_audio liste les extensions de fichiers à afficher dans l'onglet audio. Nous déconseillons de modifier cette variable à moins d'être certain de ce que vous faites.
• video_dir désigne le répertoire dans lequel Tomplayer se trouvera par défaut sur l'onglet vidéo. Il est fréquent de devoir adapter ce chemin si le répertoire video n'est pas monté sur /mnt/sdcard mais plutot sur /mnt/movinand en saisissant par exemple :

video_dir=/mnt/movinand/video

• audio_dir désigne le répertoire dans lequel Tomplayer se trouvera par défaut sur l'onglet audio. Il est fréquent de devoir adapter ce chemin si le répertoire audio n'est pas monté sur /mnt/sdcard mais plutot sur /mnt/movinand en saisissant par exemple :

audio_dir=/mnt/movinand/audio

• screen_saver_to définit le délai (en secondes), avant l'extinction de l'écran en mode audio.

Attention : Tous les noms d'images indiqués dans ce fichier doivent correspondre aux images pour écrans de résolution 320*240. Des images au format écran large 480*272 de même noms préfixées par ws_ existent également dans le répertoire skin. Tomplayer détecte automatiquemet le format de l'écran et rajoute le préfixe ws_ aux noms des images qu'il essaie de charger s'il détecte un écran large. Le fichier de configuration ne doit donc jamais contenir de nom d'image commencant par ws_ même sur un TomTom avec un écran large…

Dans la section [audio_skin] , on trouve les paramètres suivants :

• filename désigne le nom du skin à utiliser pour la lecture des fichiers audio.

filename=./skins/audio/audio_skins.zip

Dans la section [video_skin] , on trouve les paramètres suivants :

• filename désigne le nom du skin à utiliser pour la lecture des fichiers vidéo.

filename=./skins/video/video_skins.zip

Note : Avant la version V0.11 de Tomplayer, les possesseurs de TomTom ayant des coordonnées écran XY inversées devaient avoir des actions de configuration manuelles mais ce n'est plus le cas.

Un skin est une archive au format “zip” qui est l'association de deux fichiers :

• un fichier graphique au format BMP.
• un fichier de description qui indique en particulier où sont les différents boutons et les actions qui leurs sont associées.

Dans une telle archive, on peut trouver le skin associé à un tomtom avec un écran large et le skin associé à un tomtom avec un écran normal. Le fichier de configuration pour un écran normal doit se nommer skin.conf. La configuration pour un écran large se nomme ws_skin.conf.

Notez que les fichiers de configuration peuvent être au format windows, et sont donc éditable avec le bloc note de windows.

Les skins “audio” sont à placer dans le répertoire ./skins/audio. Les skins “vidéo” doivent être mis ./skins/video.

Ce fichier adopte une syntaxe de type fichier INI que l'on rencontre, par exemple, sous Windows.

Dans la section [general] on trouve les paramètres suivants :

• textx1 : définit l'abscisse du coin supérieur/gauche de la boite de texte dans laquelle sera affiché le nom du fichier en cours de lecture.
• textx2 : définit l'abscisse du coin inférieur/droit de la boite de texte dans laquelle sera affiché le nom du fichier en cours de lecture.
• texty1 : définit l'ordonnée du coin supérieur/gauche de la boite de texte dans laquelle sera affiché le nom du fichier en cours de lecture.
• texty2 : définit l'ordonnée du coin inférieur/droit de la boite de texte dans laquelle sera affiché le nom du fichier en cours de lecture.
• r : est la composante rouge de la couleur de transparence
• g : est la composante verte de la couleur de transparence
• b : est la composante bleu de la couleur de transparence
• image : est le nom du fichier image associé à cette configuration. Il est préférable d'utiliser un format de fichier qui gère la transparence (comme GIF ou PNG).
• text_color : Définit la couleur du texte du nom de fichier sous la forme d'une unique valeur telle 0xFF0000. Pour une liste de tels codes couleurs vous pouvez consulter ce lien. Attention le préfixe à mettre dans le fichier de configuration est 0x et non #.

Ensuite, pour chaque bouton du skin, une section est définie. La section porte le nom CONTROL_ auquel on vient concaténer un numéro de contrôle (en fait, un simple compteur qui commence à 0). La liste des noms des contrôles sera donc :

CONTROL_0 CONTROL_1 CONTROL_2 CONTROL_3 etc..

Il faut être particulièrement vigilant au numéro de contrôle ! Il faut bien veiller à ce qu'il n'y ait pas de trou. En effet, si on a 10 contrôles, et que dans la numérotation on a oublié le 4, alors tous les contrôles qui sont après le 3 seront ignorés !

Remarque : actuellement, le nombre maximal de contrôle est défini à 20.

Donc le nom du contrôle défini une section qui comporte plusieurs paramètres :

• type : le type de contrôle (bouton rectangulaire ou circulaire, barre de progression horizontal ou vertical)
• ctrl : la commande associée au contrôle (lecture/pause/augmentation du volume, etc..)
• les coordonnées du contrôle ainsi que ses dimensions

Commandes disponibles :

Contrôles disponible :

Signification des paramètres:

• x et y définissent les coordonnées du centre du cercle, et r indique le rayon du cercle.
• x1 et y1 définissent les coordonnées du coin supérieur gauche.
• x2 et y2 définissent les coordonnées du coin inférieur droit.

Spécification d'icones associés:

Dans la définition d'une barre de progression, le paramètre

• bitmap peut être rajouté afin de spécifier une image graphique à utiliser comme curseur

De même, dans la définition d'un statut batterie, le paramètre :

• bitmap doit pointer vers une images gif ou png contenant une animation.

Cette animation doit être constituée de 5 images :

• La première représente une connexion secteur.
• La seconde représente un plein niveau de charge
• La troisième représente une charge a 66%
• La quatrième représente une charge a 33%
• La cinquième représente une alerte de charge

Exemple :

[CONTROL_0]
ctrl=1
type=1
x=202
y=204
r=28

Dans cet exemple, on définit le contrôle CONTROL_0 qui est le premier contrôle. Son type est type=1, il s'agit donc bouton circulaire dont le centre est en x=202 et y=204) et le rayon est r=28 pixels. La commande associée à ce bouton est ctrl=1, il s'agit donc du commutateur PAUSE/LECTURE.