From TrekBuddy Wiki

Jump to: navigation, search

Device independent, general steps of installation and verification:

  1. Download the application from the forum (or the link to the forum on the left side)
  2. Install TrekBuddy application. See below for device specific details. In case you cannot find your device, check the the forum In case of problems, check Known Issues section below.
  3. Optional: Folder creation. Since version 0.9.81, TrekBuddy checks on start for its data folder (called datadir in Settings->Basic) existence & structure and if not present, user is asked whether folders shall be created. TrekBuddy attempts to select suitable location for its datadir folder (by default it tries to create folder called TrekBuddy at the memory card root), but it may fail sometimes; it may also fail if you create the folders in some unexpected location. In such case, you will see a warning DataDir not accessible. You should then correct the datadir location in Settings->Basic->DataDir). If you want to create the folders you self, then create a TrekBuddy folder in phone's memory (always present) or on the memory card (quick access on desktop computer using a card reader), see below for format and location depending on device, and then create the following subfolders (alphabetical order):
    • gc field notes are stored here
    • maps for maps and atlases
    • resources for optional custom icons, images, keymappings and map datums (see Customization) and translations (see Localization).
    • sounds for the optional sound that is played when reaching a route point (see Customization)
    • tracks-nmea for NMEA formatted and/or tracks-gpx for GPX formatted tracklogs (=file containing a track (=series of points) recorded by TrekBuddy). Check below or try out which format is supported by your device; several devices can write in both formats. More information on formats at Using. At least one of the two folders is strongly recommended.
    • ui-profiles where TrekBuddy searches XML configuration files for CMS-mode, see CMS
    • wpts where TrekBuddy searches for waypoints and records them to. Strongly recommended.
  4. Optional but recommended: Set application permission in order not to be asked dozens of time whether TrekBuddy is allowed to access the user data etc. It is device dependant where you can set those permissions, so see below. The TrekBuddy midlet is signed by Thawte Code certificate, so users have more options for setting up application permissions. Typically, in addition to Never Allowed and Ask Always (both not recommended), for signed applications Ask Once and Always Allowed are available - they are recommended for file and GPS access since TrekBuddy is designed make heavy use of both ;-) Here permission types you might want to set:
    • Read user data for settings, maps etc
    • Edit user data for tracklogs
    • GPS receiver access (depending on device, e.g. connections for access external GPS receiver on Symbian S60)
    • Send and receive, only required in Symbian S60 to conntect to the TrekBuddyService for access to TAR files over local network, see Tools#FAQ
  5. Optional: Add a CMS (i.e. a theme for the graphical interface, as TB comes with no predefined CMS). See CMS and [1] and [2]
  6. Connect to GPS (internal or external module). Remember that a restart of TB is required to have provider shown in menu as Start YourGpsName.
  7. Add maps and/or atlas by copying files/folders into proper TB folder on phone/card. Look at Maps or just download a sample atlas .tar-file from (not working 2 March 2011) Optionally choose a default map to be loaded at startup; see Configuration.
  8. Optional: Customize Configuration to your needs
  9. Check out Using so you can start to enjoy TrekBuddy and know about key mapping etc.
  10. Optional: Installation verification to make sure all functionality works
    • Copy waypoints file and try to navigate. Check if tracklogs are recorded.
    • Record a waypoint and add picture to waypoint.
    • Try to communicate position via SMS (send, for receiving you need to change Configuration).


Android Phones

Use separate build for android phones (apk). For older phones with Android 1.5 and earlier use 1.5 build. For phones with 1.6+ and ones with smaller/bigger LCD resolution use 1.6+ build (HTC Tattoo, Motorolla Droid). If your phone reports that TrekBuddy can't create folder, create the folders manually, or try 1.5 build (after the first run remove it from the device and install 1.6+ ).

Windows Phone 8

Third-party applications do not have write access to SD card. In order to use SD card with TrekBuddy, you have to create folder structure by hand (of course you do not need to create folders resources, sounds or ui-profiles if you do not plan any customization or folder wpts if you have no GPX files with watpoints that you would like to use).


Here is how TrekBuddy uses it:

  • maps (tar-packed in maps folder) are read directly from SD
  • GPX waypoints files (wpts folder) are synchronized to application storage (in internal memory)
  • files in resources, sounds and ui-profiles folders are also synchronized (ie. unpacked) to application storage (see Customization for WP8)

