https://github.com/baloise/catcast
A tiny digital signage stack.
https://github.com/baloise/catcast
Last synced: 14 days ago
JSON representation
A tiny digital signage stack.
- Host: GitHub
- URL: https://github.com/baloise/catcast
- Owner: baloise
- License: 0bsd
- Created: 2026-05-11T08:37:07.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-12T11:20:01.000Z (about 1 month ago)
- Last Synced: 2026-05-12T12:35:44.471Z (about 1 month ago)
- Language: Rust
- Size: 215 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# CatCast
A tiny digital signage stack for places where you can't install software as
admin. Three pieces:
- **catstage** — fullscreen viewer (Tauri / WebView2). Drop the EXE on a
machine, point it at a broker, walk away.
- **catsocks** — dumb WebSocket relay. Runs on Cloudflare Workers' free
tier. Sees only opaque ciphertext.
- **catc** — the CLI. Drives one or many stages from your laptop.
End-to-end encrypted. No accounts, no master server, no telemetry. Stage
state survives reboots and broker outages.
## Status
Early. v1 targets Windows x64 only — macOS / Linux / ARM distribution
may follow. Auto-update is **not** in v1 (corp proxies block executable
downloads in our test environment); updating a stage is a manual EXE
swap. WSL/Linux is the recommended dev path.
## Quick start
```bash
# 1. Deploy the broker (once per deployment)
cd crates/catsocks && wrangler deploy
# -> wss://catsocks..workers.dev/r/
# 2. On each stage machine
catstage.exe --install-autostart --socks wss://.../r/ --name kitchen --screen 2
# Optional: --screen is 1-based. If unavailable, catstage falls back to primary monitor.
# 3. On your laptop
catc init --socks wss://.../r/
catc stage add kitchen # the name shows on the stage's catcast://about page
catc config import config.yaml --name kitchen
catc nav https://example.com --for 5m
```
See `examples/` for `config.yaml`, `aliases.yaml`, and a default Rhai logic.
## License
[0BSD](LICENSE). Use it. Fork it. Strip the credits. Sell it. Whatever.
## Contributing
Yes please. See [CONTRIBUTING.md](CONTRIBUTING.md). No CLA, no DCO, no
gatekeeping. Send a patch, an issue, or a sketch on a napkin.