tronbyt/CLAUDE.md

Tronbyt Toes App

This is a toes app. See the 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