From TrekBuddy Wiki

Jump to: navigation, search


Model-independent / Setup explained


  • Startup map - map or atlas to be loaded upon start. It is full URL, example: file:///E:/trekbuddy/maps/map.tar (file on memory card in Nokia). It is not necessary to set the URL by hand - if loading via Options -> Load Map / Load Atlas succeeds, you are asked whether you want it to use as a default. For default map, leave the field empty. Default: empty
  • Default Datum - default map datum (used when not detected). Default: WGS 84
  • Coordinates - selects display coordinates format. Default: <Map Lat/Lon>
  • Unit System - unit system to use (metric, imperial, nautical). Default: metric
  • Startup screen - shall map or compass/HPS or CMS be shown after startup? Default: map
  • Data Dir (since v0.9.94) - root data directory for maps, tracks, waypoint and tracklogs. It is directory URL, example file:///E:/TrekBuddy/ (Nokia, SE) or file:///fs/tb (internal memory on Siemens SXG75). See below and Installation for more more information for your mobile device. Default: best guess for given device.


  • fullscreen - fullscreen display (restart required). Default: ON
  • safe colors - force hardcoded colors to be used for waypoints/tracks files and waypoints lists, otherwise phone theme colors will be used. Needed only on some phones (like SE K550i) when you see the waypoint list just as black background and white text, and you don't see which item is selected. Default: OFF
  • no sounds - turns off provider status change acoustics. Default: OFF
  • no questions (since v0.9.94) - no "Do you want to quit?" nor "Use as default map?" question (a workaround for some Samsungs where Yes/No dialog hangs). Default: OFF
  • no softkey menu - TODO describe! (since 1.1.1?) Default: OFF
  • no item commands - TODO describe! ((since 1.0.14) Default: OFF
  • (old version only) nautical view - distance is shown in knots
  • show trail - Show trail (=track, historic positions)? Default: OFF
  • decimal precision - when showing lat/lon in degrees: Shall only the integer part of seconds be shown or also fractions? Default: OFF
  • HPS true wpt azimuth (old naming "HPS wpt true north)" - azimuth to a waypoint is north-oriented. Default: ON
  • easyzoom with volume keys - switch between layers using hardware volume keys (new in 1.1.1?) Default: OFF
  • OSD basic - display 1st line in OSD (ie. coordinates). Default: ON
  • OSD extended - display 2nd OSD line (time, speed and altitude or, during navigation, distance and delta). Default: ON
  • OSD scale - show scale (eg. |---| equals 700m) in bottom left of map? Default: ON
  • OSD no background - no grey background. Default: OFF
  • (old version only) OSD medium font - medium font. Default: OFF
  • OSD bold font - bold font. Default: OFF
  • OSD black color - ON for black colored text in OSD, OFF for white color. Default: OFF
  • OSD Transparency - transparency of grey background, 0 = fully transparent equals OSD no background=ON, max (4 or 16) = no transparency. Default: 2 of 4 respectively 6 of 16
  • Map zoom (100% - 270%) - Simple bitmap zooming. Pre-zoom option range is 100-270%, 100% = no zoom. Dependent on Settings->Misc->filtered scaling (some platforms may be too slow with filtering), (since 1.1.0). Default: 100
  • Show zoom controls - show/hide zoom control icons in map mode on touch devices (since 1.1.1?) Default: hide after 3s
  • Show menu bar - show/hide menu icons at bottom in map mode on touch devices (since 1.1.1?) Default: hide after 3s
  • easyzoom - enable fast switching between layers of an atlas? (new in 1.1.1?) Default: off
  • Font size - size of font in OSD. Default: 0
  • Lists font - Font used for lists (e.g. waypoints). Usable fonts depend on device and OS, perhaps you have to try some values. Format is FFSSZZ (hex values). Default: 200008 (which means: monospace,plain,small)
    • FF: 00 = system, 20 = monospace, 40 = proportional
    • SS: 00 = plain, 01 = bold, 02 = italic, 04 = underlined
    • ZZ: 00 = medium, 08 = small, 10 = big
  • List mode - TODO describe! (new in 1.1.1?) Default: platform default
  • CMS rotate (sec) - if multiple CMS are present, profiles are switched automatically. If this value is 0 the profiles don't switch automatically. Default: 0
  • Trail line - Style of the trail shown in map. Left menu key opens options dialog to set color, thickness and cycles through available styles. Default is cyan thin line.


  • Provider - GPS provider type selection (Bluetooth, Internal, Stream, Simulator, O2 Germany). Default: best guess for given device
Note: O2 Germany has to be manually enabled before installing the midlet by adding the following line to trekbuddy.jad file:
App-Flags: provider_o2_germany
  • For internal provider:
    • Location Timings - internal provider parameters. Default: 2,2,-1 for Motorola A780, 9999,1,2000 for Motorola E1000, 5,-1,-1 seems to be a good choice for 5800 (as time updates seem to work better, by default time updates are incorrect in CMS screen for example), and 1,-1,-1 for other devices. This number means: interval, timeout, maxAge.
      More info about in function in: setLocationListener(LocationListener, interval, timeout, maxAge).
      Android: single number, default value is 0 (as frequently as possible). If you set value to 60 (ie. 1 min) or higher, system may conserve battery.
    • assisted GPS - enables assisted GPS. When enabled, you can still control it in suite settings. The option only exists because on some devices support has to be disabled at code level, otherwise internal GPS did not work. Default: OFF.
    • time fix - on some devices (eg. LG Arena) position timestamp is incorrect (typically shown as 1970-01-01 00:00). This option allows TrekBuddy to use phone's clock instead. Default: OFF.
    • power usage - together with assisted GPS affect how fast is the fix acquired, and what the position source is. Default: MEDIUM. For Blackberry, HIGH can be better choice. See [1] how critetia combination may work.
    • Alt correction (m) - allows to adjust the altitude. Useful especially when altitude is provided by GPS including "height of geoid above WGS84 ellipsoid"; (NMEA/GGA sentence). See also WGS-84 Geoid Height.
  • For Bluetooth provider:
    • exact time match TODO. Default: ON.
    • reliable input (since v0.9.94) - could make bluetooth (or serial) GPS connection more stable; to verify that it works, enable it, start tracking and after a while check the value of maxavail attribute in Info->Technical->ProviderStatus. If it is non-zero then it is good and you can (should?) keep the option set. Most users won't see any difference, though. Default: OFF.
    • do service search After bluetooth GPS is discovered, service is searched as well; usually not needed. Default: OFF.
    • address fix On some devices (eg. Samsung S5230), reported GPS device address is incorrect and TrekBuddy is not able to connect it. This turns on address fix. Default: OFF.
    • Keep-alive (ms) TODO
  • Tracklog - when TB starts a device, shall trackloging never/always start or the user be asked? Default: never

Only displayed if tracklog is other than never

  • Tracklog Format - tracklog format selection (GPX / NMEA). NMEA does not work for some internal devices. See Using for more format information. Default: GPX 1.1
  • If GPX is set: GPX Options
    • log only valid - ToDo. Default: OFF
    • log gsm info - adds current cellid and lac to recorded pt. Default: OFF (hexadecimal to v0.9.83, since .89 decimal)
    • log time ms (since v0.9.94) - TODO. Default: ON
    • GPX dt (s) - record a location at least every N sec. Default: 60
    • GPX ds (m) - record a location at least every N meters. Default: 0 (since v0.9.94) or -1 (older versions) meaning "switch off"

Only for some providers

  • Simulator delay - controls the speed of NMEA track replay


  • Wpt Proximity - used in route navigation. When distance between current position and active wpt drops below this value (in metres), the notification sound ./sounds/wpt.amr (or ./sounds/wpt.wav or ./sounds/wpt.mp3 - depends on phone model) is played and next wpt in route is selected as active. Default: 50
  • Route Line
    • dotted - route line is drawn dotted, not solid. Default: OFF
    • (old version only) red - red line instead of black. Default: OFF
    • POI icons - drawn POI icons. Default: ON
    • Route line (since v0.9.94) - Style of the route shown in map. Left menu key opens options dialog to set color, thickness and cycles through available styles. Default is black thin line.
  • Waypoints
    • File revisions - perform file backup before altering modifying a waypoint file (edit / delete wpt)? Default: ON
    • prefer GC name - use wpt name from the Groundspeak extra info if available. Default: ON
  • Sort by - TODO. Default: Position.
  • Location SMS (or Sharing)
    • receive - enables location SMS reception (restart required). Default: OFF
    • autohide notification - notification dialog on received message hides automatically when this option is enabled. Default: ON


  • Tweaks
    • broken I/O - some (most?) Siemens and Samsung phones require this in order to handle tar-ed maps. Default: OFF
    • lowmem I/O - on some Samsung phones (eg. S5230), tar-ed map consume too much memory and users may experience OutOfMemoryError while scrolling such maps. The option reduces memory consumption, but scrolling can be much slower then. Default: OFF.
    • safe renderer - turns on safe map rendering method; very probably will be removed in the future and the midlet will work as if it is on. You may try to uncheck it and see whether map rendering is faster or not. Default: ON REMOVED in 1.1.3
    • forced GC - enables forced garbage collections in several situation; may help to workaround memory leaks in some (old) devices, where it may help, for example, to avoid out-of-memory errors during map browsing. Be careful with this on BlackBerry devices, for if GC runs, nothing else runs for 0,5s to 30s depending on the kind of GC that is done and an hourglass is shown (see [2]) for details. Default: OFF
    • power save - in 0.9.81+ it disables vibration when 1) wpt is reached or 2) keyboard is locked/unlocked. Positive effect on battery life... is uncertain so far. Default: OFF
    • 1-tile scrolling - turns on alternative scrolling method that may help to avoid out-of-memory errors on some devices. When switched on, scrolling does not follow smoothly your cursor movement, but the screen stays until you would leave it and then the next tile (more a less a screen) is displayed. Default: OFF
    • large atlases - disables maps meta info caching. Use it when you use atlases with many maps and are low on memory. Default: OFF
    • use native service (since 0.9.96, Symbian only) - enables TrekBuddy to use TrekBuddyService for faster tar maps/atlases access. Default: ON (on UIQ3 and S60 3rd until FP2+) Note: TB always tries to use the service for backlight control.
    • lazy GPX parsing (since 0.9.96) - enables lazy parsing of Groundspeak data in GPX, which saves memory for large GPX files. Only cache id and name is parsed when this option is on. The remaining info is parsed when waypoint details are about to be shown. Such partially parsed file cannot be modified - waypoints cannot be edited nor you can add a new wpt to the file. Default: OFF
    • hide menubar cmd (since v0.9.95) - on Sony Ericsson JP8: Hiding of menu bar that does not dissapear sometimes is less annoying (without autohiding dialog); enables fake command labeled as ... that maps to right soft key; option effective after restart.
    • numeric input hack (since v1.0.4) useful for some Samsung models to allow changing numeric values like GPX(dt) etc. Try when you have issues with delete/backspace current value in numeric boxes/settings. Default: OFF
    • external cfg backup (since v1.1.1?) if checked, configuration in backed up in resources/settings.dat file when button save in settings is pressed. Default: OFF
    • filtered scaling (since v1.1.0) Activate/deactivate simple bitmap zooming: 2x magnifier with long-press FIRE/KEY5/center of the screen to turn on/off. Deactivate if your platforms is too slow with filtering. Default: ON
    • verbose loading (since 1.1.2): notification is displayed for every map tile loaded. Used to be default behaviour, but it is a bit annoying, and comes with small performance hit on slow devices.
    • S40 ticker hack (since 1.1.4): workaround for Nokia S40 6th bug (or TB?) when tickers (= typically rolling text at the top of the screen) are intensively used, ie. when listing and loading waypoints files under Navigation, TB crashes and/or phones restarts. When checked, different activity notification is used (a kind of progress dialog) instead of ticker. The look of it differs greatly among platforms - on some it quite nice (eg. S^3, S40), on others a bit annoying (eg. Samsung). hte option is available for all platforms except Android. Default: ON on S40 6th (but detection may not work properly)
  • HECL optimization level
    • 0 - no optimization
    • 1 - text-level preprocessing (whitespaces removed etc), should be safe and may improve speed of initialization
    • 2 - same as for 1, but HECL code is also "precompiled", ie. procedures (functions) are "compiled" into HECL code primitives. This normally happens before every invocation of every procedure, so the obvious advantage is better and more stable performance - not only because there is no parsing overhead, but also because there is less memory garbage to be collected. Disadvantage is higher memory usage - depends on script size, roughly tens of kB. This is a bit dangerous option, so the default value is 1.
  • Multimedia
    • Capture Locator - locator for taking pictures linked to a recorded waypoint. Enter either capture://image or capture://video depending on your device. See Using, too. Default: capture://video
    • Capture Format - specify non-default picture properties like image format, size, etc. encoding=image/jpg should work for most users, another option is encoding=image/gif. To specify the resolution of the snapshot add width and height variables in the Capture Format field, e.g. encoding=image/jpg&width=1280&height=1024. See Using, too. Default: encoding=jpeg



