epyx/streamdesk repository overview

⁠🔐 StreamDesk

A browser-based Twitch chat and moderation tool. StreamDesk securely connects to your Twitch account via OAuth, shows chat from multiple channels at once in tabs, and gives moderators direct access to timeouts, bans, message deletion, polls, predictions, and detailed user info.

📖 Full documentation, source code & issues: github.com/Epyxx/StreamDesk⁠

⁠Quick Start

docker run -d \
  --name streamdesk \
  --restart unless-stopped \
  -p 3000:3000 \
  -e TWITCH_CLIENT_ID=your_client_id \
  -e TWITCH_CLIENT_SECRET=your_client_secret \
  -e TWITCH_REDIRECT_URI=http://localhost:3000/callback \
  epyx/streamdesk:latest

Then open http://localhost:3000 (or your own domain) in a browser and log in via "Log in with Twitch".

⁠Docker Compose

services:
  streamdesk:
    image: epyx/streamdesk:latest
    container_name: streamdesk
    restart: unless-stopped
    ports:
      - "3000:3000"
    env_file:
      - .env

⁠Environment Variables

You can register a Twitch application for free at dev.twitch.tv/console/apps⁠ – details in the README on GitHub⁠.

⁠Tags

• latest – always the current state of main
• X.Y.Z, X.Y – versioned releases (Git tag vX.Y.Z)

Multi-arch image for linux/amd64 and linux/arm64.

⁠Notes

• The container is stateless: chat/event history lives in the browser's localStorage, so no volume is needed for persistent data.
• When running behind a reverse proxy (e.g. under a subdirectory), both regular HTTP requests and WebSocket upgrades need to be forwarded. See the GitHub documentation⁠ for concrete Apache/nginx examples.

⁠Security Notes

• Login runs exclusively through the official Twitch OAuth flow – credentials are never entered or stored manually.
• Never bake TWITCH_CLIENT_SECRET into an image – always pass it as an environment variable at runtime (see examples above).

⁠License

MIT⁠

Built by Epyx⁠ · Source: github.com/Epyxx/StreamDesk⁠