How to use HackTrack
The same guide as in the app (home screen > How to use HackTrack).
- Before a field day
- Getting started
- Ground crew
- Helicopter
- Navigate: the map
- Track me
- Map layers and imported maps
- Offline aerial and satellite maps
- Offline topo maps
- Points list and sharing
- Totals
- Send & export
- Settings explained
- Android phones: keeping the GPS on
- GPS and battery tips
- Problems and fixes
- Privacy
Before a field day
- The evening before, with signal: update HackTrack, charge the phone, and check your name and team in Settings.
- Save the maps for the work area (see "Offline aerial and satellite maps" and "Offline topo maps"). Check them in aeroplane mode.
- Choose the GPS interval in Settings. Every 30 s suits most days on foot; 5 s suits the helicopter.
- Android: turn power saving off, set HackTrack battery use to "Unrestricted", and on Samsung add it to "Never sleeping apps". See "Android phones: keeping the GPS on".
- At the drop-off: open Ground crew, wait for a GPS fix (the top strip turns green), then START WORK. Lock the phone and put it in an outer pocket.
- At the end of the day: STOP WORK, then Send my data to the coordinator.
Getting started
- Settings: type your name and choose your team (and work area if your organisation uses them). Your name goes on everything you record.
- Allow location "While Using the App" with Precise Location on. On Android, also allow notifications: the "HackTrack is recording" notification is what keeps the GPS running with the phone locked.
- Before going out, save the maps you need for use without signal: see "Offline aerial and satellite maps" and "Offline topo maps" below. Map areas you have looked at with signal are also kept for a year.
- The coordinator can share a setup file (Settings > Share setup) so every phone has the same teams, work areas, species, density classes and crew list. Open it on each phone, or use Settings > Load setup file.
- The strip at the top of each recording screen shows the GPS: green within 15 m, amber within 40 m, red beyond that or when location is off (tap it to fix). The battery level is shown at the end.
Ground crew
- START WORK records your track at the interval chosen in Settings. Lock the phone and put it away; do not swipe HackTrack closed. STOP WORK at the end of the day; you can enter the number of trees cut.
- The first point can take up to a minute while the GPS gets its first fix, longer under thick canopy.
- Only one recording runs at a time. Starting work stops Track me (it is saved), and a helicopter flight track cannot run at the same time as a work track.
- Map a cleared patch: walk the edge of the cleared area, or stand at each corner and tap "Corner here". Then FINISH PATCH and add density, species, stems and photos. Walked patches give the most reliable cleared area in Totals.
- Mark trees: records where you are, then choose density and species, add a note and photos. Mark a point: hazards, access routes or anything else, with a label, note and photos.
- Marks use the GPS position at the moment you tap. If the button shows "Getting GPS fix…", wait in the open for a few seconds.
- The coordinates line near the top shows your last position to read out to the helicopter.
Helicopter
- DROP-OFF and PICK-UP: tap a team, or "Select people instead" for individuals. Add anyone missing with "Someone not on the list". The crew list comes from the setup file or Settings.
- FINAL COLLECTION at the end of the day checks people back in. Anyone not collected shows as still on the mountain.
- MARK PINES logs the helicopter position at the moment of the tap, then one tap for density.
- Record flight track keeps the route flown, at the helicopter interval in Settings (every 5 s to start with; the helicopter covers a long way in 30 s).
- Every entry can be undone.
Navigate: the map
- Shows your position, tracks, patches and points for the dates chosen with the date button (Today, Yesterday, 7 days, All dates, or Choose dates).
- Pinch to zoom and drag to move. To turn the map, tap the compass (it shows a padlock when locked), then twist with two fingers. Tap the compass again to go back to north up.
- Tap anything on the map for its details, to go to it, to share it (the share button at the top), or to delete it. Work and flight tracks ask twice before deleting.
- Mark here and Mark trees work as on the Ground crew screen. Long-press the map, or use Coordinates, to save a point you want to walk to.
- Go to this point shows a line with the distance and bearing. Bearings are from true north unless you choose magnetic north in Settings (to match a hand compass).
- The ruler measures distance and area. The square button fits everything on screen.
- While Navigate is on screen during a recording, the GPS updates more often to keep your position current. Locking the phone or leaving Navigate returns it to the recording interval.
Track me
- Track me (on Navigate) records a route when you are not working, such as a recce or the walk in. It is kept apart from work tracks and shows in its own colour.
- Tap Track me and choose how often to record a point.
- Tap Start tracking. You can lock the phone; do not swipe HackTrack closed.
- Tap Stop track when done and give the track a name.
- Starting work on the Ground crew screen stops Track me and saves it. Totals > Navigate shows distance, time moving, and climb and descent.
Map layers and imported maps
- The layers button chooses the background (Aerial (NGI) photos, Sentinel-2 satellite, Topo offline or online, Streets) and switches each kind of data, and labels, on or off.
- Import map file adds GPX, KML, KMZ, shapefiles (a .zip, or the .shp with its .dbf and .prj), GeoPDFs and GeoTIFFs. You can also open these files in HackTrack from WhatsApp, email or Files.
- GeoPDFs and GeoTIFFs show over the map; use the slider to make them see-through.
- Each layer can be switched off, shown, or removed. Points can be deleted one by one; importing the same file again offers Replace, which brings them back.
- "Data from other phones" in the layers sheet hides or shows what you imported from other phones.
Offline aerial and satellite maps
- Save the photo background for your work area before going out, while you have signal (Wi-Fi is best). Saved areas stay on the phone until you delete them.
- Open Navigate and tap the layers button (the stacked squares on the right).
- Under Background, choose Aerial (NGI) for sharp aerial photos (South Africa only), or Sentinel-2 for satellite images (worldwide, less detail, but much larger areas at a time). Close the layers sheet.
- Move and zoom the map until the screen shows the area you will work in. Everything on screen is saved.
- Tap the layers button again, scroll down and tap Offline maps.
- Under "Aerial photos for an area", choose Normal detail, or Extra detail for sharper photos at four times the size (Aerial (NGI) only).
- Check the size shown. If it says Too large, zoom in to a smaller area and save it in parts. As a guide, one save covers about 15 × 15 km at normal detail (up to about 120 MB), 8 × 8 km at extra detail, or 150 × 150 km with Sentinel-2.
- Tap Save this area. You can close the sheet, but keep HackTrack open until it says Done. If it reports missing tiles, tap Save this area again to fill the gaps.
- Saved areas show as dotted boxes on the map. To check one, turn on aeroplane mode and look at the area.
- Offline maps lists the saved areas and the space used; Delete all saved maps frees the space.
- The online Topo and Streets backgrounds cannot be saved this way. Use a topo map file instead.
Offline topo maps
- Topo maps (contours, roads, tracks and paths for a whole region) come as a map file ending in .mbtiles, sent by your coordinator, for example on WhatsApp. Once loaded, they work with no signal at any zoom.
- Map files can be large: download them on Wi-Fi and check the phone has space.
- iPhone: in WhatsApp, tap the file to download and open it, tap the share button, and choose HackTrack (under More if it is not shown).
- Android: in WhatsApp, tap the file to download it, tap it again, and choose HackTrack.
- If HackTrack is not offered, save the file to the phone, then in HackTrack go to Navigate > layers > Offline maps > Load a map file, and choose it.
- Then choose Topo (offline) under Background in the layers button. Loaded maps are listed under Offline maps, where they can be deleted.
- Your own picture maps saved as .mbtiles (for example a drone photo exported from QGIS) load the same way and show over the background.
Points list and sharing
- The list button (top right of Navigate) shows every point: saved, marked and imported. Sort by type, date or nearest, and filter by kind.
- Tap Select (or press and hold a point), tick several, then Share or Delete.
- Formats: GPX for GPS apps and Avenza, KML for Google Earth, CSV for Excel, or HackTrack to open on another phone. The last format you used is offered first.
Totals
- Work: cleared area from walked patches (the reliable figure), track coverage estimate, distance on foot, crew hours on the mountain, counts, and totals by team and work area.
- The track coverage estimate is a band along each work track, as wide as "Track coverage width" in Settings. It is a rough guide; intervals over 60 s are too coarse for it.
- Navigate: distance travelled with Track me, time moving, climb and descent, and more.
- Choose any day or range of days. Totals include data imported from other phones; Share summary sends the figures as text.
Send & export
- Send my data: one file to send to the coordinator by WhatsApp, email or AirDrop. Importing the same file twice adds nothing.
- Send my data includes everything changed in the dates chosen, including data you imported from other phones (it keeps their names). To send only your own, hide or remove the other phones first.
- The file also records the phone type and its GPS settings, so gaps in a track can be explained. On Android it adds the power settings and the battery level at the start and end of each recording.
- Import a file: other phones' data, setup files, map packs and map layers.
- Data from other phones (under Import, or in the map layers): hide a phone, or all of them, to keep the map clear, or remove a phone's data once you have exported it. Your own data is never affected, and importing their file again brings it back.
- Export for GIS and Google Earth: choose the dates and what to include. Everything is ticked to start with. Photos go in the zip and show in Google Earth. Tracks are split where the GPS lost its fix, so no false straight lines are drawn across gaps.
- A backup is saved each time recording stops. Old backups can be deleted under Manage backups.
Settings explained
- GPS interval (ground crew and helicopter): how often a point is recorded. Shorter gives more detail and uses more battery. Every 30 s is the starting setting on foot, every 5 s in the helicopter. HackTrack remembers your choice.
- Battery saver (on to start with): for intervals of 30 s or more, the GPS rests between points. Points may arrive a few seconds late, and at long intervals they can be less accurate. If tracks recorded with the phone locked have gaps, turn it off: the GPS then stays on (more battery).
- Track coverage width: the band along each work track used for the coverage estimate in Totals.
- Species list and density classes: the choices offered when marking trees and finishing patches.
- Coordinate format: how positions are shown and read out (decimal degrees; degrees and minutes; or degrees, minutes and seconds).
- Bearings: true north (maps and GPS units) or magnetic north (to match a hand compass).
- Organisation: share or load a setup file. Topo map server: usually set by the setup file.
Android phones: keeping the GPS on
- Android phones save battery by stopping apps and the GPS when the screen is off. Each setting below can leave gaps in a track, so check them before the first field day.
- Power saving off: when it is on, a red bar shows on the Ground crew and Helicopter screens (and on Navigate while recording). Tap the bar to open the setting. You can still start recording, and HackTrack reminds you when you do. On Samsung, swipe down from the top and tap the Power saving tile.
- Allow background use: when recording starts, HackTrack asks to run in the background. Choose Allow.
- Battery use "Unrestricted": long-press the HackTrack icon > App info > Battery. On Samsung, also add it to "Never sleeping apps" (Settings > Battery > Background usage limits).
- Allow notifications: the "HackTrack is recording" notification must stay while recording.
- If tracks still have gaps, turn off Battery saver in HackTrack's Settings, or choose a shorter interval.
GPS and battery tips
- Longer GPS intervals (Settings) save battery. Every 30 s, the starting setting, suits most work days. With Battery saver on, intervals of 2 min or more can give less accurate points.
- Navigate uses the GPS more while it is on screen, to keep your position up to date. Locking the phone or leaving Navigate returns it to the recording interval.
- Keep the phone in an outer pocket or on the pack, not under the body. Steep valleys and thick canopy reduce accuracy.
- Indoors and near buildings the GPS is unreliable: positions can jump hundreds of metres even when the accuracy shown looks good. Test the app outside.
- If the app is closed while recording, it carries on the next time it is opened and notes the gap.
Problems and fixes
- Gaps in a track with the phone locked: on Android, check "Android phones: keeping the GPS on". On iPhone, check that location is allowed with Precise Location on, and that HackTrack was not swiped closed.
- Points jump around: usually a poor signal (indoors, deep valleys, under rock overhangs). Exports leave out track points with an accuracy worse than 50 m.
- "Getting GPS fix…" for a long time: move into the open and wait. A mark saved without a fix says so.
- A map area is blank offline: it was not saved, or only at a lower zoom. Save it again with signal.
- Something else: send your data file to the coordinator; it holds the details needed to work out what happened.
Privacy
- No account, advertising or tracking. Everything stays on this phone until you send or export it.
- Deleting the app deletes its data, so send your data first.