https://github.com/Freika/dawarich
Self-hosted alternative to Google Location History (Google Maps Timeline)
https://github.com/Freika/dawarich
google-maps hacktoberfest homelab maps owntracks self-hosted
Last synced: 7 months ago
JSON representation
Self-hosted alternative to Google Location History (Google Maps Timeline)
- Host: GitHub
- URL: https://github.com/Freika/dawarich
- Owner: Freika
- License: agpl-3.0
- Created: 2024-03-24T19:46:00.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-10-29T11:12:29.000Z (about 1 year ago)
- Last Synced: 2024-10-29T12:46:48.502Z (about 1 year ago)
- Topics: google-maps, hacktoberfest, homelab, maps, owntracks, self-hosted
- Language: Ruby
- Homepage: https://dawarich.app
- Size: 3.93 MB
- Stars: 2,116
- Watchers: 12
- Forks: 47
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- trackawesomelist - Dawarich (⭐1.8k) - Self-hosted alternative to Google Location History. (Recently Updated / [Sep 15, 2024](/content/2024/09/15/README.md))
- StarryDivineSky - Freika/dawarich
- awesome-repositories - Freika/dawarich - Self-hostable alternative to Google Timeline (Google Location History) (Ruby)
- definitive-opensource - Dawarich - hostable alternative to Google Timeline (Google Location History) | `SelfHost` | **7.2k** | (Table of Contents / Uncategorized)
README
# 🌍 Dawarich: Your Self-Hosted Location History Tracker
[](https://discord.gg/pHsBjpt5J8) | [](https://ko-fi.com/H2H3IDYDD) | [](https://www.patreon.com/freika)
Donate using crypto: [0x6bAd13667692632f1bF926cA9B421bEe7EaEB8D4](https://etherscan.io/address/0x6bAd13667692632f1bF926cA9B421bEe7EaEB8D4)
[](https://app.circleci.com/pipelines/github/Freika/dawarich)
---
## 📸 Screenshots
*Map View*
*Statistics Overview*
*Imports page*
---
## 🗺️ About Dawarich
**Dawarich** is a self-hosted web app designed to replace Google Timeline (aka Google Location History). It enables you to:
- Visualize your data on an interactive map.
- Import your location history from Google Maps Timeline and Owntracks.
- Explore statistics like the number of countries and cities visited, total distance traveled, and more!
📄 **Changelog**: Find the latest updates [here](CHANGELOG.md).
👩💻 **Contribute**: See [CONTRIBUTING.md](CONTRIBUTING.md) for how to contribute to Dawarich.
---
## ⚠️ Disclaimer
- 💔 **DO NOT UPDATE AUTOMATICALLY**: Read release notes before updating. Automatic updates may break your setup.
- 🛠️ **Under active development**: Expect frequent updates, bugs, and breaking changes.
- ❌ **Do not delete your original data** after importing into Dawarich.
- 📦 **Backup before updates**: Always [backup your data](https://dawarich.app/docs/tutorials/backup-and-restore) before upgrading.
- 🔄 **Stay up-to-date**: Make sure you're running the latest version for the best experience.
---
## 🧭 Supported Location Tracking
You can track your location with the following apps:
- 🌍 [Overland](https://dawarich.app/docs/tutorials/track-your-location#overland)
- 🛰️ [OwnTracks](https://dawarich.app/docs/tutorials/track-your-location#owntracks)
- 🗺️ [GPSLogger](https://dawarich.app/docs/tutorials/track-your-location#gps-logger)
- 🏡 [Home Assistant](https://dawarich.app/docs/tutorials/track-your-location#homeassistant)
Simply install one of the supported apps on your device and configure it to send location updates to your Dawarich instance.
---
## 🚀 How to Start Dawarich Locally
1. Clone the repository.
2. Run the following command to start the app:
```bash
docker-compose up
```
3. Access the app at `http://localhost:3000`.
⏹️ **To stop the app**, press `Ctrl+C`.
---
## 🔧 How to Install Dawarich
- **[Docker Setup](https://dawarich.app/docs/intro#setup-your-dawarich-instance)**
- **[Synology](https://dawarich.app/docs/tutorials/platforms/synology)**
🆕 **Default Credentials**
- **Username**: `demo@dawarich.app`
- **Password**: `password`
(Feel free to change them in the account settings.)
---
## 📊 Features
### 🔍 Location Tracking
- Track your live location using one of the [supported apps](#-supported-location-tracking).
### 🗺️ Location History Visualization
- View your historical data on a map with customizable layers:
- Heatmap
- Points
- Lines between points
- Fog of War
### 🔵 Areas
- Draw areas on the map so Dawarich could suggest your visits there.
### 📍 Visits (Beta)
- Dawarich can suggest places you've visited and allow you to confirm or reject them.
### 📊 Statistics
- Analyze your travel history: number of countries/cities visited, distance traveled, and time spent, broken down by year and month.
### 📸 Integrations
- Provide credentials for Immich or Photoprism (or both!) and Dawarich will automatically import geodata from your photos.
- You'll also be able to visualize your photos on the map!
### 📥 Import Your Data
- Import from various sources:
- Google Maps Timeline
- OwnTracks
- Strava
- Immich
- GPX/GeoJSON files
- Photos’ EXIF data
### 📤 Export Your Data
- Export your data to GeoJSON or GPX formats.
---
## 📚 Guides and Tutorials
- [Set up Reverse Proxy](https://dawarich.app/docs/tutorials/reverse-proxy)
- [Import Google Takeout](https://dawarich.app/docs/tutorials/import-existing-data#sources-of-data)
- [Track Location with Overland](https://dawarich.app/docs/tutorials/track-your-location#overland)
- [Track Location with OwnTracks](https://dawarich.app/docs/tutorials/track-your-location#owntracks)
- [Export Your Data](https://dawarich.app/docs/tutorials/export-your-data)
🛠️ More guides available in the [Docs](https://dawarich.app/docs/intro).
---
## 🛠️ Environment Variables
Check the documentation on the [website](https://dawarich.app/docs/environment-variables-and-settings) for detailed information about environment variables and settings.
---
## 💫 Star History
As you could probably guess, I like statistics.
