Android client for OpenBenches.org — a crowd-sourced map of memorial benches.
Package: org.openbenches
Current version: 1.25 (versionCode 20)
Min SDK: 28 · Target / Compile SDK: 36
Licence: MIT
- Interactive OpenStreetMap / satellite map (osmdroid) with viewport clustering
- Browse global benches (disk-cached for offline map use), search inscriptions, random & newest benches
- Bench details with photos, fullscreen zoom, and download to gallery
- Add / edit benches (Auth0 login optional for attribution; anonymous upload supported)
- Camera & gallery photos, EXIF GPS checks, 90° rotate before upload
- On-device inscription OCR (OpenCV + PaddleOCR / ONNX)
- Save benches for later upload; bulk upload with username confirmation
- Local To-Do list (long-press map) with view-on-map, import/export JSON
- Contributors leaderboard, account details, dark mode
- About, Terms, Support, and Colophon screens
Open Benches/
├── app/ # Main Android application (Jetpack Compose)
├── ppocr-sdk/ # Vendored PaddleOCR Android ONNX SDK + models
├── gradle/ # Version catalog & wrapper
├── LICENSE
└── README.md
Application source lives under app/src/main/java/org/openbenches/:
| Package | Role |
|---|---|
ui/ |
Screens (map, add/edit bench, details, pending uploads, etc.) |
data/ |
API clients, Auth0 JWT helpers, local stores (pending uploads, to-do, cache) |
util/ |
Location, OCR, image URLs, photo rotate |
ui/theme/ |
Brand colours, Material 3 theme, shared components |
- Android Studio (recent stable) or JDK 17+ for the Gradle wrapper
- Device or emulator with Google Play Services (fused location)
- Network access to
https://openbenches.org/for live data and uploads
./gradlew :app:assembleDebug
./gradlew :app:installDebugOr open the project in Android Studio and Run on a device/emulator.
./gradlew :app:bundleRelease
# Optional helpers for Play Console uploads:
./gradlew :app:copyReleaseMappingForPlay
./gradlew :app:copyReleaseNativeDebugSymbolsForPlayAuth0 values are injected via buildConfigField and manifest placeholders in app/build.gradle.kts.
Optional overrides in gradle.properties (local or CI — do not commit secrets):
AUTH0_DOMAIN=your-tenant.eu.auth0.com
AUTH0_CLIENT_ID=your_native_client_id
AUTH0_SCHEME=openbenchesDefaults target the production OpenBenches Auth0 tenant.
Do not embed an Auth0 client secret in the Android app.
local.properties (SDK path) is gitignored.
./gradlew test
./gradlew connectedAndroidTest| Endpoint | Use |
|---|---|
| https://openbenches.org/api/ | Benches, search, details, user benches |
| https://openbenches.org/upload | Multipart bench upload |
| https://openbenches.org/update | Multipart bench edit |
| https://openbenches.org/leaderboard | Contributors (parsed HTML) |
Uploads may be challenged by CDN/WAF bot protection. The app detects those HTML challenge pages and shows a clear user message instead of raw script/CSS.
On-device OCR uses:
- OpenCV — photo preprocessing
:ppocr-sdk— PaddleOCR PP-OCRv5 mobile ONNX models + Microsoft onnxruntime-android (16 KB page-size aligned)
See ppocr-sdk/README.md.
- osmdroid with OpenStreetMap (Mapnik) and Esri World Imagery tiles
- Custom viewport clustering (
ViewportBenchClusterer) - Play Services Location for GPS / follow-me
- End-user walkthrough (screens, buttons, features):
docs/README.md - Website & data project: openbenches/openbenches.org
- Live site: https://openbenches.org/
This app is released under the MIT Licence.
ppocr-sdk is vendored from PaddleOCR under Apache-2.0.