Location history and tracks management software.

Cetus is a small location assistant, capable of storing and sharing live location and GPX tracks

phoenix 7b0621ed19 Started on Search 2 months ago
feldspaten.org 7b0621ed19 Started on Search 2 months ago
src 54975f90c9 Bugfix: Not running when no source file exists 4 months ago
webserver 7b0621ed19 Started on Search 2 months ago
.gitignore 8b446b8cc5 Small update 3 months ago
README.md 61e9686aaf Packge concept 5 months ago

README.md

Cetus

Location history and tracks management software written in Go.

Cetus is a small location assistant, capable of storing and sharing live location and GPX tracks

Project is currently in development and not yet public.

Install

For now, please deploy the feldspaten.org folder in $GOPATH/src. Then the src folder contains the programs.

CLI

Cetus can be controlled initially via the CLI. Run cetus -help to list all available commands

Administrative tasks:
  --list-users             List all users
  --list-devices           List all devices
  --list-device=ID         List device info (and identifiers) for the given device
  --add-user=USER          Create new user in database
    --password=PASS        Password for new user (if not provided it will be asked)
    --name=NAME            Name of the new user (if not provided it will be asked)
    --uid=UID              User ID (if not provided, it will be selected automatically)
  --remove-user=USER       Delete user from database
  --add-device=NAME        Create new device
    --id=ID                Device ID (if not provided, it will be selected automatically)
    --owner=UID            Owner of the device (must be the user ID)
    --desc=DESC            Device description
  --remove-device=NAME     Remove device
  --add-device-id=DEVICE   Create new device identifier (for MQTT)
                           DEVICE determines the device ID
                           This is used to track the MQTT topic of the form 'owntracks/USER/IDENTIFIER'
    --user=USER            Username for MQTT topic
    --id=IDENTIFIER        Identifier for MQTT topic

Development

TODO

  • Documentation about sources.dat
  • Cleanup procedure, that routinely purges unnecessary or unaccurate entries from the database (take triples and check if the middle entry should survive on each push?)
  • UDP receiver
  • OsmAnd receiver?