Driving routes that avoid ALPR cameras (Flock and others) mapped in OpenStreetMap, the dataset DeFlock displays. A Capacitor app: the UI is www/index.html, wrapped in a native Android shell.
- Create a new GitHub repo and push this folder to
main. - Open the repo's Actions tab. The Build APK workflow runs on every push (or start it by hand with Run workflow). It takes about 5 minutes.
- Open the finished run and download running-dark-debug-apk under Artifacts. It's a zip containing
app-debug.apk. - Install it on your phone (see "Installing" below).
Requires Node 20+, JDK 21 and Android Studio.
npm install
npm run build
npm run android:add # generates android/ and adds location permissions
npx cap sync android
npm run android:open # opens Android Studio; press Run with your phone plugged inAfter changing www/index.html, run npm run android:sync and Run again.
- Over USB: enable Developer options and USB debugging on the phone, then
adb install -r app-debug.apk. - On the phone: copy the APK over, tap it, and allow "Install unknown apps" for your file manager when Android asks.
Debug builds are signed with a throwaway debug key, which is fine for testing. For a release build you'd generate your own keystore and run ./gradlew assembleRelease.
npm run build && npm run serve, then open http://localhost:8080. Everything works except the Android-only parts: the share sheet and launching the Maps app.
| What | Service | Notes |
|---|---|---|
| Camera locations | Overpass API (OpenStreetMap) | node["surveillance:type"="ALPR"] |
| Address search | Nominatim | 1 request/second limit |
| Routing (default) | OSRM public demo server | Free, light use only |
| Routing (optional) | Google Routes API | Needs your API key; billed per request |
| Map tiles | tile.openstreetmap.org | Fine for testing; switch to a commercial tile provider if you distribute the app |