streamiau
Streamiau!
Stream tools for streamers, built to integrate with StreamElements via simple HTTP/WebSocket endpoints.
Streamiau is a Crystal web application powered by Kemal. It provides authenticated dashboards and public API commands for counters, phrases, Steam playtime, and YouTube latest video/short.
Features
- Counters — create and manage counters, update them from the dashboard or API, and consume live updates over WebSocket (
/api/v1/counter/:username/:uuid/ws). - Phrases — manage phrase categories and fetch random/command-driven phrases through the API.
- Steam integration — query playtime for a Steam app. Requires a Steam Web API key.
- YouTube integration — fetch the latest channel video or short. Uses
yt-dlpin the production container. - Authentication & sessions — login/session-based access to dashboards, with CSRF protection for state-changing routes.
- User/admin management — role-based access, per-user API tokens, and admin routes for user administration.
- MongoDB storage — persistent data via Moongoon.
Requirements
Installation
git clone https://github.com/joseafga/streamiau.git
cd streamiau
cp .env.example .env
Configure your .env.
make release
make run
This will run the main application. If you also want the frontend, you will need to install joseafga/streamiau-astro in a directory alongside streamiau.
Container
Build and run a container image (using Podman):
make container
The container listens on port 3000 and expects environment variables from .env (--env-file .env).
The production image includes runtime dependencies such as yt-dlp, which is used by YouTube-related features.
API overview
WS /api/v1/counter/:username/:uuid/ws— live counter updatesGET /api/v1/counter/:username/:uuid— counter command/queryGET /api/v1/phrases/:username/:category— phrase command/queryGET /api/v1/youtube/:username/videos/last— latest channel videoGET /api/v1/youtube/:username/shorts/last— latest channel shortGET /api/v1/steam/:username/:appid/hours— Steam playtime
See src/streamiau/routes.cr for the current route definitions and behavior.
Contributing
- Fork it (https://github.com/joseafga/streamiau/fork)
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
Contributors
- José Almeida - creator and maintainer
streamiau
- 0
- 0
- 0
- 0
- 6
- 11 days ago
- June 18, 2025
MIT License
Mon, 09 Nov 2026 00:10:58 GMT