A CLI tool that monitors Twitch streamer status changes via polling and sends notifications to Discord Webhooks.
- Real-time monitoring of Twitch streamer status via Helix API polling
- Discord Webhook notifications for:
- Stream online / offline
- Title changes
- Game/category changes
- Multi-streamer and multi-webhook support per streamer
- Interactive CLI menu for configuration management
- Structured logging with slog (colored console + JSON file)
- Go 1.25+
- Twitch Developer Application (dev.twitch.tv)
- Discord Webhook URL(s)
git clone https://github.com/yuu1111/StreamNotifier.git
cd StreamNotifier
make buildCopy the example config and fill in your credentials:
cp config.example.json config.json
{
"twitch": {
"clientId": "your_twitch_client_id",
"clientSecret": "your_twitch_client_secret"
},
"polling": {
"intervalSeconds": 30
},
"streamers": [
{
"username": "streamer_name",
"webhooks": [
{
"name": "Main Notification",
"url": "https://discord.com/api/webhooks/...",
"notifications": {
"online": true,
"offline": true,
"titleChange": true,
"gameChange": true
}
}
]
}
],
"log": {
"level": "info"
}
}./stream-notifier
Or use the interactive CLI:
./stream-notifier helpdocker build -t stream-notifier .
docker run -v ./config.json:/app/config.json:ro -v ./logs:/app/logs stream-notifiermake build # Build for current platform make build-all # Build for Linux, Windows, macOS make clean # Remove build artifacts
cmd/stream-notifier/main.go Entry point
internal/
├── cli/cli.go Interactive menu + subcommands
├── config/config.go Config struct, JSON loader, validation
├── discord/
│ ├── embed.go Discord embed builder
│ └── webhook.go Webhook sender
├── monitor/
│ ├── detector.go State change detection
│ ├── poller.go Periodic polling
│ └── state.go In-memory streamer state
└── twitch/
├── api.go Helix API client
├── auth.go OAuth2 Client Credentials
└── types.go API response types
Data flow: Poller → TwitchAPI → DetectChanges → BuildEmbed → SendWebhook