Documentation

TripLibreLab docs

How to bring a travel diary from TripLibre into TripLibreLab, replay a day of it, and share it without giving away more than you mean to. For where the project is heading, see the Roadmap.

Getting started → Data & privacy View on GitHub

What TripLibreLab is

TripLibreLab is a companion app to TripLibre, in development for iOS. TripLibre records where you go and keeps it as a travel diary: the visits, trips and travel modes of each day. TripLibreLab takes a diary you export from TripLibre and turns it into something you can watch again, explore and share.

It is a separate app, not a new version of TripLibre. It records no location, needs no account, and works with a copy of your data that you choose to give it.

TripLibreLab is not released yet. These docs describe the first release as it is being built. Anything not yet built and tested is marked Pending, and there are no screenshots until the real interface exists.

The first release at a glance

ImportOpen a TripLibre SQLite export from the Files app. Read-only; the original is never changed.

Pick a daySee which days have travel records, and how many trips each one has.

ReplayWatch the day's trips and stops in order on a map, with play, pause and a scrubber.

SharePreview a summary image, hide sensitive places and times, then share it yourself.

Read in order

The docs as a day in a diary: four stops, joined by short trips.

1 Getting started start hereWhat you need, and the whole path at a glance. →
🚶Walk · 3 min read
2 Importing a TripLibre exportWhich file to use and what happens when it can't be read. →
🚲Bike · 4 min read
3 Replay & shareRecorded points versus animation, and how sharing works. →
🚇Subway · 3 min read
4 Data & privacy destinationWhat is read, what is kept, and what a shared image reveals. →

Words used in these docs

Term	Meaning
Travel diary	A day-by-day record of where you stayed and how you travelled between places. TripLibre builds one automatically from your phone's location.
Trip and stay	A trip is a movement from one place to another; a stay (or stop, or visit) is time spent in one place.
SQLite	A common file format for a small database: a single file with tables in it. TripLibre's export includes one.
Replay	Playing a recorded day back as an animation on a map.
Synthetic	Generated by a model rather than recorded. Used only in planned future features, and always labelled.
Agent-based simulation	A model in which simulated travellers follow simple rules and a day of travel emerges from them. Planned for Phase 2.

Need help?

Start with the FAQ & troubleshooting. Questions about recording and exporting belong to TripLibre, whose documentation covers them. Anything else, open an issue on GitHub.