Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Freika/dawarich
Google Location History (Google Maps Timeline) self-hosted alternative.
https://github.com/Freika/dawarich
google-maps homelab maps owntracks self-hosted
Last synced: 3 months ago
JSON representation
Google Location History (Google Maps Timeline) self-hosted alternative.
- Host: GitHub
- URL: https://github.com/Freika/dawarich
- Owner: Freika
- License: agpl-3.0
- Created: 2024-03-24T19:46:00.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2024-05-27T20:36:14.000Z (5 months ago)
- Last Synced: 2024-05-28T06:22:53.190Z (5 months ago)
- Topics: google-maps, homelab, maps, owntracks, self-hosted
- Language: Ruby
- Homepage:
- Size: 2.41 MB
- Stars: 188
- Watchers: 2
- Forks: 1
- Open Issues: 3
-
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
[](https://discord.gg/pHsBjpt5J8) | [](https://ko-fi.com/H2H3IDYDD) | [](https://www.patreon.com/freika)
## Screenshots
Dawarich is a self-hosted web application to replace Google Timeline (aka Google Location History). It allows you to import your location history from Google Maps Timeline and Owntracks, view it on a map and see some statistics, such as the number of countries and cities visited, and distance traveled.
You can find changelog [here](CHANGELOG.md).
## Disclaimer
⚠️ The project is under very active development.
⚠️ Expect bugs and breaking changes.
⚠️ Do not delete your original Google Maps
Timeline data after importing it to Dawarich.
⚠️ Export your data from Dawarich using built-in
export functionality before updating to a new version.
⚠️ Try to keep Dawarich up-to-date to have the latest features and bug fixes.
## Usage
To track your location, install the [Owntracks app](https://owntracks.org/booklet/guide/apps/) or [Overland app](https://overland.p3k.app/) on your phone and configure it to send location updates to your Dawarich instance.
### OwnTracks
The url to send the location updates to is `http:///api/v1/owntracks/points?api_key=YOUR_API_KEY`.
Currently, the app only supports [HTTP mode](https://owntracks.org/booklet/tech/http/) of OwnTracks.
### Overland
The url to send the location updates to is `http:///api/v1/overland/batches?api_key=YOUR_API_KEY`.
Your API key can be found and/or generated in the user settings.
To import your Google Maps Timeline data, download your location history from [Google Takeout](https://takeout.google.com/) and upload it to Dawarich.
## How-to's
- [How to set up reverse proxy](docs/how_to_setup_reverse_proxy.md)
- [How to import Google Takeout to Dawarich](https://github.com/Freika/dawarich/wiki/How-to-import-your-Google-Takeout-data)
- [How to import Google Semantic History to Dawarich](https://github.com/Freika/dawarich/wiki/How-to-import-your-Google-Semantic-History-data)
- [How to import Google Maps Timeline Data to Dawarich](https://github.com/Freika/dawarich/wiki/How-to-import-your-Google-Maps-Timeline-data)
- [How to track your location to Dawarich with Overland](https://github.com/Freika/dawarich/wiki/How-to-track-your-location-to-Dawarich-with-Overland)
- [How to track your location to Dawarich with OwnTracks](https://github.com/Freika/dawarich/wiki/How-to-track-your-location-to-Dawarich-with-OwnTracks)
- [How to export your data from Dawarich](https://github.com/Freika/dawarich/wiki/How-to-export-your-data-from-Dawarich)
More guides can be found in the [Wiki](https://github.com/Freika/dawarich/wiki#how-tos)
## Features
### Location Tracking
You can track your location using the Owntracks or Overland app.
### Location history
You can view your location history on a map. On the map you can enable/disable the following layers:
- Heatmap
- Points
- Lines between points
### Statistics
You can see the number of countries and cities visited, the distance traveled, and the time spent in each country, splitted by years and months.
### Import
You can import your existing location history from:
- Google Maps Timeline
- OwnTracks
- Strava
- Your own GPX files
- Your photos' EXIF data
## How to start the app locally
`docker-compose up` to start the app. The app will be available at `http://localhost:3000`.
Press `Ctrl+C` to stop the app.
## How to install the app
**[Docker](docs/How_to_install_Dawarich_using_Docker.md)**
**[Synology](docs/How_to_install_Dawarich_on_Synology.md)**
### Default credentials
- **Username**: `[email protected]`
- **Password**: `password`
Feel free to change them both in the Account section.
## Environment variables
| ENV var name | Description |
|-----------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|
| MIN_MINUTES_SPENT_IN_CITY | minimum minutes between two points to consider them as visited the same city, e.g. `60` |
| TIME_ZONE | time zone, e.g. `Europe/Berlin`, full list is [here](https://github.com/Freika/dawarich/issues/27#issuecomment-2094721396) |
| APPLICATION_HOSTS | list of host of the application, e.g. `localhost,dawarich.example.com` |
| BACKGROUND_PROCESSING_CONCURRENCY (only for dawarich_sidekiq service) | Number of simultaneously processed background jobs, default is 10 |
| REVERSE_GEOCODING_ENABLED | `true` or `false`, this env var allows you to disable reverse geocoding feature entirely |
## Star History
As you could probably guess, I like statistics.