Tracks and waypoints files created by user are stored in internal memory which is unfortunately not easily accessible, unless you have Windows 8 PC where you can use Windows Phone Power Tools. TrekBuddy will support sending files over Bluetooth and to SkyDrive in the near future.




Use Nokia PC Suite.

  1. Connect your mobile as you regularly do (bluetooth, irda, serial, whatever)
  2. Open the PC Suite
  3. Click on "Install Application"
  4. Select trekbuddy
  5. Wait for the installation to complete

The program will end up in "Programs/Collection" as "Trekbuddy".

Once it is installed, you may want to setup the permissions:

  1. Go to "Programs/Collection" and put cursor on "TrekBuddy".
  2. Select Options->Application acces->Phone Access->Read user data->Always allowed
  3. do the same for Write user data

Symbian Series 60 (S60)

Install instructions

Use PC Suite to install, or do it directly on the phone:

  1. Copy trekbuddy.jar and trekbuddy.jad to the phone
  2. In the phone, use "File Manager" to browse to trekbuddy.jad The file manager may be found e.g. in Menu -> Settings -> Data mgr -> File mgr (for N6220 classic)
  3. Select it to start the installer
  4. Optional but highly recommended: set permissions in application manager in order not to be asked dozens of time whether TrekBuddy is allowed to access the user data etc.
    1. open App.Mgr (in German "Progr.-Man.") which you can find
      • directly in ->Menu
      • or directly in ->Tools
      • or directly in ->System
      • or in ->Menu/Tools->Applications
      • or in ->Menu->Settings->Data mgr->App mgr->Installed apps
    2. In the application manager, scroll to TrekBuddy, Options/Open, (Suite-)Settings and then set permission to "ask 1st time" or "always allowed" for the permission type you want, most important are Read user data and Edit user data - see general steps of installation (on top of page) for listing of relevant permissions.
  5. That's it! Be sure to check out Symbian TrekBuddyService. It enables backlight control and support for TARed maps/atlases.

Exception for install instruction (noticed with N6110 navigator): When getting an error message while installing: download the jar and the jad File to your phone via GPRS/UMTS/WiFi/USB-Cable(Datatransfer, not via the Nokia Application Installer) and manually start the installation process on your phone.

Certificate error: On some S60 devices, Thawte certificate is not allowed to be used for application signing. To enable it, do (eg. N95, 6680):

  1. go to Tools (or Menu)->Settings->General->Security->Certificate management-> MIDP2 Thawte->Options->Trust Settings
  2. set Application installation option to Yes

The MIDP2 Thawte Certificate may not be present in some 6210 Navigator Devices (see known Issues below)

Configuration information

Usually, C: is phone memory and E: is removable card. Hence, your TrekBuddy data dir may look like file:///E:/TrekBuddy (see Configuration).

With Symbian S60 the software on the phone scans all directories on the removable card. As a result all tiles will show up in Gallery, but also whenever you want to add a picture to a contact or simular. Since there may be a lot of tiles if you have a lot of maps, the phones memory is flooded with created thumbnails and there can be an error-message. To hide the tiles from Symbian set the Trekbuddy directory to 'hidden'. You can do this while connected to your pc in mass-storage mode, or through a third-party filemanager like Y-browser on the phone. You have to do this before! running any Nokia application on the phone.

If you accidently ran Gallery the thumbnails are in it's local cache, but there is a way out. Delete all _PAIbTN directorys in the Trebuddy dir. Set the Trekbuddy directory to hidden and change the name to f.i. 'trekbuddy.hid'. Now run Gallery again: it will not see the TB-dir and clean it's cache. Close Gallery and rename the Trekbuddy directory to 'Trekbuddy'. You should be good now.


W800i/W810i/W880i/K750i/K800i/K610i etc.

