Amass
A minimalistic mobile client for Music Assistant
Stream your entire music library from your Music Assistant server to your mobile device.
Features
Music Assistant Integration
- Server Connection - Connect to your Music Assistant server via WebSocket
- Library Browsing - Browse artists, albums, and tracks from your server
- Album Details - View album information and track listings
- Music Streaming - Stream audio directly from your Music Assistant server
- Auto-Reconnect - Automatic reconnection with connection status monitoring
- Settings Management - Configure server URL with persistent storage
Player Features
- Clean, minimalistic dark UI design
- Full audio playback controls (play/pause/skip/seek)
- Progress bar with time display
- Volume control slider
- Now playing display with track information
- Background audio playback support
- Queue management
Download
Download the latest APK from GitHub Actions - look for the "amass-apk" artifact in successful builds.
Setup
- Launch the app
- Navigate to the Library tab
- Tap Configure Server or go to Settings
- Enter your Music Assistant server URL (e.g.,
music.serverscloud.orgor192.168.1.100) - Tap Connect
- Browse your library and start playing music!
Requirements
- Music Assistant server (v2.7.0 or later recommended)
- Network connectivity to your Music Assistant server
- Android device (Android 5.0+)
About Music Assistant
Amass is a client for Music Assistant, an open-source music library manager and player that integrates with various music sources and streaming providers. You'll need a running Music Assistant server to use this app.
Learn more: music-assistant.io
License
MIT License
For Developers
Build from Source
Prerequisites
- Flutter SDK (>=3.0.0)
- Dart SDK
Build Instructions
- Clone the repository
git clone https://github.com/CollotsSpot/Amass.git
cd Amass
- Install dependencies
flutter pub get
- Generate launcher icons
flutter pub run flutter_launcher_icons
- Build APK
flutter build apk --release
The APK will be available at build/app/outputs/flutter-apk/app-release.apk
Technologies Used
- Flutter - Cross-platform mobile framework
- just_audio - Audio playback
- audio_service - Background audio support
- web_socket_channel - WebSocket communication
- provider - State management
- shared_preferences - Local settings storage