한국어 안내 · 日本語

Turn your Timeline file into an animated travel video on your Android phone. Choose exact dates, preview the Journey, and create an MP4 ready to watch or share.

Open the iPhone web app in Safari. There is no app to install and no Timeline file is uploaded.

1. In Google Maps, open profile picture → Settings → Personal content → Export Timeline data and save Timeline.json in Files.
2. Return to the web app and select Choose Timeline.json.
3. Choose a month range or exact dates, select the distance unit and camera movement, and confirm the map privacy notice.
4. Preview the journey, then select Create MP4.
5. Play, share, or download the finished video.

MP4 creation requires Safari 16.4 or newer with H.264 encoding support. Keep the tab open while the video is being created. To keep the web app on the Home Screen, use Safari's Share menu and choose Add to Home Screen.

Install Timeline Visualizer from the Google Play listing.

You can also join Google Play open testing to receive test updates. No application form, invitation, or Google Group membership is needed. Availability depends on your country and device.

You can also install the APK from this repository's latest release.

1. Under Assets, download the latest TimelineVisualizer-*.apk file on your phone. Do not download the .sha256 checksum file.
2. Open the downloaded file.
3. If Android blocks the installation, select Settings, allow your browser or file manager to Install unknown apps, then return and try again.
4. After installation, you can turn that permission off again.

Only download the APK from this repository. Android may display a warning because the app is installed outside Google Play. That warning is expected for a directly distributed APK. Future releases can be installed over this release.

Requires Android 8.0 or newer.

On Android, the export is in the phone's Settings app, not in Google Maps:

1. Open Phone Settings.
2. Select Location → Location services → Timeline.
3. Select Export Timeline data, then Continue.
4. Save Timeline.json somewhere easy to find, such as Downloads.

See Google's Timeline Help if the Timeline menu is missing or the labels differ on your phone.

Names and menu locations can vary by phone. In Timeline Visualizer, Get Timeline file shows these instructions and can open Location settings for you. Android does not provide apps with a standard link directly to the Timeline page.

On iPhone, the exported JSON can be used directly in the iPhone web app. It can also be moved to an Android phone and opened in the Android app.

If older trips disappeared after changing phones, reinstalling Google Maps, or resetting a device, an encrypted Timeline backup may be available in Google Maps. Use the app's Restore Google Maps Timeline link or follow the restoration guide.

Restore the history in Google Maps first, then export a new JSON file. Timeline Visualizer cannot access your Google account or encrypted backup and does not restore it directly.

1. Open Create video and set up your Travel Journal by choosing Timeline.json. The app saves useful journey history locally and adds new detail when you import a newer export later.
2. Choose a saved trip, find a trip in your Journal, create a monthly or yearly recap, or enter exact dates. Ranges may cross year boundaries.
3. Confirm the title, then choose a preset or a custom journey duration from 10 through 300 seconds. The template is saved for next time and supports {year} and {name}. Durations over 60 seconds show a rendering-time and storage reminder.
4. Select Preview to check the animated map. This is an interactive preview. The saved video uses the same design with map tiles prepared before rendering.
5. Select Create video. On Android 10 and later, the app saves it automatically under Movies/Timeline Visualizer. Android 8 and 9 use the system Save As picker. The app shows each stage, an estimated time when enough progress has been measured, and a cancel button. You can switch apps or turn off the screen while it continues.
6. When the video is saved, watch or share it, use Save as to copy it elsewhere, optionally save or share the 1080 × 1080 Journey overview, or create another video.

The selected JSON file is not copied. Useful journey history is stored in the app-private Travel Journal so later exports can add new detailed route sections. Import an updated Timeline regularly if you want to preserve recent detail. The Journal remains only on this device and is excluded from Android backup and device transfer. Clearing app storage or uninstalling the app removes it.

Older travel fades behind the moving marker so long, detailed Timelines remain clear and efficient to render. After the selected journey duration, the video adds a 1.5-second ending that zooms out, reveals the complete route, and holds the final overview for half a second.

