From TrekBuddy Wiki

Jump to: navigation, search


General Workflow

For beginners, this is one possible sequence to get started with TrekBuddy:

  1. Install TrekBuddy
  2. Optional but recommended: Copy Maps to your device
  3. Start TrekBuddy
  4. Maybe: Do initial Configuration by pressing MENU and 4 for settings
  5. Maybe: Load map/atlas (if already stored on device)
  6. Press MENU and 1 to start listening to GPS receiver
  7. Choose YES to log a track
  8. Move outdoors where GPS reception is possible and take your device with you
  9. Watch for the little dot in top right corner and wait until it turns from yellow (no signals) to green (receiving signals)
  10. See your position in OSD (top) and move the curser
  11. Press # to change to HPS mode. Check the accuracy of GPS signals.
  12. Press 1 for waypoints menu, select "record current", enter some name and save
  13. Move a little away, press 1 for waypoints menu, select "waypoints", choose the file just created and in it the waypoint you created, Options, 1 to NavigateTo from your current to former position
  14. Play around and have fun :-)
  15. Go and fetch / create the Maps you need and pack them in an Howtos#Atlas for more convenient handling.

Keyboard and touchscreen handling


Using the mobile phone's keypad

displays the menu
pause/continue track
delete last entered character
Short: Waypoint menu
Long: List wpts of current wpt file
Map: move cursor north/up
HPS: toggle raw / position-averaging mode
Map+HPS+CMS: toggle backlight
Map: move cursor west/left
HPS: change scale (zoom out)
CMS: previous configuration
Map: Center cursor to position received last from GPS device
HPS:locks north
CMS: -
Map: move cursor east/right
HPS: change scale (zoom in)
CMS: next configuration
Map: Change map layer within atlas
HPS: -
CMS: Activate previous waypoint
Map: move cursor south/down
HPS: toggle raw / position-averaging mode
CMS: list configurations
Map: Change map within atlas
HPS: -
CMS: Activate next waypoint
Map+HPS+CMS: Long: lock keypad
Map: Short: toggle function of 0
(transparency vs wpt name(s)/cmt(s))
Map: toggle crosshair transparency
or toggle wpt name/cmt/none
HPS+CMS: toggle day and night
Map+HPS+CMS: toggle map/HPS/CMS

Note: The "Joystick" with LEFT/UP/RIGHT/DOWN/FIRE on some mobile phones provides the same functions as the 2,4,6,8 and 5 keys.

Note for 3 "toggle backlight": Since v0.9.97 Nokia specific feature: long keypress to set desired backlight level, short press for quick on/off from/to selected light level.

Note: Blackberry and other devices with "full" keyboard may have different mapping, please see Also see Customization, you can and have to remap your keyboard on some devices which is explained there.

Note: Some information might be found at


till 1.0.16

Touch Screen see also form thread

Map+HPS+CMS: short tap lists waypoints of current waypoints/GPX file, long tap opens waypoint/navigation menu Map: scroll north/up
HPS: toggle raw / position-averaging mode
Map+HPS+CMS: toggle backlight

Map: scroll west/left
HPS: change scale (zoom out)
Map: short tap to center cursor to position received last from GPS device, long tap for bitmap 2x zoom
HPS:locks north
CMS: -
Map: move east/right
HPS: change scale (zoom in)
Map: Change layer
  • If easyzoom is activated, short tap to switch to previous layer, long tap for list of layers
  • If easyzoom is not activated, TODO

HPS: -
CMS: Activate previous waypoint??
Map: move south/down
HPS: toggle raw / position-averaging mode
CMS: list configurations??
Map: Change map
  • If easyzoom is activated, short tap to switch to next layer, long tap for list of maps in this layer
  • If easyzoom is not activated, TODO

HPS: -
CMS: Activate next waypoint??
Map+HPS+CMS: short tap for main menu, long tap to lock touchscreen Map: toggle crosshair transparency
or toggle wpt name/cmt/none
HPS+CMS: toggle day and night
Map+HPS+CMS: toggle map/HPS/CMS


  • Scrolling: Tap top/right/left and hold pressed to scroll or tap somewhere on the map and drag map around to scroll.
  • For changing waypoints in CMS, please note that if you're using RouteBack instead of RouteAlong, 7 activates next waypoint and 9 activates previous waypoint.

