Musynth is an open-source Flutter music player inspired by the Muzio Player app, designed to give you a polished, feature-rich experience for browsing and playing the audio files already stored on your device. This page introduces what Musynth is, the platforms it targets, its current version, and the major capabilities you can explore in the rest of these docs.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/CesarArellano/Music-Player-App/llms.txt
Use this file to discover all available pages before exploring further.
What Is Musynth?
The app’s internal package name ismusynth (Flutter package description: “An awesome music player inspired by Muzio Player App built in Flutter”). It reads your device’s local media library — no streaming service or internet connection required — and presents tracks through a tabbed home screen, a full-screen Now Playing view, and a persistent mini-player. All state is managed with flutter_bloc cubits; routing is handled by go_router; playback runs through just_audio backed by an audio_service foreground handler.
Current stable release: 2.3.4+15Flutter version: 3.44.4 (pinned in
.fvmrc; README notes the project was originally developed against 3.7.11)Dart SDK:
>=3.12.2 <4.0.0
Key Features
Local Library Browsing
Six (Android) or five (iOS) tabs — Songs, Albums, Artists, Playlists (Android only), Favorites, Genres — let you navigate your entire local audio collection. The Songs tab includes an A–Z alphabet fast-scroll rail for instant letter-based navigation.
Background Playback
An
audio_service foreground service keeps music playing when the screen is locked or the app is backgrounded. A rich media notification with transport controls appears in the notification shade and on the lock screen.Dominant-Color Theming
The Now Playing screen extracts the dominant color from the current track’s album artwork natively — using
androidx.palette on Android and Core Image CIAreaAverage on iOS — and applies it as an accent throughout the UI.Swipeable Artwork Carousel
The Now Playing artwork is a
PageView over the live playback queue. Swiping left or right advances to the previous or next track; programmatic track changes keep the carousel in sync automatically.Voice Search
Tap the mic icon in the search screen to speak a song, album, or artist name. Powered by
speech_to_text, the query is matched instantly against the in-memory library.Tag Editor
Edit metadata (title, artist, album, genre) directly on the device for any track. Changes are written back to the file’s ID3 / metadata tags.
Shuffle & Reorderable Queue
Shuffle your library or a specific album/artist/genre, then fine-tune playback order by dragging tracks up and down in the queue screen.
Native Song Deletion
Android users can delete songs from the device via the system confirmation dialog (
MediaStore.createDeleteRequest on Android 11+). Deleted tracks are removed from the live queue and playback advances automatically.Platform Support
- Android
- iOS
Android is the primary target platform. All features are available, including:
- Playlists tab — create, rename, and manage device playlists
- Native song deletion — system-level delete dialog (Android 10+)
- Dominant-color extraction via
androidx.palette - Background playback with a persistent foreground service notification
Architecture Overview
Musynth is structured around a clean separation of data, business logic, and UI:| Layer | Key Packages |
|---|---|
| Playback | just_audio, audio_service |
| State management | flutter_bloc (cubits: LibraryCubit, PlaybackStateCubit, UICubit, AudioControlCubit, FavoritesCubit) |
| Routing | go_router |
| Media queries | music_query_selector (federated plugin — see Installation) |
| Dependency injection | get_it |
| Preferences | shared_preferences |
Where to Go Next
Prerequisites
Flutter SDK, Dart, Android SDK, Xcode, and device permissions you need before building.
Installation
Clone the repo, resolve dependencies, and handle the companion plugin path overrides.
Running the App
Debug and release run commands, permission grants, and background playback verification.
Core Features
Deep-dives into library browsing, the Now Playing screen, queue management, voice search, and more.