Data preparation

The more data sources you add to Timelinize, the better it gets. Ideally, add all the data you have from as many data sources that Timelinize supports.

Find the data sources below that apply to you, and acquire your data from them. Additional documentation pages are available for each data source containing instructions and more details.

• Phones
  • iPhone: Make an unencrypted backup of your iPhone using Finder on macOS or iTunes on Windows.
  • Android: Use SMS Backup & Restore to get your text messages.
• Google account: Use Google Takeout to export your:
  • Location History (JSON format)
  • Photos (or just a few select albums to test with)
  • Contacts (vCard format recommended; their CSV exporter is broken)
  • Gmail
  • NOTE: Multi-archive exports are currently only supported if you extract the archives into the same target folder first.
• Locations: Generated by various apps and programs:
  • GPS Exchange files (.gpx)
  • KML-GX files (.kml), which is KML but with Google's extensions ("gx"). GPSLogger creates these files.
  • GeoJSON files (.geojson) created by GPSLogger (or anything, as long as it's a FeatureCollection with a list of points and their timestamps.)
• Social media: Timelinize supports various account export archives from social media sites:
  • Twitter/X: Request an archive of your data
  • Facebook: Request a copy of your data in JSON format
  • Instagram: Request to download your data in JSON format
  • Strava: Go to Download or Delete Account and click "Request your Archive" in step 2. (Don't actually delete your account. Just download the data.)
• Photo/video libraries: Any folder containing mostly photos, videos, and audio can be imported.
• Contact lists / vCards: Prefer vCard, but common/standard CSV files can work too.
• Telegram: On Telegram Desktop, go to Settings -> Advanced -> Export Telegram Data (way at the bottom). Be sure to select "Machine-readable JSON" at the very bottom. Then, I recommend checking all the other boxes, but if not, make sure at least "Account information" and "Contacts list" and "Personal chats" are selected.
• Emails: Most .mbox and .eml files are supported. You can usually get these from your email service provider or client software.