Closed Alpha
FluxPlay is currently in Closed Alpha. This documentation is a work in progress and may be incomplete or out of date. Features, UI, and APIs are subject to change without notice. For access inquiries, please contact [email protected].
NOTIFICATIONS
Stay informed with flexible notification delivery across multiple channels. Route different event types to different destinations and let users manage their own preferences.
Multi-Channel Delivery
A single notification event can be delivered simultaneously to in-app, email, Discord, and Gotify. Each user configures their own delivery preferences independently of the admin's global channel setup.
Channels
In-App Notifications
A notification center in the top bar shows all recent events. Unread count badge updates in real time via WebSocket.
Email Delivery
Configure SMTP or a transactional provider (SendGrid, Mailgun, Postmark) to deliver notifications via email.
Discord Integration
Post notifications to a Discord channel via webhook. Supports rich embeds with media thumbnails.
Gotify Support
Send push notifications to any Gotify server for self-hosted mobile push delivery.
Category Controls
Users choose which notification categories they receive on each channel: media, system, security, social, etc.
Retention Settings
Configure how long read and unread notifications are retained before automatic cleanup.
Email Configuration
Email is configured under Admin → Server Settings → Email. You can use any SMTP server or a transactional provider. Test delivery is available directly from the settings panel before saving.
Required settings
- →SMTP host, port, TLS mode (None / STARTTLS / SSL)
- →Username and password (stored encrypted)
- →From address and display name
- →Optional: reply-to address override
Category Filtering
Notification categories allow users to opt in or out of specific event types per channel. For example, a user might enable media-added notifications via email but disable them in-app to reduce noise.
Media
New content added, download complete, metadata updated
System
Server updates, scheduled task results, health alerts
Security
New logins, failed auth, MFA changes
Social
Share link viewed, media request fulfilled, playlist invite
Retention Settings
Admins configure global notification retention under Admin → Server Settings → Notifications. Individual users can set shorter retention periods but not longer ones. A scheduled cleanup job runs nightly to remove expired notifications. Unread notifications are retained for the full retention period regardless of age.