owntracks-import/README.md

# OwnTracks Import
Imports GeoJSON location records to [OwnTracks Recorder](https://github.com/owntracks/recorder) through HTTP. Initially developed to migrate data from [Dawarich](https://github.com/Freika/dawarich) to OwnTracks Recorder.

Requires Dart runtime.

## Features
- Defaults to `phone` for device when `tracker_id` is not provided
- Removes `device_tracker.` prefix from `tracker_id` field if exists
- By default waits for 2 seconds before each request to avoid hitting OpenCage free tire API rate limits (Used by Recorder for reverse geocoding)
- Tries to fix wrong battery levels
- Can continue importing the same file starting from the provided record number

## Anti-features
- Errors handling is bad
- Can't authenticate
- Probably will fail with self-signed certificate
- Tested only on GeoJSON exported by Dawarich

## Usage
```
dart bin/owntracks_import.dart -s <GeoJSON file path> -d <Recorder IP address with protocol and port> -u <user name> -v
```
or
```
dart bin/owntracks_import.dart --help
```