Installing TrekBuddy on a W800i/W810i/W880i/K750i/K800i etc. is quite straightforward. Either he USB-cable provided with the phone or a Bluetooth connection is required. The following instructions should work with Linux and Windows.

  • Connect your phone to your computer using the USB-cable or Bluetooth OBEX File Transfer.
  • A new drive should appear. It correspond to the memory stick of your phone.
  • Copy both trekbuddy.jar and trekbuddy.jad to MSSEMC\Media files\other\. Do not rename the files and copy them onto the memory stick, not the internal memory, as otherwise you may not be able to set the application permissions. Moreover, you can't create TB directories (maps, wpts etc) in the internal memory.
  • Disconnect your phone and go to Menu -> File manager -> Other.
  • You need to install trekbuddy.jad and not trekbuddy.jar. In order to find the good one, select More -> Information. You should see File type: jad. This is important, because only then you can configure the Java-Permissions of Read/Write user data to Never ask!
  • Select Install.
  • Select the destination. You probably want to select Applications.
  • Don't start application when phone offers this to you - you may want to set up application permissions first, to avoid confirmation prompts when accessing resources like files and/or bluetooth connection: go to Applications, find TrekBuddy, select More -> Permissions and set Read/Write user data to Never ask. Consider doing the same for Local connectivity.

Z520i (and other Bluetooth phones) using Mac OSX

Installing TrekBuddy on a z520i and surely on many other Bluetooth-enabled phones is quite easy.

  • be sure Bluetooth is enabled and visible on both computer and phone.
  • to transfer files, use the Bluetooth File Exchange application located into the Applications:Utilities folder (it is reachable also from the menu bar, on right, if you enabled the Bluetooth shortcut).
  • select your phone from the list of Bluetooth devices (wait until it is recognised).
  • if requested, do the pairing.
  • just navigate into the phone file system, until you find the "Other" folder (or the memory stick for phones having also that). Put there both jar and jad files. You might also just transfer the jar file, but you will not be able to use the signed midlet feature.
  • close the computer software, go to the phone, go to Menu -> File manager -> Other, and select the jad file.
  • Select Install.
  • Select the destination. You probably want to select Applications.

In the same way you will be able to transfer maps and other files.

K530i and HGE-100

  • Installation is straightforward
  • connect using the USB interface. In normal operation mode you will have to locate a folder in the selected language, using it in file transfer mode you will get the english default names.
  • copy both files into a folder of your choice, possibly create a new one.
  • On the phone locate the files, since their extensions are hidden you will see both having the same name. Select one and run the install command. The phone is smart enough to use tha jad file...
  • choose target, presumably applications rather than games.
  • once installed configure the communication to be serial; set the connection string to "comm:AT5;baudrate=9600". select HGE-100 location provider in Settings->Location
  • important to save the settings rather than just apply. Otherwise your phone will vibrate when the application is started.


  • Copy trekbuddy.jad and trekbuddy.jar to the device, eg. to Other directory on the memory card
  • Select trekbuddy.jad (the one that has Details option in the context menu when you press select View) and then Install to install the application

You may want to remap some keys for easier use - see Customization


On many Siemens/Benq phones Thawte certificate is not present and installation fails. Luckily, even for unsigned midlets, user can use Ask Once (or Allow for session) permission, so it is not a problem - either remove certificates and signature from the JAD file (see S65 installation bellow), or do not use it at all.


A DCA-540 data cable is needed to install TrekBuddy from your PC on a Siemens SXG75.

The easy way of installing TrekBuddy is by using the JMI (Java Midlet Installer) After the phone is recognized by the JMI, select the Java Application radio button, find the trekbuddy.jar and trekbuddy.jad files on your system (you should put them in the same folder) and click Install. The JMI will ask you to reset the phone automatically but you can also do it yourself.

