init

README.md

@@ -0,0 +1,46 @@
+# Geobridge
+
+Bridges host geolocation from Geoclue into Waydroid by pushing mock locations through Appium Settings via `adb`. [Original script by Jacob D Ludvigsen](https://gitlab.com/papiris/geobridge)
+
+## Dependencies
+- Waydroid container reachable via `adb`
+- dbus
+- [devbox](https://github.com/jetify-com/devbox)
+
+## Connect adb to Waydroid
+1. Start Waydroid. Find its IP address (System > About)
+2. From the project root (or inside devbox): `adb connect <IP>:5555`
+
+## A) Run without Devbox:
+
+Make sure you have `adb`, `dbus-run-session`, `geoclue2`, `wget` available in your shell.
+
+```sh
+./geobridge.sh --init`
+```
+
+```sh
+dbus-run-session -- sh -c '/usr/libexec/geoclue-2.0/demos/agent >/tmp/geoclue-agent.log 2>&1 & ./geobridge.sh'
+```
+
+## B) Run with Devbox
+
+### Install Devbox
+
+```bash
+curl -fsSL https://get.jetify.com/devbox | bash
+```
+
+### Run
+
+One-time setup. Downloads and installs dependencies and sideloads Appium Settings to Waydroid:
+
+```sh
+devbox run init
+```
+
+Stream host location into Waydroid (keeps running):
+
+```sh
+devbox run serve
+```