mahlernim/google-timeline-visualizer Installation Guide

⚡

Automated Install (Recommended)

Quick installation instructions for mahlernim/google-timeline-visualizer. This is the fastest way to complete project installation and setup.

Install via curl

curl -fsSL https://hexmos.com/ipm-install | bash && 
ipm i mahlernim/google-timeline-visualizer

Install via PowerShell

iwr https://hexmos.com/ipm-install-ps -UseBasicParsing | iex; 
ipm i mahlernim/google-timeline-visualizer

Install via npx

npx @hexmos/ipm i mahlernim/google-timeline-visualizer

Prerequisites

Android

operating_system

Version: 8.0+

Python

programming_language

Version: 3.9+

FFmpeg

software

Safari

browser

Version: 16.4+

Manual Installation Methods

Install on Android

wget -O TimelineVisualizer.apk https://github.com/mahlernim/google-timeline-visualizer/releases/download/v2.2.5/TimelineVisualizer-v2.2.5.apk

echo 'Install TimelineVisualizer.apk and allow installation of unknown apps if prompted.'

Use on iPhone

echo 'Open https://ahn-lab.org/google-timeline-visualizer/ in Safari.'

Desktop Python version

git clone https://github.com/mahlernim/google-timeline-visualizer

cd google-timeline-visualizer

pip install --upgrade pip

pip install -r requirements.txt

python visualizer.py --input Timeline.json --year 2025 --camera-movement steady --long-trip-compression balanced --output my_trip_2025.mp4

Build and test (Android development)

git clone https://github.com/mahlernim/google-timeline-visualizer

cd google-timeline-visualizer

./gradlew test lint assembleGithubDebug assemblePlayDebug

pip install --upgrade pip

pip install -r requirements-dev.txt

python -m pytest

Post Installation Steps

Ensure you have obtained your Timeline.json file from Google Maps/Settings.
For Android, download the APK from the latest release assets.
For iPhone, use the web app directly.
For Desktop Python, ensure Python 3.9+ and FFmpeg are installed.

← Back to tool All Installation Guides