If you experience problems (TrekBuddy does not appear in the Apps folder after installation) you may need to edit the trekbuddy.jad file. Simply delete the last couple of lines containing the Midlet certifications. (Actually, it's enough to remove the 'MIDlet-Jar-RSA-SHA1:' line.)

The JMI may not work with every firmware version. Another method is using the Brew Mobile Commander. Create a trekbuddy.jad from the jar using JADgen (The generated jad file does not work since v 0.97x, so edit the supplied jad file as mentioned above). Right click trekbuddy.jar and choose install.

It is recommended to create a subdirectory tb in brew/shared (so a user independent directory (not efs-user) that is not stored on memory card (efs-mmc)) with subdirectories resources, sounds, tracks-gpx, ui-profiles and wpts. Set the data directory to file:///fs/tb/ in the Settings. The maps can be stored on the memory card. See in the TrekBuddy forum under Themes what to store in ui-profiles and resources. You can download a sound that's played when reaching a route point.


Filesystem in SXG75 showing TrekBuddy data directory structure


  1. download generic version
  2. open trekbuddy.jad in editor and remove all lines beginning with MIDlet-Certificate- and MIDlet-Jar-RSA-SHA1
  3. copy trekbuddy.jar and trekbuddy.jad to phone (over Bluetooth or cable)
  4. click on trekbuddy.jad, select when the application should be installed (Applications)
  5. on first launch, when asked for permission to access some file, change permission scope to "for relation"
  6. open the menu settings/basic and set the datadir to your TrekBuddy installation path e.g.: file:///0:/java/jam/applications/TrekBuddy/


For Motorola P2K phones (mostly 3G specific) see: Requirements


See forum

  1. Activate your GPS integrated chip by this file or this one The first file is better because it activates GPS on port3 - and battery works longer that on com5. Restart you phone.
  1. Install Jbed on your Q9h, so you can run Java applications. Or you can use any other link of Jbed - doesnt matter.
  1. Copy jad jar files of Trekbuddy on yor Q9H.
  1. Run Jbed on your device and there install Trekbuddy (Menu>install>local files)
  2. Copy GpsPortPPC.exe to your device and run it. Choose Your GPS activated port. Put GpsPortPPC.exe and background running.
  1. Run Jbed, there open your installed Trekbuddy, push Start - everything works very good!


See forum

For generating Certificates for File-Access see here:


How To Bypass Signing and Unlock Gps [3]

How to: Install PC Studio 3 and Games/Apps (TKFileExplorer) Guide [4]

You may need to pair your bluetooth GPS with the phone before you start using TrekBuddy.

For touchscreen phones, add the following line to JAD file (or before installation:

MIDlet-Touch-Support: True

To prevent scaling with full screen, add to

MIDlet-Scaleup-Support: false

S5230 Star

Use the above way, or you may install TrekBuddy as unsigned application from memory card. In this case, you will have to confirm that TrekBuddy can read and write files when it starts (it is not big deal, IMHO). Just remove from the JAD file all 3 lines beginning with MIDlet-Certificate-... and also the one that start with MIDlet-Jar-RSA-SHA1.... And do not forget add MIDlet-Touch-Support attribute to the JAD file (see above).

S5230 Star (method 2)

Situation: you try to install unsigned TrekBuddy (see above) from memory card but you get "Unsupported file type". This happened to me after I flashed XPIK5 firmware. You can use "html" way to install unsigned TrekBuddy:

  1. create a text file called install.html and put

<html><body><a href="trekbuddy.jad">install TrekBuddy</a></body></html> into it

  1. copy the file to the folder where trekbuddy.jar and trekbuddy.jad files are
  2. in the phone, use built-in file browser and open the install.html
  3. when the HTML page opens, double click on "install TrekBuddy" link and follow instructions


How To increase JAR file size limit:

  1. Enter (dial) *#52828378# to open JAVA Test Menu
  2. In OTA Test, set Maximum JAR size (KB) to 512

You may also want to increase heap memory in Memory Test, set both values to 2048 (or more :-) )


KU 990 Viewty

My basic phone specs.

Phone: KU990 Firmware: Version 10a Operator: T-Mobile (UK) Memory: Micro sd 1GB GPS Device: Bluetooth enabled Keychain GPS 2000 by Freedom

Note: Before installing TrekBuddy, pair your GPS device with your phone first and grant all necessary permissions.

  1. Download trekbuddy.jar from this site. The phone will save the file to My Stuff, External Memory, Others
  2. Navigate to trekbuddy.jar file on your phone and double tap on the name to begin installation.
  3. Grant all permissions requested by the application during installation.
  4. Switch on your GPS device and start Bluetooth on your phone
  5. Navigate to the installed TrekBuddy application which should now be found in My Stuff, My Games and apps and double tap the screen to start the app.
  6. On the screen you should now see a map of the world and the word "Options" above the left "soft key" of the phones native navigation console/display. Tap "Start" and TrekBuddy will search for your GPS device. Once the name of your device appears tap on "Select" and wait for TrekBuddy and the GPS device to connect. Note: The next time you start TrekBuddy the name of your GPS device will have been added to the TrekBuddy menu so you can select it.
  7. Tap Options to open the TrekBuddy menu and then tap "Settings". Scroll through to set your desired settings. (See Help, Manuals, How Tos elsewhere on this site)

Almost Done!

  1. In order to use all the functions of TrekBuddy you'll need some maps, which you can obtain from elsewhere on this site. The important thing to do is to set up the following directories on the phone sd card for storing maps, waypoints and track logs.

Note: The easiest way I have found is to connect the phone to your computer (usb cable) and use the normal Windows file explorer to create directories on your sd card. When you download maps later you can save them directly to the card it's really simple. You can also do the same thing with phone file explorers such as Mobyexplorer

  1. Connect phone and navigate to the sd card using windows file explorer then create then the directory /TrekBuddy.
  2. In the /TrekBuddy directory create 3 further sub-directories, /tracks-gpx (gpx track logs will be saved here), /tracks-nmea (NMEA track logs will be saved here, /wpts (waypoints will be saved here)
  3. The final step is to tell TrekBuddy where these directories are. Start the TrekBuddy app and tap the left soft key to bring up the menu. Tap Settings, tap Basic, scroll down the menu and tap Data Dir, enter the following, file:///Card/TrekBuddy The other 3 sub-directories which we created above are used by TrekBuddy.


TrekBuddy works on my phone and it's brilliant. If you encounter any difficulties with the above it is more than likely your phone specs are not the same as mine or I've made a "mistake" in above description. Please let me know. (Ricster)

LX260 Rumor

How to enable GPSOne (must have Internet access):

  1. Dial - ##477# to enter GPS Menus
  2. Select GPSOne (1)
  3. Select NV (5)
  4. Select Transport (1)
  5. Select Type (1)
  6. Set to IP
  7. Select Default (2)
  8. Select IP Address (1)
  9. Enter 068028031049 Press Enter/OK
  10. Select IP Port (2)
  11. Enter 5017 Press Enter/OK
  12. Press Back three times
  13. Select Start Application (4)

If all went well it will respond with "gpsOne in progress" and then will show GPS info in numerous screens. Press End twice to exit GPS Setup.

LG Renoir

See notes above for installation on LG, but you may want to add these attributes to JAD file before installing to get it runing in fullscreen (TODO: check meaning of these attributes):

MIDlet-Touch-Support: True 
UseNativeTextButtons: false 
ReverseSoftkeys: true 
UseNativeCommands: false 
LGE-MIDlet-TargetLCD-Height: 400 
LGE-MIDlet-TargetLCD-Width: 240


Security hack: TrekBuddy forum post


Treo 650

To install TB on Treo, please make sure, you have installed JAVA Runtime. Then it is quite easy:

  1. download the jar file
  2. translate jar to prc with jartoprc_w.exe from the java runtime kit

  1. download trekbuddy.prc
  2. install the prc file
    • with the next hotsync,
    • or copy it to your SD card in the folder /palm/launcher/
  3. follow the HOWTO from kruch

Hint: 'Preferences->IBM Java VM' set 'Use high resolution coordinates'.

How to get and install Java for Palm

Quoting "As of January 12, 2008, Palm no longer has rights to distribute the IBM WebSphere Micro Environment Java Virtual Machine (JVM - info) to our customers"

Note: you need to find

For Palm OS Devices, one can download the enviroment from resp. For some devices the environment is for free and support JSR-75 for file access (otherwise you need to install fileconnect.prc).

Now extract the archive, and install all the needed prc files with the next hotsync to your TREO (not on SD card).

In the subfolder JVM\PalmOS JVM 5.7.2\Tools\bin you will find the program called jartoprc_w.exe for translation of jar or jad files to the palm specific *.prc format. Start it and give the path to the jar / jad file. [Image:]

There is no need to convert it anymore, since trekbuddy.prc is provided by default, and it is signed.


Use Blackberry Desktop Manager to install TrekBuddy to the device. Or use Over-The-Air installation.

Tip: "Also a bit of a tip to 8310 users, if you can't add the installation with the BB desktop manager, connect the BB to the pc with usb and put the .jad instalation file somewhere with according 2 files and then unplug it, go to media and switch browse files ==> open the .jad file and instalation will begin. Also you might want to set permission level to allow." bgluvacevic

Another user installation experience here

Note: "Upgrade to newer version using Upgrade option in Desktop Manager never worked for me - I had to remove previous version and install the new one from scratch." kruch

Windows Mobile

Professional (Pocket PC)



Install Jbed Java on your WM Device

  1. copy the VGA/QVGA Esmertec Jbed cab to your WM device
  2. install it by opening the .cab file via filebrowser

Install Trekbuddy on your WM Device

  1. copy trekbuddy.jar and trekbuddy.jad to a Dir on Device, e.g. 'Temp'
  2. open FileBrowser on device, navigate to the TB files, click (open) the trekbuddy.jad file, TB will setup, answer all Questions with "Yes"

Examples for DataDir path on Local Filesystem (path is case sensitive)

  • file:///TB

DataDir on Memory Card

  • file:///Storage Card/TB
  • file:///MemoryCard/TB

Standard (Smartphone)

Yossik guide (in Czech) here


IBM J9 may be better choice for WM2003 (I do not think Esmertec supports it). IBM J9 6.1.1 PocketPC version Download Link does not work



See forum topic [5]

Windows PC editions (XP, Vista, etc.)

Download the Sun Java (TM) Wireless Toolkit from and install it. Open <JavaWTK-install-folder>\bin\ktoolbar.exe and import the TrekBuddy JAD as Projekt. Click run icon. Now an emulator is starting up and you can run TrekBuddy. You can set a position in menu - MIDlet - External events. TODO: How can life gps data be imported??

Known Issues

Branded phones

Branding is evil. Some GSM providers modify the firmware of the phones they sell with their plans. In some cases (see below), Thawte root certificate is missing. This prevents TrekBuddy from being installed as a signed application. Constantly having to confirm file system access and similar security messages are the result.

List of affected Providers/Phones

  • Vodafone Germany: SE K800i, K750i
  • Vodafone Spain: Nokia 6234
  • Vodafone Netherlands: SE v630i
  • Vodafone New Zealand: Nokia 5310,SE K800i
  • Movistar Spain: Samsung L760
  • Orange Israel: Nokia 6288
  • Proximus/Vodafone Belgium: SE K800i and V630i
  • Telstra Australia - SE W810i
  • Orange Slovakia: SE K800i
  • Rogers Canada: SE W810i
  • Orange Poland: LG KF750
  • Plus Poland: Samsung GT-S5230G (Avila GPS)
  • Roger Canada: Motorola Tundra VA76r

Possible Solutions

  • Try to get a firmware update from your local retailer
  • Get your phone "debranded" / "Unlocked", either in a local cellphone-store, or via the internet
  • Try to fix the firmware yourself (may be dangerous)
  • Do an unsigned installation and live with the nag-screens

The first two solutions are preferable, although are not entirely free. Some phones have internal firmware upgrade support, others include software and cables to install upgrades at home. Phone shops often bill a few euros for this service. Debranding services are a few dozen euros. Fixing the firmware yourself is a dangerous (may cause a inoperable phone), very model specific and, depending on local law, illegal procedure.

An unsigned installation can be made by erasing the .JAD-File and selecting the .JAR-File upon installation.

"Operation failed" on Sony Ericsson phones

Remove line starting with MIDlet-Certificate-1-4 from trekbuddy.jad and try installation again.

Nokia N95 (also 6290)

SecurityException is thrown whenever a file is to be read or GPS accessed, even though permissions are set up accordingly.


In the JAD file, Rename attribute MIDlet-Permissions-Opt to MIDlet-Permissions, and reinstall the application.

Nokia 6210 Navigator (german)

CertificateError while installing Application. It seems, that some devices do not have the MIDP2 Thawte certificate installed. See Discussion in nokia Forum: [6]

Workaround (N6210 Navigator)

Only install the .jar-file without using the jad file. This works with all devices, wich don't have the right certificates. Problem: You have to manually accept every single read/write action of TrekBuddy. This results in ca. 10-20 times clicking "yes" at startup + each time opening maps/atlases or starting to write a track.

Nokia 6230i Invalid application

Application is grayed out in menu, "invalid application" when trying to start the application


Remove the folllowing lines from trekbuddy.jad:


Samsung SGH-I550 (Firmware i550XXHH1,unbranded)

Problem: The phone asks for permissions over and over again. Solution: Install from .jad-File. Open "Installations", "Application manager", select TrekBuddy in the list, open it and change confirmations as desired.

--more to come--

Personal tools