Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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: about 1 month 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 (9 months ago)
Default Branch: master
Last Pushed: 2024-10-29T11:12:29.000Z (about 1 month ago)
Last Synced: 2024-10-29T12:46:48.502Z (about 1 month 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

awesome-repositories - Freika/dawarich - Self-hosted alternative to Google Location History (Google Maps Timeline) (Ruby)
trackawesomelist - Dawarich (⭐1.8k) - Self-hosted alternative to Google Location History. (Recently Updated / [Sep 15, 2024](/content/2024/09/15/README.md))

README

        # 🌍 Dawarich: Your Self-Hosted Location History Tracker

[![Discord](https://dcbadge.limes.pink/api/server/pHsBjpt5J8)](https://discord.gg/pHsBjpt5J8) | [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/H2H3IDYDD) | [![Patreon](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.vercel.app%2Fapi%3Fusername%3Dfreika%26type%3Dpatrons&style=for-the-badge)](https://www.patreon.com/freika)

Donate using crypto: [0x6bAd13667692632f1bF926cA9B421bEe7EaEB8D4](https://etherscan.io/address/0x6bAd13667692632f1bF926cA9B421bEe7EaEB8D4)

[![CircleCI](https://circleci.com/gh/Freika/dawarich.svg?style=svg)](https://app.circleci.com/pipelines/github/Freika/dawarich)

---

## 📸 Screenshots

![Map](screenshots/map.jpeg)

*Map View*

![Stats](screenshots/stats.jpeg)

*Statistics Overview*

![Import](screenshots/imports.jpeg)

*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).

---

## ⚠️ Disclaimer

- 🛠️ **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**: `[email protected]`

- **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.

### 📥 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.