mahlernim/google-timeline-visualizer

Visualize your year in travel using your Google Location History (Timeline) data

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 47 minutes ago
Added to GitGenius on August 20th, 2026
Created on December 16th, 2025
Open Issues & Pull Requests: 8 (+0)
Number of forks: 144
Total Stargazers: 1,266 (+67)
Total Subscribers: 75 (+12)

Repository Insights (GitGenius)

Median issue/PR response: 1.5 hours
Mean response time: 3.0 hours
90th percentile: 8.1 hours
Tracked items: 50

How this project is maintained

Around half of the issues opened in the past year never receive a reply. Only 17% of issues opened in the past year have been closed. Three people close 96% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 5
New in 7 days: 53
Closed in 7 days: 48
Avg open age: 1 days
Stale 30+ days: 0
Stale 90+ days: 0

Recent activity

Opened in 7 days: 53
Closed in 7 days: 48
Comments in 7 days: 20
Events in 7 days: 56

Top labels

  • enhancement (23)
  • invalid (16)
  • bug (12)
  • wontfix (2)
  • documentation (1)

Detailed Description

Google Timeline Visualizer is an Android app and iPhone web tool that converts Google Location History data into animated travel videos.

The tool solves the problem of visualizing personal travel patterns by transforming Timeline.json exports from Google Maps into MP4 videos showing journeys on an animated map. Users select a date range or specific dates, choose camera movement styles, preview the resulting animation, and generate a shareable video file. On Android, the app handles the entire workflow locally on the device. On iPhone, a web-based version processes the Timeline file in the browser without uploading it to any server.

The Android app suits users who want a native mobile experience and have devices running Android 8.0 or newer. The iPhone web app appeals to Safari users who prefer not to install additional software and value client-side processing. The tool is particularly useful for creating travel retrospectives, sharing journey highlights, or documenting location patterns over specific periods. The project includes a feature to restore missing Google Maps Timeline data from encrypted backups, addressing a common user frustration when timeline history disappears after device changes or app reinstalls.

Development activity shows consistent maintenance with regular updates to the codebase. The project includes localized documentation in multiple languages, indicating attention to international users. The Android app is distributed directly through GitHub releases rather than app stores, with clear installation instructions acknowledging the expected security warnings users will encounter. The tool maintains active support for its core functionality, with documentation covering both standard usage and edge cases like timeline restoration.