39 lines
1.3 KiB
Markdown
39 lines
1.3 KiB
Markdown
# Tronbyt Toes App
|
|
|
|
This is a [toes](/Users/corey/code/toes) app. See the [toes CLAUDE.md](/Users/corey/code/toes/CLAUDE.md) for the framework docs.
|
|
|
|
Wraps the Tronbyt Go server (self-hosted Tidbyt replacement) as a toes-managed subprocess. Bun proxies all HTTP and WebSocket traffic to the Go binary over a unix socket.
|
|
|
|
## How It Works
|
|
|
|
```
|
|
Tidbyt device → tronbyt.toes.local → toes → Bun (PORT) → Go binary (unix socket)
|
|
```
|
|
|
|
- `src/server/index.tsx` — spawns Go binary, proxies HTTP + WebSocket, health checks
|
|
- `bin/` — pre-built Go binary (gitignored, per-platform)
|
|
- No UI of its own — Go server serves its own web dashboard
|
|
|
|
## Setup
|
|
|
|
1. Download the binary for your platform from https://github.com/tronbyt/server/releases
|
|
2. Place it in `bin/` (e.g. `bin/tronbyt-server-darwin-arm64`)
|
|
3. `chmod +x bin/tronbyt-server-*`
|
|
4. On macOS: System Settings → Privacy & Security → Allow Anyway
|
|
|
|
## Env Vars
|
|
|
|
Toes provides `PORT`, `DATA_DIR`, `APPS_DIR`, `TOES_URL`, `APP_URL`.
|
|
|
|
Tronbyt-specific vars (set via toes env config):
|
|
- `PRODUCTION` — `true` enables firmware downloads and system apps (default)
|
|
- `SINGLE_USER_AUTO_LOGIN` — `true` for home network (default)
|
|
- `SYSTEM_APPS_AUTO_REFRESH` — `true` to keep community apps updated (default)
|
|
|
|
## Device Config
|
|
|
|
Set the Tidbyt Image URL to:
|
|
```
|
|
http://tronbyt.toes.local/<device-id>/next
|
|
```
|