owntracks-import/README.md

26 lines
1021 B
Markdown
Raw Normal View History

2025-02-04 13:38:17 +02:00
# 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)
2025-02-06 16:06:50 +02:00
- Tries to fix wrong battery levels
- Can continue importing the same file starting from the provided record number
2025-02-04 13:38:17 +02:00
## Anti-features
- Errors handling is bad
- Can't authenticate
2025-02-06 16:06:50 +02:00
- Probably will fail with self-signed certificate
2025-02-04 13:38:17 +02:00
- Tested only on GeoJSON exported by Dawarich
## Usage
```
2025-02-04 13:58:47 +02:00
dart bin/owntracks_import.dart -s <GeoJSON file path> -d <Recorder IP address with protocol and port> -u <user name> -v
2025-02-06 16:06:50 +02:00
```
or
```
2025-02-04 13:38:17 +02:00
dart bin/owntracks_import.dart --help
```