After installing and starting TrekBuddy application need to change data directory in the Settings from file:///E:/Trekbuddy/ to one of the following values:

  • file:///b/trekbuddy - in case if memory card used
  • file:///a/trekbuddy - otherwise


  • have Settings -> Tweaks -> safe renderer on
  • have Settings -> Desktop -> safe colors on
  • The DataDir location should look like this: file:///SDCard/TrekBuddy/
  • It's highly recommended to install a Keymap, so you don't have to press the ALT key with your command keys, see for details

BT GPS Receivers on BlackBerry may work if serial port profile is supported, so if you know your BT GPS network address, you can use Serial provider, and specify btspp URL as Connection URL, eg. btspp://000276FD79DA:1 where 000276FD79DA is BT GPS bluetooth address.


  • have Tweaks->Siemens I/O off
  • On SXG75 NMEA track format is not working

Sony Ericsson

Saving way points and track logs

TrekBuddy will error when you try to save way points and routes unless you create the directories it needs. It needs two directories inside the main directory for saving map data.

This is a sample directory structure for it:

  • file:///E:/Other/TrekBuddy/wpts/
  • file:///E:/Other/TrekBuddy/tracks-gpx

Drive E is the phone's memory stick while drive C is the phone's internal memory. In Settings, set the Data Dir to be file:///E:/Other/TrekBUddy/ and all should be fine. However in P1i model phone's memory stick must be referenced by "Ms", not by "E:". The sample path pointing the folder on Memory Stick will look like this: file://Ms/Other/mapdata/

