MeloTrip

English | 简体中文

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

Overview

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.

Highlights

• 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

Platform Status

Platform	Status
Android	Supported
iOS	Supported
Windows	Supported
macOS	Supported
Linux	Supported
Web	Not targeted currently

Tech Stack

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

Getting Started

Requirements

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

Setup

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

Common Development Commands

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

Localization

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