https://github.com/smokeslate/mbf-tools
Open android settings on quest headsets, Useful for modding.
https://github.com/smokeslate/mbf-tools
android modding quest quest3 settings
Last synced: about 1 month ago
JSON representation
Open android settings on quest headsets, Useful for modding.
- Host: GitHub
- URL: https://github.com/smokeslate/mbf-tools
- Owner: SmokeSlate
- License: mit
- Created: 2025-08-29T19:41:18.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2026-06-02T13:45:45.000Z (about 1 month ago)
- Last Synced: 2026-06-02T15:25:44.227Z (about 1 month ago)
- Topics: android, modding, quest, quest3, settings
- Language: Kotlin
- Homepage:
- Size: 91.1 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# MBF Tools and Setup
> **Download:** [mbf.tools](https://mbf.tools)
Single-app Quest setup, support, and MBF integration for [mbf-launcher](https://github.com/DanTheMan827/mbf-launcher).
---
## What it does
- **Guided on-headset setup** — step-by-step wizard for Android dev mode, Wireless Debugging, and ADB pairing. Real-time status checks at each step.
- **Wireless ADB pairing** — enter the 6-digit code from Wireless Debugging; the app detects pairing and debug ports automatically.
- **Integrated MBF** — starts the upstream MBF native bridge locally and opens the live MBF web app in a built-in browser.
- **Live support hub** — live FAQ and fix form from the wiki, available without leaving the app.
- **Performance controls** — adjust CPU, GPU, and refresh rate over ADB with presets (Battery / Balanced / Max).
- **Debug log sharing** — one-tap export sends a diagnostic payload to support with a share code.
---
## Install (Quest headset)
1. Open the Quest browser and go to **https://smokeslate.github.io/MBF-Tools**.
2. Tap **Download APK**.
3. Install via the Files app → package installer.
4. Find **MBF Tools and Setup** under Unknown Sources.
---
## Build locally
**Debug (install to connected device):**
```powershell
.\build-and-push.ps1
```
**Signed release APK:**
```powershell
.\build-release.ps1
```
Requires Android SDK and a `app/signing.properties` file with keystore credentials for release builds.
---
## Architecture
| Layer | Technology |
|---|---|
| Android app | Kotlin, XML layouts, View Binding |
| Backend | Cloudflare Worker (`/api`) |
| ADB bridge | Upstream MBF native binary |
| WebView target | Live MBF web app (external) |
Key classes: `LauncherActivity`, `HomeActivity`, `GuideActivity`, `MainActivity` (ADB/debug screen), `BrowserActivity`, `AdbManager`, `SetupState`, `DiagnosticsCollector`.
---
## Links
- **Wiki:** [wiki.sm0ke.org](https://wiki.sm0ke.org)
- **MBF Tools page:** [wiki.sm0ke.org/#/mbftools](https://wiki.sm0ke.org/#/mbftools)
- **Discord:** [d.sm0ke.org](https://d.sm0ke.org)
- **mbf-launcher:** [github.com/DanTheMan827/mbf-launcher](https://github.com/DanTheMan827/mbf-launcher)
---
MIT License