note: on the P990i (and most likely other Sony Ericsson P models) the system may nationalize the folder names in the file browser, but the names on the memory stick are always the same (eg. if you have a polish translation and see the folder "Inne" while browsing the memory stick you should still use "OTHER" when setting TrekBuddy Data Dir). Also, you may encounter a security exception if the mapdata folder isn't a subfolder of one of the "original" folders (eg. file:///Ms/myfolder/mapdata/ will not work even if the folder myfolder exists) Another issue is that if you just install the JAR file, Symbian OS may block all writing attemps (like recording a track) with a security exception. So always install JAD and JAR file for proper certificates and capabilities.

Map tile size

On SE K750i/W800i tiles larger than approx. 300*380 pixels cause unexpected and random program freezing

Windows Mobile

IBM J9 (WEME) using serial port

Pair bluetooth GPS with the device, and create outgoing port for the GPS (eg. COM5). Then configure TrekBuddy to use Serial provider:

  • Select Setting->Location
  • Location Provider: Serial
  • Connection URL: comm:COM5 or comm:COM5;baudrate=19200 (or whatever baudrate you wish and the device supports)

IBM J9 (WEME) using bluetooth

  • Update J9 with bluecove
  • Run TB
  • Select Settings->Location
  • Location Provider: Bluetooth
  • Apply/Save
  • After Start select your BT-GPS device

