GitHub 저장소ShokhrukhbekYuldoshev/Meloplay

Meloplay

Flutter로 구현한 세련된 로컬 음악 플레이어 (안드로이드용)

GitHub에서 보기 ↗

스타: 79
포크: 28
최근 푸시(UTC): 2026. 5. 25.
프로젝트 상태: 활성

원본 README

아래는 영문 원문 스냅샷입니다. 최신 내용은 GitHub에서 확인하세요.

Meloplay

Meloplay is a local music player app that plays music from your device built with Flutter.

Platforms

Android only

Features

[x] Play music from your device
[x] Background audio
[x] Notification controls
[x] Lock screen controls
[x] Play, pause, skip, previous, seek
[x] Shuffle and repeat
[x] Search for music, artists, albums, genres
[x] Sort by (title, artist, album, duration, date, size, etc)
[x] Order by (ascending, descending)
[x] Playlists (Read, create, rename, delete, add songs, remove songs)
[x] Queue (List, add songs, remove songs, change order)
[x] Favorites (Add songs, remove songs)
[x] Recently played
[ ] Most played
[x] Artists
[x] Albums
[x] Genres
[ ] Lyrics
[ ] Equalizer
[x] Sleep timer
[x] Share music
[x] Settings
[x] Themes (multiple themes)
[ ] Localization

Screenshots

Songs	Player	Playlists

Artists	Albums	Genres

Settings	Scan	Themes

Dependencies

Name	Description
auto_size_text	Flutter widget that automatically resizes text to fit perfectly within its bounds.
bloc	A predictable state management library.
flutter_bloc	Flutter widgets that make it easy to implement BLoC design patterns.
flutter_cache_manager	A Flutter plugin for caching images and other resources.
flutter_staggered_animations	A plugin for adding staggered animations to your Flutter apps.
flutter_svg	Flutter plugin for displaying SVG images.
fluttertoast	Flutter plugin for displaying toast messages.
get_it	Simple Service Locator for dependency injection.
hive	A lightweight and blazing fast key-value database.
hive_flutter	Hive database implementation for Flutter.
just_audio	A feature-rich audio player for Flutter.
just_audio_background	Plugin for playing audio in the background on Android and iOS.
lottie	Library for rendering JSON-based Lottie animations natively.
marquee	A Flutter widget that scrolls text infinitely.
on_audio_query	A Flutter plugin to query songs on Android and iOS.
package_info_plus	Plugin for querying information about the application package.
permission_handler	Cross-platform permission handling plugin.
share_plus	Plugin for sharing content via the platform share UI.
url_launcher	Plugin for launching URLs on mobile platforms.
liquid_glass_renderer	A Flutter plugin for rendering liquid glass effects.
device_info_plus	Plugin for getting device information.

Installation

Prerequisites

Flutter
Android Studio / Xcode

Setup

Clone the repo
```
git clone
```
Install dependencies
```
dart pub get
```
Run the app
```
flutter run
```

Permissions

Inside AndroidManifest.xml we have the following permissions:

<!-- ADD xmlns:tools="http://schemas.android.com/tools" to the "manifest" element -->
<manifest xmlns:tools="http://schemas.android.com/tools" ...>
    <!-- url_launcher -->
    <queries>
        <intent>
            <action android:name="android.intent.action.VIEW" />
            <data android:scheme="https" />
        </intent>
    </queries>

    <!-- Android 12 and below -->
    <uses-permission
        android:name="android.permission.READ_EXTERNAL_STORAGE"
        android:maxSdkVersion="32" />

    <!-- Android 13+ -->
    <uses-permission
        android:name="android.permission.READ_MEDIA_AUDIO" />

    <!-- ADD THESE TWO PERMISSIONS -->
    <uses-permission android:name="android.permission.WAKE_LOCK"/>
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
    <!-- ALSO ADD THIS PERMISSION IF TARGETING SDK 34 -->
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK"/>

    <application ...>

    ...

    <!-- EDIT THE android:name ATTRIBUTE IN YOUR EXISTING "ACTIVITY" ELEMENT -->
    <activity android:name="com.ryanheise.audioservice.AudioServiceActivity" ...>
      ...
    </activity>

    <!-- ADD THIS "SERVICE" element -->
    <service android:name="com.ryanheise.audioservice.AudioService"
        android:foregroundServiceType="mediaPlayback"
        android:exported="true" tools:ignore="Instantiatable">
      <intent-filter>
        <action android:name="android.media.browse.MediaBrowserService" />
      </intent-filter>
    </service>

    <!-- ADD THIS "RECEIVER" element -->
    <receiver android:name="com.ryanheise.audioservice.MediaButtonReceiver"
        android:exported="true" tools:ignore="Instantiatable">
      <intent-filter>
        <action android:name="android.intent.action.MEDIA_BUTTON" />
      </intent-filter>
    </receiver>
  </application>
</manifest>