Git Product home page Git Product logo

dawarich's Introduction

Dawarich

Discord | ko-fi | Patreon

Screenshots

Map

Stats

Import

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.

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 or Overland 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://<your-dawarich-instance>/api/v1/owntracks/points?api_key=YOUR_API_KEY.

Currently, the app only supports HTTP mode of OwnTracks.

Overland

The url to send the location updates to is http://<your-dawarich-instance>/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 and upload it to Dawarich.

How-to's

More guides can be found in the Wiki

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

⚠️ Note: Import of huge Google Maps Timeline files may take a long time and consume a lot of memory. It also might temporarily consume a lot of disk space due to logs. Please make sure you have enough resources before starting the import. After import is completed, you can restart your docker container and logs will be removed.

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

Synology

Default credentials

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
MAP_CENTER default map center, e.g. [55.7522, 37.6156]
TIME_ZONE time zone, e.g. Europe/Berlin, full list is here
APPLICATION_HOST host of the application, e.g. localhost or dawarich.example.com
BACKGROUND_PROCESSING_CONCURRENCY (only for dawarich_sidekiq service) Number of simultaneously processed background jobs, default is 10

Star History

As you could probably guess, I like statistics.

Star History Chart

dawarich's People

Contributors

freika avatar dependabot[bot] avatar aikufurr avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.