Tribit Web Control

Tribit Web Control is a browser-based control app for the Tribit XSound Plus 2, and potentially other supported bluetooth speakers that use BLE. It lets you connect over Web Bluetooth and adjust volume, EQ, auto-off settings, prompts, battery status, and EQ button mappings without relying on a native mobile app.

The project currently includes a speaker profile for the Tribit XSound Plus 2.

Open the hosted app

Use the hosted version for the best experience. It runs over HTTPS, works well as an installable PWA, and is the recommended way to use the app.

Quick options:

• Hosted app: https://dvdavd.github.io/tribitwebctl/
• Standalone file: build or download standalone.html for a single-file local version

Features

• Connect to a supported speaker with Web Bluetooth
• Adjust speaker volume
• Change the active EQ preset or edit a custom 9-band EQ curve
• Assign EQ presets to the hardware EQ button modes
• Save custom EQ presets locally in the browser
• Enable or disable a sleep timer (up to 23 hours, 59 minutes)
• Enable or disable auto shutdown
• Enable or disable voice and beep prompts
• View battery percentage
• View firmware version
• Install as a PWA for an app-like experience
• Build a single-file standalone.html version with inlined assets

Requirements

• A browser with Web Bluetooth support
  • Chrome, Edge, or Opera work best
  • Chrome on Android works well
  • iOS typically requires a browser with Bluetooth support such as Bluefy
• Bluetooth enabled on the host device
• The app served from https:// or http://localhost

Notes:

• On some Linux setups, Web Bluetooth may require enabling chrome://flags/#enable-experimental-web-platform-features.
• The speaker should not already be connected to the official app while this app is trying to connect.

Running Locally

This project is a static web app. You can serve it with any simple local web server.

Example:

python3 -m http.server 8000

Then open:

http://localhost:8000

Because localhost is treated as a secure context, Web Bluetooth can be used there without HTTPS certificates.

Standalone Build

The build step creates a self-contained standalone.html file by:

• bundling JavaScript with esbuild
• inlining CSS
• embedding referenced assets as data URIs
• removing the CSP and manifest link for file-based usage

Build it with:

npm install
npm run build

The output is written to:

standalone.html

Unlike the main app, the standalone build does not need a web server. You can open standalone.html directly from local disk in a compatible browser and use it as a single-file version of the app.

GitHub Actions also builds standalone.html automatically on pushes to main and on manual runs. The generated file is uploaded as a workflow artifact.

Storage

Custom EQ presets are stored in the browser with localStorage. They are device-local and browser-local, so they will not automatically sync across browsers or machines.

PWA Behavior

The app includes:

• a web app manifest
• a service worker that caches the app shell for offline reuse

Bluetooth control still depends on browser support and access to the local Bluetooth adapter. The hosted GitHub Pages version is the recommended way to use the PWA because it runs over HTTPS.

Limitations

• Web Bluetooth support varies by platform and browser
• Only the currently implemented speaker profile is supported
• Playback controls, power-off and factory reset are not supported over BLE
• The standalone build is intended for convenience, but Bluetooth behavior can still differ by browser and platform
• Opening standalone.html from file:// may behave differently from the hosted HTTPS version depending on browser security rules

License

This project is licensed under the MIT License. See LICENSE.