English | 简体中文

A Flutter client for Navidrome and Subsonic servers, designed for both mobile listening and desktop library management.

MeloTrip is a cross-platform music client built with Flutter for self-hosted music ecosystems based on Navidrome and the Subsonic API. The project focuses on a clean playback flow, responsive search, playlist and favorites management, lyrics support, and a desktop experience that feels native rather than stretched from mobile.

• Cross-platform support for Android, iOS, Windows, macOS, and Linux
• Dedicated mobile and desktop layouts
• Playback powered by media_kit and audio_service
• Search, albums, artists, songs, playlists, and favorites
• Desktop lyrics support
• Built-in localization with English and Simplified Chinese

• Flutter
• Riverpod
• Dio
• Freezed + json_serializable
• media_kit
• audio_service
• sqflite

• Flutter 3.x
• Dart SDK compatible with the version declared in pubspec.yaml
• A reachable Navidrome or Subsonic-compatible server

flutter pub get
flutter gen-l10n
dart run build_runner build --delete-conflicting-outputs
flutter run

dart run build_runner watch
flutter gen-l10n
dart run flutter_native_splash:create
flutter analyze
flutter test

User-facing copy is managed through Flutter l10n resources. English and Simplified Chinese are currently included.