If you cancel, the app removes the incomplete output file. After a preview reaches the end, selecting Preview again starts it from the beginning. On Android 13 or newer, allow notifications to follow progress outside the app and receive a ready alert. Video creation continues even if you decline notification access.

Completed videos are added to My videos automatically. Each entry keeps its thumbnail, title, Timeline period, duration, and creation date, with quick actions to watch or share it. Videos open in a full-screen player inside the app, with seeking, sharing, and an external-player fallback. Automatically created MP4 files remain in Movies/Timeline Visualizer. The app stores only a small local index and a deterministic thumbnail made from the final journey overview.

Use Add videos to include MP4s made before this library was introduced. You can select several videos at once. If a file is moved or deleted outside the app, its entry is marked File unavailable so you can remove it from the list.

Remove from list leaves the MP4 untouched. Delete video is a separate, confirmed action that permanently deletes the file when its storage provider allows it. Delete all removes every available video after confirmation. The bottom navigation keeps My videos, Create video, and Settings easy to reach.

Settings controls defaults for every new video. Steady camera and Balanced long-trip compression are the defaults. Fixed camera keeps one zoom level, while Dynamic camera follows local movement more actively. Long-trip compression changes only animation timing and never route geometry. Video format offers square 480p, 720p, and 1080p output plus portrait 1080 × 1920 and landscape 1920 × 1080 presets. Restore defaults returns all video settings to the recommended values.

Timeline processing uses Conservative GPS outlier filtering by default. It ignores only isolated, implausible out-and-back coordinates, reports the number ignored, and keeps the original JSON file unchanged. Set the filter to Off to use every location from the selected file.

The app supports English, Korean, Japanese, Simplified Chinese, Traditional Chinese, Spanish, French, German, and Brazilian Portuguese. Choose any supported language in Settings or keep System default. Settings also shows the installed version and build code.

Long flights and other sparse routes are interpolated along a great-circle path, so the camera follows the trip smoothly instead of jumping to the destination. During local travel, the marker can move within a stable central area before the camera follows it. This reduces rapid back-and-forth map movement on commutes without changing or removing any Timeline points.

• Current Android and iOS direct-array Timeline exports
• Older { "semanticSegments": [...] } exports
• Optional raw location fallback with a warning and local noise reduction
• Timeline paths, activities, and visits
• String, latLng, degree, geo:, and E7 coordinates
• Routes crossing the international date line

No Google sign-in, location permission, account permission, analytics, or broad storage permission is used. The app reads only the JSON and video files you choose, and video rendering stays on the device. The Travel Journal stores useful imported journey history in private app storage and is never uploaded.

Google Sign-In could provide a profile name, but Google does not expose the phone's Timeline history through Sign-In. Requiring it would add account access without removing the export step, so the app uses your editable phone name for the default title.

Your Timeline file is never uploaded. The basemap is the only network feature. CARTO receives requests for the map areas shown and serves tiles based on OpenStreetMap data. This can reveal viewed areas to the tile provider, but the Timeline JSON is not uploaded. Before the first Timeline is loaded, the app explains this transfer and lets you cancel. See the full privacy explanation.

The original Python generator remains available for desktop users. It requires Python 3.9+, FFmpeg, and the packages in requirements.txt.

See platform parity for the portable features shared by Android, the desktop CLI, and the web app, plus the intentionally Android-only features.

python -m 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

Android development requires JDK 17, Android SDK Platform 36, and Build Tools 36.0.0. Set CARTO_BASEMAP_API_KEY when building a copy that requests CARTO basemap tiles. Official Android and web releases inject the same project key from GitHub Actions. Local Python runs read the key from this environment variable as well.

export CARTO_BASEMAP_API_KEY="your-project-key"
./gradlew test lint assembleGithubDebug assemblePlayDebug
python -m pip install -r requirements-dev.txt
python -m pytest

Basemap attribution is displayed in every preview and exported video: © OpenStreetMap contributors and © CARTO.

If Timeline Visualizer was useful to you, you can leave an optional one-time contribution. Support is appreciated but never required and does not include paid features, priority support, or a commitment to future development.

Licensed under the MIT License.