mahlernim/google-timeline-visualizer
An app that turns your Google Timeline location history into a travel map video
Timeline Visualizer is an open-source app that reads your Google Maps Timeline export file and turns a year of travel into an animated map video. It comes as both an Android app and an iPhone web app, and processes your location data entirely on-device without uploading it. Written in Kotlin, the project has 863 stars on GitHub.
What it does
- You load a Timeline.json file exported from Google Maps settings, pick a date range (by month or exact dates), and get an animated route video lasting 10 to 300 seconds
- The Android app is installed via a downloadable APK, while iPhone users open a web app in Safari with no install needed; MP4 creation requires Safari 16.4 or newer
- Users can customize camera movement (fixed or dynamic), video format (480p to 1080p, square, portrait, or landscape), and GPS outlier filtering for stray coordinates
- Finished videos are saved to Movies/Timeline Visualizer on Android and can be watched, shared, or deleted from an in-app video library
- No Google sign-in or location permission is required, the Timeline file itself is never uploaded, and only map tile requests for viewed areas are sent to CARTO's map service
Why it matters
It gives anyone who wants to visualize a year of travel, or create a shareable trip video, a free tool that keeps personal location data private and local. The project is open source and also ships a desktop Python version, letting developers build or customize it themselves.
Terms in this repo
- Timeline.json · the exported file containing a user's Google Maps location history
- E7 coordinates · latitude/longitude values multiplied by 10^7 and stored as integers
- great-circle path · the shortest route between two points on a sphere, used to smooth long flight segments
- CARTO · a map tile service that serves imagery based on OpenStreetMap data
- APK · an Android app installation file that can be installed directly without the Play Store
Repository description (English)
Visualize your year in travel using your Google Location History (Timeline) data
Open on GitHubTrending repos
- cathrynlavery/diagram-designA skill that makes AI coding tools draw magazine-quality diagrams instead of generic rounded boxes
- public-apis/public-apisA giant crowd-curated directory of free APIs for developers
- semantica-agi/semanticaAn open-source graph infrastructure that lets AI agents show their work, not just their answers
- cactus-compute/needleA 14MB AI model small enough to run tool-calling on a phone or watch, without internet
- unslothai/unslothA desktop app that lets you run and train AI models on your own computer, no coding required
- macro-inc/macroAn all-in-one workspace where email, chat, docs, tasks, and CRM are cross-linked and share one AI memory
- harry0703/MoneyPrinterTurboAn open-source tool that turns a single topic or keyword into a finished short video, complete with script, footage, subtitles, and music
- basecamp/omarchyA ready-made, opinionated Linux setup built by DHH
Latest from METAL LAB
- Grok leaks conversations, location data via commands hidden in ciphertext
- Cursor lets agents handle long-running tasks with new "/goal" command
- NVIDIA releases Switchyard, an LLM routing proxy for coding agents
- Caveman Cuts Claude Code Token Usage by 33% Using Caveman-Speak
- Apple Keeps 2027 Target for Camera AirPods, Qwen3.8-27B Makes 80 Tool Calls Locally