android app for https://otb-tracker.outsidethebox.top tracking
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2.1 KiB
2.1 KiB
follow-me
Android tracker client for the OutsideTheBox follow-me service.
Operational app label: otb-tcom Project name / repo name: follow-me
MVP v0.1.0
- Android 6.0+ (
minSdk 23) - Foreground location tracking service
- HTTPS primary ingest endpoint with HTTP fallback
- Auto-default to HTTP after 3 consecutive HTTPS fallback events on that device
- Token-based header auth via
X-API-Key - Moving mode: 10 second posts
- Idle mode: 5 minute posts
- Reboot restart if tracking was enabled before reboot
- Simple installer/settings UI
Ingest behavior
Primary:
https://otb-tracker.outsidethebox.top/api/gps-ingest
Fallback:
http://otb-tracker.outsidethebox.top/api/gps-ingest
Headers:
X-API-Key: <device token>Content-Type: application/json
JSON body:
{
"latitude": 43.8971,
"longitude": -78.8658,
"speed_kmh": 0,
"accuracy_m": 12,
"heading_deg": 0,
"altitude_m": 95,
"recorded_at": "2026-03-16T14:32:10Z",
"source": "otb-tcom"
}
Build on ripper
cd /home/def/outsidethebox
git clone ssh://git@git.etica-stats.org:5252/def/follow-me.git /home/def/outsidethebox/follow-me
cd /home/def/outsidethebox/follow-me
Copy this project into that directory, then build with Android Studio or the Gradle wrapper after generating it from Android Studio once.
Git bootstrap on ripper
mkdir -p /home/def/outsidethebox
cd /home/def/outsidethebox
[ -d follow-me/.git ] || git clone ssh://git@git.etica-stats.org:5252/def/follow-me.git follow-me
cd /home/def/outsidethebox/follow-me
git remote -v
If the remote repo is empty and you want to seed it from this scaffold:
cd /home/def/outsidethebox/follow-me
git add .
git commit -m "Initial Android tracker scaffold for follow-me"
git push -u origin master
Notes
- The app label is intentionally discreet:
otb-tcom. - Network onboarding, admin creation, drone enrollment, and role-specific install flows should be added once corresponding backend APIs exist.
- On Android 8.0+, real-time background tracking requires a foreground service with a visible notification.