Sylvakru (森露)

“A private music oasis in the digital world.”

Sylvakru is a cross-platform music player for local libraries and self-hosted media services, supporting Android, iOS, Windows, Linux, and macOS.

Currently supports:

• Local music libraries
• WebDAV
• Navidrome
• Emby

Formerly known as Particle Music.

Important

The iOS version is now available on the Apple App Store!

USB Exclusive Mode(Android)

Special thanks to huya688zdx for making USB Exclusive Mode possible.

If you need USB Exclusive Mode, download the dedicated build from the usb-exclusive-beta.

Supported Formats

File Format	Metadata Format(s)
AAC (ADTS)	ID3v2, ID3v1
Ape	APE, ID3v2*, ID3v1
AIFF	ID3v2, Text Chunks
FLAC	Vorbis Comments, ID3v2*
MP3	ID3v2, ID3v1, APE
MP4	iTunes-style ilst
MPC	APE, ID3v2*, ID3v1*
Opus	Vorbis Comments
Ogg Vorbis	Vorbis Comments
Speex	Vorbis Comments
WAV	ID3v2, RIFF INFO
WavPack	APE, ID3v1

* The tag will be read only, due to lack of official support

Audio Processing

• audio_tags_lofty — for reading and writing audio tags (based on lofty)
• media_kit — for audio playback (based on mpv/FFmpeg)

Run & Build

Install Flutter by following the official Flutter installation guide.

Ubuntu/Debian

# Flutter dependencies:
sudo apt install clang lld cmake ninja-build pkg-config libgtk-3-dev liblzma-dev libsecret-1-dev

# audio lib
sudo apt install libmpv-dev

git clone https://github.com/AfalpHy/sylvakru.git
cd sylvakru
# check the development environment
flutter doctor -v
# run in debug mode
flutter run
# run in release mode
flutter run --release
# build
flutter build linux
# if you want to generate a .deb package
flutter build linux && ./generate_deb.sh

# if you want to generate a .rpm package
sudo apt install rpm
flutter build linux && ./generate_rpm.sh

Windows

Install Visual Studio.

git clone https://github.com/AfalpHy/sylvakru.git
cd sylvakru
# check the development environment
flutter doctor -v
# run in debug mode
flutter run
# run in release mode
flutter run --release
# build
flutter build windows

macOS & iOS

Install Xcode and the Xcode Command Line Tools by following the official Apple Developer download page.

git clone https://github.com/AfalpHy/sylvakru.git
cd sylvakru

# install CocoaPods
brew install cocoapods

# check the development environment
flutter doctor -v
# run in debug mode
flutter run
# run in release mode
flutter run --release
# build
flutter build macos

# build an unsigned ipa
flutter build ios --release --no-codesign && \
mkdir -p Payload && \
cp -r build/ios/iphoneos/Runner.app Payload/ && \
zip -r sylvakru.ipa Payload && \
rm -rf Payload

Android

Install Android Studio and Android SDK Command-line Tools

git clone https://github.com/AfalpHy/sylvakru.git
cd sylvakru
# accept the SDK licenses
flutter doctor --android-licenses
# check the development environment
flutter doctor -v
# run in debug mode
flutter run
# run in release mode
flutter run --release
# build
flutter build apk
# split abi
flutter build apk --split-per-abi
# build TV
flutter build apk --dart-define=TV=true

Screenshots

On iOS

On Windows