php-tracks-recorder & client

A simple and responsive self-hosted solution to record and map Owntracks http payloads or Overland payloads.

Screenshots

Location records mapping

Responsible interface & controls

Features

• HTTP payloads recoding into database, currently from Owntracks & Overland mobile apps
• Interface to map location records
• Responsive : accessible on mobile and tablet !
• Calendar to select location records period

Installation

Requirements

• PHP 7 and above
• MySQL (or equivalent MariaDB,...) or SQLite
• self hosted / dedicated server / shared hosting

That's it !

Installation instructions

PHP Client

1. Download the source code and copy the content of the directory to your prefered location
2. Edit the config.inc.sample.php file to setup access to your database and rename to config.inc.php
3. Create datatable using schema_mysql.sql or schema_sqlite.sql

Owntracks app

Follow Owntracks Booklet to setup your Owntracks app :

1. Setup your Owntracks app :

   Key	Value
   Mode	HTTP
   URL	http://your_host/your_dir/record.php

Overland app

Follow Overland-iOS documentation to setup your Overland app :

1. Setup your Overland app :

   Key	Value
   Receiver Endpoint	http://your_host/your_dir/record.php

Usage

First time access

Access map of today's recorded locations at : http://your_host/your_dir/

Navigate through your recorded locations

• Use the "Previous" and "Next" buttons
• Manually change the From / To dates (next to the "Previous" button)

Adjust map settings

• Use the "Config" button to :
  • Display or hide the individual markers (first and last markers for the period will always be displayed)
  • Change maximum accuracy for displayed location records

Contributing

So far my team is small - just 1 person, but I'm willing to work with you!

I'd really like for you to bring a few more people along to join in.

Credits

• jQuery : the fast, small, and feature-rich JavaScript library
• Bootstrap : the sleek, intuitive, and powerful mobile first front-end framework for faster and easier web development
• Bootstrap-Datepicker :
• MomentJS : Full featured date library for parsing, validating, manipulating, and formatting dates
• LeafletJS : an open-source JavaScript library for mobile-friendly interactive maps
• Leaflet Hotline : A Leaflet plugin for drawing colored gradients along polylines.
• js-cookie : A simple, lightweight JavaScript API for handling browser cookies

License

This project is published under the GNU General Public License v3.0