About this project

Sylvakru (森露), formerly Particle Music, is a cross-platform music player built with Flutter. It targets local music libraries as well as self-hosted media services, and runs on Android, iOS, Windows, Linux and macOS. An iOS build is noted as available on the Apple App Store. Supported sources listed in the README: - Local files - WebDAV - Navidrome - Emby - Feiniu Music (contributed by a community member) Format support covers a broad range of audio containers and tag schemes: AAC (ADTS), Ape, AIFF, FLAC, MP3, MP4, MPC, Opus, Ogg Vorbis, Speex, WAV and WavPack. Metadata handling includes ID3v2, ID3v1, APE, Vorbis Comments, iTunes-style ilst, RIFF INFO and text chunks. Some tag combinations are read-only where official support is lacking, as noted in the project's table. Audio processing relies on two components: audio_tags_lofty for reading and writing audio tags (based on lofty), and media_kit for playback (based on mpv/FFmpeg). A separate community fork adds USB Exclusive Mode on Android, maintained by a contributor; the README points users to that fork if they need the feature. Building requires a Flutter installation. Platform-specific setup is documented for Ubuntu/Debian (clang, lld, cmake, ninja-build, pkg-config, GTK3 dev libraries, liblzma-dev, libsecret-1-dev, libmpv-dev), Windows (Visual Studio), macOS/iOS (Xcode, CocoaPods), and Android (Android Studio and SDK command-line tools). Commands are given for debug and release runs, plus builds for Linux (including optional .deb and .rpm packaging scripts), Windows, macOS, iOS (unsigned IPA), and Android (APK, split-per-ABI, and a TV build flag). The repository includes screenshots for mobile (iPhone and iPad) and desktop layouts, indicating a responsive interface across form factors.