since 1.0.17

Waypoints menu and backlight control remains in top corners for compatibility, but is also available in menu bar at the bottom (icon with 2 feet for wypoint, icon with bulb for backlight). Scrolling etc unchanged.



In all screens, you can

  • switch between night and day style (i.e. change background and foreground colors) with 0 key
  • Access waypoints by 1
  • several other actions, see key bindings above

Map screen

In map screen, you can see your position (or any arbitrary position) displayed on a map. More options, like displaying points of interest (POIs), your track, etc are possible. The display may be configured, like desired information, font size etc.

Screenshot with map consisting of polygones
The background consists of a map that may be a map consisting of polygones (bitmap derived from vectors like in OpenStreetMap), a topographic map, a satellite photo, a hiking map or the like. Maps have to be installed and selected before (see Maps and Howtos#Maps).

The foreground displays further information. Have a look at the screenshot with explanations or read the following and get the info on screenshot on right side.

  • An on screen display (OSD) with textual information on top of the screen.
  • A scale on the bottom of the screen.
  • A crosshair with a compass rose around it visualizes the coordinates/position displayed in the OSD (usually in degrees, minutes and seconds).
  • A red small arrow in the crosshair shows the direction of movement.
  • A small dot in OSD indicates GPS reception (green=getting position information).
  • Depending on your configuration, the OSD has a second line of text containing local time, speed, altitude and number of satellites receiving data from - all only if GPS is connected and receiving positional data.
  • If you told TrekBuddy to navigate to a waypoint, different information is displayed: A green small arrow in the crosshair shows the direction towards the selected target, the OSD the distance etc.

On moving around, the map will follow your position (read: scroll) until you reach the border of the map. The crosshair will become "stuck" and the text lines on top of the screen will become red if your position is "off the map" and can't be displayed properly.


Compass screen (aka HPS)

This screen displays the last positions relative to the current one. This is useful to see one's movement (large scale) respective to check accuracity (detailed scale), e.g. for geocaching.

With LEFT-RIGHT key/joy user can change scale (displayed in lower left, e.g. 250m). Using UP-DOWN key/joy user can switch between raw (red needle tip) and position-averaging (blue needle tip) mode.

TODO: explain "5/fire locks north"

One possible CMS screen as example

Computer Screen (aka CMS)

This screen shows current data from GPS reciever. It can be configured by the user using XML file(s). No default configuration file is shipped. Store the XML files in the directory %data_dir%/ui-profiles, for example cms.simple.xml. You can put more than one XML file, change between them via LEFT/RIGHT and DOWN keys. Since version 0.9.66 TB memorizes the last CMS used.

Details concerning the XML configuration files may be found in the wiki page CMS and the forum Both sources contain a list of available parameters. TODO: Bring all information of the forum threads to wiki and close forum threads

Waypoints and navigation

In the waypoint menu (accessible via the "1" key) you have several options:

"Waypoints" and "Tracks"

Shows a list of waypoint files stored in datadir\WPTS folder respectively track files stored in datadir\tracks-gpx that have been created by marking points in TrekBuddy respectively activating a tracklog or by uploading GPX files from your PC to your mobile device. You can create GPX waypoint files with several tools or download them, e.g. a hiking tour track from a web community like. Additional information on the file format be found in howto on GPX - quite useful for manual processing of GPX files.

You can

  • Open a waypoint and view it's information like name, comment, location and altitude. In the details screen, you can call options and edit & delete this waypoint. TrekBuddy creates a file backup by default, see Configuration to change behavior.
  • NavigateTo a waypoint; the distance and direction (as degrees and arrow) to the waypoint are displayed on the map screen
  • RouteAlong a list of waypoints that may be <trkpt>s contained in a track (!) <trk> in a GPX file. Displays like navigate to, but automatically sets the next waypoint as target when current is reached.
  • RouteBack follow the same route as with RouteAlong, but in reverse direction. To use this function, highlight the last waypoint and then click RouteBack.
  • ShowAll waypoints; shows all waypoints in the GPX-file on the map, for as far as they are on the visible part of the map. Pressing shortly * followed by 0 toggles the function of 0 key to cycle through display of waypoints name, comment and neither. Has an effect only in map mode.
  • GoTo a waypoint; the cursor just moves to this waypoint on the map-screen. Has an effect only in map mode.
  • SortByPosition, SortByName and SortByDistance sort all waypoints in the waypoint file according to their appearance in the file, by their names or by distance from current position. Available since v0.9.82.

Record Current

Sets a new waypoint using the current coordinates. You can enter a Name and a comment. Time, date and altitude are stored automatically.

Take a snapshot

If you are using a mobilephone with an integrated camera, Trekbuddy lets you add a snapshot. Once activated, you will see the camera preview screen to take a picture when recording a waypoint. The photos or snapshots are stored in images-<time that matches waypoints gpx timestamp> subfolder and is linked from given waypoint, for further "postprocessing". See Configuration, too.

Does not work on:

  • Samsung S5230 during tracklog
  • most Nokia S40 based phones

Does work on:

  • Nokia 6233
  • Nokia 6600 Slide
  • Nokia N73 (with capture://video and encoding=image/jpeg, see N73 configuration note)
  • Nokia 2710 (with caputre://image and encoding=image/jpeg&width=1600&height=1200)

Add custom

Lets you enter coordinates manually before saving a waypoint. The coordinates of your cursor in the map view are entered by default - quite useful if you want to create a waypoint and are able to locate it with the crosshair on the map.

SMS I'm here

Sends an SMS with your current coordinates. You may specify the recipient and an additional message. A connection to a GPS is needed.

SMS Meet you there

Sends an SMS with coordinates of your map cursor. You may specify the recipient and an additional message here as well. No GPS connection needed.


Only shown when routing is active; will stop navigation.


Trekbuddy comes with the functionality to log the GPS coordinates of your trip in files, often called track points, tracklogs or routelogs. This functionality enables you to use the data for whatever you like. (These calculations can not been made with the current version of TB.) You can


NMEA is a raw GPS format. This format is understood by many applications and can be converted by several tools other formats. In most cases this is the format your GPS reciever sends to Trekbuddy. Internal GPS devices do not send NMEA data to TrekBuddy directly. A software interface (the Location-API) shields the GPS module and provides ready prepared location and speed instead. So natively on devices with internal GPS TrekBuddy does not have NMEA info to be logged. Some implementations of the location API however give some NMEA sentences to application software if it asks for "extra information". In this case at least a bit of NMEA can be logged. If it is enough for your purpose is not sure. Just try and see.

GPX is an XML format that can store trackpoints, too. Ideally it should work like NMEA. For more information, see Howtos#GPX_File_format. This is the default logging format.

Which one to choose

Logging data in NMEA writes raw data, so it is smaller than XML conform GPX format. Because it is XML conform, GPX can be viewed and edited with a wide range of programs and is well human-readable, whereas NMEA is special and even not recognized by several GPS applications (e.g. GPS TrackMaker, Google Earth). NMEA is enabled by default. You can convert between both formats, e.g. at - have a look at Tools.

Start a tracklog

First you need to set up your GPS reciever to work with Trekbuddy. After that go on and launch Trekbuddy. Open the menu and select "Start XYZ" (where XYZ is the name of your GPS receiver and might be blank). Depending on the Setting under "Settings" -> "Location" -> "Tracklog", Trekbuddy will ask you if a tracklog should be written or not. The tracklog will be saved in <trekbuddy-dir>/tracks-nmea for NMEA and <trekbuddy-dir>/tracks-gpx for GPX.

Stop the tracklog

Open the menu and select "Stop".

Things to watch out

If you lose connection to the satellites (i.e. you're inside a building) the tracklog gets messed up sometimes. The GPS receiver sends incorrect positions to Trekbuddy add invalid trackpoints. You should stop or pause your tracklog (via MENU) when you know that you will lose the connection.

Personal tools