Documentation

TripLibre docs

How to install and use TripLibre for iOS, how it turns GPS into a travel diary, what its data looks like, and how to build on it. For why TripLibre exists and where it is going, see the Vision and Roadmap.

Install on your iPhone → How it's built View on GitHub

What TripLibre is

TripLibre is a free, open-source iOS app that records where you go, rebuilds each day into visits, trips and travel modes, and keeps all of it on your phone. Think of it as a household travel survey that fills itself in, with a sample size of one. It has no account and no server, and exports to CSV, JSON, GeoJSON and SQLite.

TripLibre was called HHT until October 2026. It is the first product of HHT Diary, the organization behind this site. The code keeps HHT in its names (HHTCore, HHT.xcodeproj, analysis/hht.py) and its bundle ID, so installing over an older HHT build keeps your data.

i

TripLibre is not on the App Store yet. You build it from source with Xcode and install it on your own phone. With a free Apple ID the install lasts 7 days and you renew it with one command, and your data is kept between installs. See Installation.

Get started

Your route through the docs, step by step, drawn like a day in the app's diary.

  1. 1 Installation start hereBuild, sign and install on your iPhone. →
  2. 🚶Walk · 4 min read
  3. 2 Using the appThe screens, daily routine, corrections and export. →
  4. 🚲Bike · 5 min read
  5. 3 UI guideEvery screen, annotated, plus the sticker design system. →
  6. 🚇Subway · 6 min read
  7. 4 ArchitectureModules, data flow, and the three data layers. →
  8. 🚗Car · 4 min read
  9. 5 Developer API destinationHHTCore (Swift) and the Python analysis helpers. →

For developers

pipeline

How inference works

Every rule that turns raw fixes into stays, trips and modes.
data

Data model & export

The three data layers and what each export file contains.
schema

Data dictionary

Every exported table and field, with units and codes.
build & test

Contributing

Build, test, lint, and propose an inference test case.

Research, privacy and validation

Planning a study or evaluating the data? Start with Research uses & limitations, then Validation and the Data dictionary. What leaves the phone, and when, is on the Privacy page.