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.