Esmertec Jbed or IBM J9 using using serial port

  • Select Setting->Location
  • Location Provider: Serial
  • Location Timings: 1,-1,-1

Esmertec Jbed or IBM J9 using device-local socket connection

Find COM port for your GPS (bluetooth, integrated, ...). Run a program that "redirects" COM port data to TCP/IP socket (eg. GpsGate or GpsPort). Then configure TrekBuddy to use Stream provider:

  • Select Setting->Location
  • Location Provider: Stream
  • Connection URL: socket:// (or whatever TCP port you set up in the COM->TCP/IP redirecting application)

Samsung OMNIA

  • Data Dir: Change data directory in the Settings from file:///E:/Trekbuddy/ to file:///root1/trekbuddy - which points to /My Documents/trekbuddy/; or try to use real directory like file:///Moja%20pamiec/My%20Documents/trekbuddy - which is real way to Dir
  • Internal GPS: There is no Provider "Serial", try to use "Stream" together with GPSPortPPC.exe. Connection URL: "socket://", where "xxxxx" is Output in GPSPort.

Samsung OMNIA II

  • Data Dir: Change data directory in the Basic Settings to file:///Storage Card/trekbuddy/.
  • Create folder maps inside.

Warning: names is case sensitive!

Samsung Pixon

  • Data Dir: Change data directory in the Settings from file:///E:/Trekbuddy/ to file:///mmc/trekbuddy - which points to the SD-Card


Basic configuration: Settings->Basic

  • Data Dir: file:////TrekBuddy/ (assumes TrekBuddy would be your folder on sd-card)

Location configuration: Settings->Location

  • Provider configuration: Setting->Location
  • Location Provider: Serial
  • Connection URL: comm:rfcm;baudrate=4800

Sony Ericsson HGE-100

Provider configuration: Setting->Location

Since 0.9.74 there is a special location provider called... HGE-100 :-)

Or setup Stream provider manually:

  • Location Provider: Serial
  • Connection URL: comm:AT5;baudrate=9600

On latest SE phones, HGE-100 should be available with Internal provider as well (according to some SE document).


Nokia 5800 xpressmusic

To disable the virtual joypad that is shown, edit the suite settings in the application manager:

  • setup
  • application manager - installed apps - trekbuddy
  • options - suite settings
  • on screen keyboard: off

Nokia N73

To enable taking image snapshots of waypoints:

  • Go to Settings->Misc
  • Set Capture Locator to capture://video
  • Set Capture Format to encoding=image/jpeg

Nokia 6303 classic

With this phone it is convenient to use internal location provider although receiver is external. This way bluetooth is turned on/off automatically.

To avoid excessive security confirmation prompt, find trekbuddy in through applications browser. In options you can setup location, multimedia and userdata to be accessed without confirmation.

To enable taking image snapshots of waypoints (1.0.14 freezes on taking snapshot, see forum):

  • Go to Settings->Misc
  • Set Capture Locator to capture://image
  • Set Capture Format to encoding=image/jpg
Personal tools