⚠️ BETA RELEASE - Universal Authentication
This is a BETA release. The app is still in active development and testing. Not recommended for production use.
This major update introduces universal authentication support, making the app compatible with most Music Assistant deployments!
✨ Major Features
- Universal Authentication System - Auto-detects and supports multiple auth types
- Auto-Detection - Automatically determines server authentication requirements
- Separate Auth Server - Support for split Authelia deployments (auth on different domain)
- Full Endpoint Authentication - WebSocket, streaming, and API all properly authenticated
- Debug Console - Built-in troubleshooting tool for auth issues
✅ Tested Scenarios
| Deployment Type | Status | Notes |
|---|---|---|
| Local IP (no auth) | ✅ TESTED | Works with bare Music Assistant servers |
| Basic Auth | ✅ TESTED | Compatible with nginx/Apache basic auth |
| Authelia | ✅ TESTED | Full support including separate auth domains |
| Home Assistant Add-on | ⚠️ NOT TESTED | Implementation exists but untested |
⚠️ Known Limitations & Issues
- Home Assistant Add-on - Not yet tested, may not work
- OAuth/Bearer tokens - Not yet implemented
- Background playback - May stop when app is minimized (device-dependent)
- Lock screen controls - Basic implementation only
- Queue management - Limited functionality
- Album art caching - May reload frequently
- Stability - May have crashes or unexpected behavior
🔧 Technical Highlights
- Strategy Pattern - Clean, pluggable architecture for auth methods
- AuthManager - Centralized authentication coordination
- Persistent Storage - Credentials saved securely across sessions
- Real-time Validation - Auth credentials tested before connection
📱 How to Use
- Enter your Music Assistant server URL
- Click "Detect & Connect"
- App auto-detects authentication requirements
- Enter credentials if needed (or skip if no auth)
- Connect and enjoy!
🎵 What Works
- ✅ Library browsing
- ✅ Music playback with authenticated streams
- ✅ WebSocket real-time updates
- ✅ All endpoints properly authenticated
- ✅ Works without Traefik bypasses
- ✅ Local playback on Android devices
🐛 Reporting Issues
This is BETA software. Please help improve it by reporting issues on GitHub:
Include in your report:
- Your Music Assistant deployment type (Docker, HA add-on, etc.)
- Authentication method (no auth, basic auth, Authelia, etc.)
- Android version and device model
- Debug console logs (available on login screen)
- Steps to reproduce the issue
📝 Breaking Changes
None - fully backward compatible with existing setups.
⚠️ BETA SOFTWARE
This app is in active development. Features may be incomplete, buggy, or change without notice.
Not recommended for production use yet.
APK will be available in workflow artifacts after the build completes.