dadaloop82
da4bd635db
- README: remove Recent Updates section, clean roadmap (pending only), replace Screenshots with demo link, add 6 new badges (stars, last commit, contributors, discussions, CI), invite GIF contributions - CHANGELOG: translate all Italian entries to English, add v1.7.13 (DB fresh-install crash fix) - database.php: add missing 'undone' column to transactions schema; wrap ALTER TABLE calls in try/catch to prevent race-condition errors on concurrent first requests - Wiki: Android-Kiosk v1.5.0 → v1.6.0, Step 5 rewritten (BLE scan, no external APK), removed gateway troubleshooting section - Wiki: Scale-Gateway promoted to deprecated with redirect banner - Wiki: Home What's New updated to v1.7.12 / v1.7.13 - Wiki: Features.md, kiosk README Italian UI strings translated - .github: add bug_report.yml, feature_request.yml issue templates, config.yml (blank issues off, links to FAQ/Discussions/Security), PULL_REQUEST_TEMPLATE.md with checklist - .github: FUNDING.yml (Ko-fi), dependabot.yml (monthly action updates) - .github/workflows/security.yml: Trivy docker + fs scan, SARIF upload - .github/workflows/build-scale-gateway.yml: disabled (deprecated) - SECURITY.md: responsible disclosure policy, supported versions, scope - CODE_OF_CONDUCT.md: Contributor Covenant 2.1 - Settings UI: About section with version display, Report Bug button, Changelog and GitHub links; reportBugManual() + _loadAboutSection() - Translations: added 'about' key group (9 keys × 3 languages)
5.1 KiB
⚠️ Scale Gateway — Deprecated
As of EverShelf Kiosk v1.6.0, BLE scale support is fully integrated into the Kiosk app. You no longer need to install or configure this separate gateway.
📱 Using the EverShelf Kiosk app? → See Android Kiosk — configure your scale in Step 5 of the setup wizard.
💻 Not using the kiosk app? The legacy gateway APK below still works for non-kiosk setups, but receives no new updates.
Scale Gateway (legacy)
How it works
Smart Scale
│ (Bluetooth LE)
▼
Android device (Scale Gateway app)
│ (WebSocket — ws://127.0.0.1:8765)
▼
EverShelf Server (scale_relay.php — SSE relay)
│ (Server-Sent Events)
▼
EverShelf Web App (auto-fills weight in add/use forms)
The Gateway runs a local WebSocket server on port 8765. The EverShelf server proxies scale readings to the browser via SSE, avoiding HTTPS→WS mixed-content issues.
Download
Current version: v2.1.0 — requires Android 7.0+
Supported Scales
| Protocol | BLE Service | Notes |
|---|---|---|
| Bluetooth SIG Weight Scale | 0x181D / char 0x2A9D |
Most compatible |
| Bluetooth SIG Body Composition | 0x181B / char 0x2A9C |
Weight + body fat |
| Generic fallback | Any notifiable characteristic | Auto-heuristic for 100+ models |
Verified compatible models:
- Xiaomi Mi Body Composition Scale 2
- Renpho Smart Body Fat Scale
- Any scale supported by openScale
Setup
1. Install
Download and install the APK. You may need to enable "Install from unknown sources" in Android Settings.
2. Launch the app
The gateway server starts immediately. Note the Gateway URL shown (e.g. ws://192.168.1.100:8765).
3. Configure EverShelf
In EverShelf Settings → Scale:
- Enable scale integration
- Enter the Gateway URL (or let auto-discovery find it)
Kiosk users: this is done automatically during setup.
4. Connect your scale
Tap "Cerca Bilance Bluetooth" (Find Bluetooth Scales). Make sure your scale is powered on. Tap it in the list to pair and connect.
Using the Scale in EverShelf
When scale integration is enabled:
- Open the Add or Use form for any product with unit
gorml - A "⚖️ Leggi bilancia" button appears
- Tap it — a live weight display appears with a stability indicator
- Step on or place the product on the scale
- When the reading stabilizes, a 5-second countdown starts
- The weight auto-fills the quantity field and the form submits
Thresholds and de-duplication
- 10g threshold — readings that haven't changed enough between products are ignored to prevent stale readings
- 12-second server-side dedup — a second scale-triggered deduction of the same product within 12 seconds is rejected (guards against BLE multi-fire)
- ml conversion — when the product unit is
ml, the weight in grams is accepted and a hint is shown: "weight in grams → will be converted to ml"
Scale Status Indicator
The header of the EverShelf web app shows a real-time scale status icon (⚖️):
| State | Meaning |
|---|---|
| ⚖️ green | Connected and ready |
| ⚖️ amber | Searching / reconnecting |
| ⚖️ grey | Disconnected |
| ⚖️ red | Error |
Update Notifications
Every 6 hours the gateway app checks GitHub releases. If a newer version is available, a banner appears with a one-tap download and install.
Troubleshooting
Scale not appearing in the Bluetooth list
- Make sure BLE is enabled on the Android device
- Step on/shake the scale to wake it up (most scales enter sleep mode quickly)
- Some scales only advertise while someone stands on them
Weight not appearing in EverShelf
- Confirm the Gateway URL in EverShelf Settings matches the URL shown in the gateway app
- Check that the Android device and the EverShelf server are on the same network
- Tap "Disconnetti / Riconnetti" in the gateway app to refresh the WebSocket connection
"Mixed content" error in browser
- Make sure you are accessing EverShelf over HTTPS (not plain HTTP)
- The SSE relay (
scale_relay.php) handles the HTTP→WS bridging — ensure the relay script is reachable
Building from Source
cd evershelf-scale-gateway
./gradlew assembleRelease
# APK: app/build/outputs/apk/release/app-release.apk
Requires Android Studio or JDK 17+ with the Android SDK.
BLE Protocol Details
The gateway uses the following GATT profile order:
- Weight Scale (
0x181D) — standard weight only - Body Composition (
0x181B) — weight + additional metrics - Generic fallback — subscribes to all notifiable characteristics and applies a heuristic parser that handles byte-order variations used by the majority of consumer smart scales
Weight values are extracted in kg, converted to grams, and broadcast over WebSocket as:
{ "weight_g": 1234, "stable": true, "unit": "g" }