FLUTTER ECOSYSTEM

namidaco/namida

一個美觀且功能豐富的音樂與影片播放器，支援 YouTube，使用 Flutter 建構

在 GitHub 查看 ↗

Stars: 6420
Forks: 351
最近推送（UTC）: 2026年9月19日
專案狀態: 未封存

GITHUB Organization

Namidaco ↗

Aimed for Beautiful Apps with optimized & performant algorithms

語言DartKotlinC++CMakeShellC

使用的依賴

依賴清單 97 項

flutter{"sdk":"flutter"}
flutter_localizations{"sdk":"flutter"}
nampack{"git":{"url":"https://github.com/MSOB7YY/nampack"}}
dart_extensions{"git":{"url":"https://github.com/MSOB7YY/dart_extensions"}}
path^1.9.0
rhttp^0.18.0
path_provider^2.1.3
permission_handler{"git":{"url":"https://github.com/MSOB7YY/flutter-permission-handler","path":"permission_handler"}}
logger^2.2.0
package_info_plus^10.1.0
device_info_plus^13.1.0
intl^0.20.2
flutter_archive^6.3.1
archive^4.1.0
url_launcher^6.3.0
connectivity_plus^7.0.0
mdns_dart{"git":{"url":"https://github.com/MSOB7YY/mdns_dart"}}
uuid^4.5.3
selectable_autolink_text^2.6.0
share_plus{"git":{"url":"https://github.com/MSOB7YY/plus_plugins","ref":"working_windows","path":"packages/share_plus/share_plus"}}
calendar_date_picker2{"git":{"url":"https://github.com/MSOB7YY/calendar_date_picker2"}}
wakelock_plus^1.6.1
screen_brightness{"git":{"url":"https://github.com/MSOB7YY/screen_brightness","path":"screen_brightness/"}}
native_device_orientation^2.1.1
home_widget^0.9.2
flutter_local_notifications^22.0.0-dev.3
flutter_sharing_intent{"git":{"url":"https://github.com/MSOB7YY/flutter_sharing_intent"}}
queue^3.1.0+2
jiffy{"git":{"url":"https://github.com/MSOB7YY/jiffy"}}
playlist_manager{"git":{"url":"https://github.com/namidaco/playlist_manager"}}
history_manager{"git":{"url":"https://github.com/namidaco/history_manager"}}
flutter_volume_controller^2.0.1
markdown^7.3.1
flutter_mailer^3.0.2
lrc{"git":{"url":"https://github.com/MSOB7YY/dart_lrc"}}
vibration^3.1.6
flutter_udid^4.1.2
namico_db_wrapper{"git":{"url":"https://github.com/namidaco/namico_db_wrapper"}}
flutter_native_splash^2.4.8
opensubsonic_api{"git":{"url":"https://github.com/MSOB7YY/opensubsonic_api.dart"}}
webdav_client{"git":{"url":"https://github.com/MSOB7YY/webdav_client"}}
smb_connect{"git":{"url":"https://github.com/MSOB7YY/smb_connect"}}
just_audio{"git":{"url":"https://github.com/MSOB7YY/just_audio","path":"just_audio/","ref":"video"}}
audio_service{"git":{"url":"https://github.com/MSOB7YY/audio_service","path":"audio_service/","ref":"minor"}}
media_kit^1.2.0
media_kit_video^2.0.1
media_kit_libs_linux^1.2.1
media_kit_libs_macos_video^1.1.4
media_kit_libs_windows_video^1.0.11
http_cache_stream^0.2.0
namida_waveform{"git":{"url":"https://github.com/namidaco/namida_waveform"}}
basic_audio_handler{"git":{"url":"https://github.com/namidaco/basic_audio_handler"}}
flutter_taglib{"git":{"url":"https://github.com/MSOB7YY/flutter_taglib","ref":"custom_taglib"}}
on_audio_query{"git":{"url":"https://github.com/MSOB7YY/on_audio_query","path":"packages/on_audio_query"}}
ffmpeg_kit_flutter{"git":{"url":"https://github.com/MSOB7YY/ffmpeg-kit","path":"flutter/flutter"}}
youtipie{"git":{"url":"https://github.com/namidaco/youtipie"}}
namico_login_manager{"git":{"url":"https://github.com/namidaco/namico_login_manager"}}
namico_subscription_manager{"git":{"url":"https://github.com/namidaco/namico_subscription_manager"}}
palette_generator^0.3.3
photo_view^0.15.0
flutter_staggered_animations^1.1.1
flutter_staggered_grid_view^0.7.0
flex_color_picker^3.8.0
animated_background^2.0.0
flutter_animate^4.2.0+1
dynamic_color^1.6.7
super_sliver_list^0.4.1
flutter_tilt^4.0.0
sleek_circular_slider^2.0.1
checkmark^0.0.2
like_button<=2.0.5
flutter_scrollbar_modified{"git":{"url":"https://github.com/MSOB7YY/flutter_scrollbar_modified"}}
sticky_headers^0.3.0
paged_vertical_calendar^1.1.6
flex_list^1.1.0
window_manager^0.5.0
filepicker_windows^3.0.2
smtc_windows{"git":{"url":"https://github.com/MSOB7YY/frb_plugins","path":"packages/smtc_windows"}}
windows_taskbar^1.1.2
win32_registry^3.0.3
ffi^2.1.0
super_drag_and_drop{"git":{"url":"https://github.com/MSOB7YY/super_native_extensions","path":"super_drag_and_drop"}}
windows_single_instance{"git":{"url":"https://github.com/MSOB7YY/flutter_windows_single_instance"}}
super_hot_key{"git":{"url":"https://github.com/MSOB7YY/super_native_extensions","path":"super_hot_key"}}
tray_manager{"git":{"url":"https://github.com/MSOB7YY/tray_manager","path":"packages/tray_manager"}}
dart_xdg_status_notifier_item{"git":{"url":"https://github.com/MSOB7YY/dart_xdg_status_notifier_item"}}
dbus^0.7.13
file_picker{"git":{"url":"https://github.com/miguelpruivo/flutter_file_picker","ref":"8dc97859f42ca7ca2d6d347dd7960a3c7b657baf"}}
modern_titlebar_buttons^1.1.2
anni_mpris_service^0.1.0
flutter_test開發依賴{"sdk":"flutter"}
yaml開發依賴^3.1.3
yaml_edit開發依賴^2.2.3
flutter_lints開發依賴^6.0.0
flutter_launcher_icons開發依賴^0.14.4
msix開發依賴^3.16.8
inno_bundle開發依賴{"git":{"url":"https://github.com/MSOB7YY/inno_bundle"}}

App 分類

娛樂

所在榜單

Popular#39

原始 README

以下為英文專案原文快照，最新內容請造訪 GitHub。

展開 / 收合專案 README

https://raw.githubusercontent.com/namidaco/namida/HEAD/assets/namida_icon.pngNamida

A Beautiful and Feature-rich Music & Video Player with Youtube Support, Built in Flutter

https://img.shields.io/badge/-Website-%23463e35 https://img.shields.io/badge/-Docs-%23f1d6b6 https://img.shields.io/badge/Channel-blue?link=https%3A%2F%2Ft.me%2Fnamida_officialt&logo=telegram&logoColor=white https://img.shields.io/badge/Chat-blue?link=https%3A%2F%2Ft.me%2F%2BFmdfsgKoGmM1ZGFk&logo=telegram&logoColor=white https://img.shields.io/badge/Discord-7B55C1?link=https%3A%2F%2Fdiscord.gg%2FWeY7DTVChT&logo=discord&logoColor=white https://img.shields.io/github/downloads/namidaco/namida/total.svg https://img.shields.io/badge/Built%20in-Flutter-%23369FE7 Hits-of-Code https://img.shields.io/endpoint?url=https://ghloc.vercel.app/api/namidaco/namida/badge?style=flat&logo=dart&logoColor=aqua&label=Total%20Lines&color=darkturquoise

https://raw.githubusercontent.com/namidaco/namida/HEAD/some%20stuff/badge_github.png https://raw.githubusercontent.com/ImranR98/Obtainium/main/assets/graphics/badge_obtainium.png

Documentation

New to Namida or want to discover more? Checkout the docs here

🎉 Features

Everything you might expect from a music player, in addition to the following:

Library & Indexing

Powerful Indexer & Tag Editor, powered by ~~@jaudiotagger~~ taglib _{since v6.4.0}.
Artists and Genres Separators.
Prevent Duplicated Tracks.
Set Minimum File Size & Duration.
Folders-based Library system, with the ability to exclude folders as well.
Sort by almost any property of the track or the album.. etc.

Look & Feel

Material3-like Theme.
Dynamic Theming, Player Colors are picked from the current album artwork.
Home, Tracks, Albums, Artists, Genres, Playlists, Queues and Folders Pages.
Waveform Seekbar.
Lots of customizations (check out customization section).

Streaming & Youtube

Best Video & Audio Quality
Audio Only & Data Saver Mode
Support Downloads, Caching & Offline Playback
Video View with gestures support (swipe to control volume, double tap to seek, swipe up/pinch in to enter fullscreen, swipe to seek, long press for 1.5x speed, etc)
SponsorBlock & Return Youtube Dislike Integration
Segments and Heatmap for videos
Data Saver Mode
Cache Priority System to keep important stuff
Tags config for downloads
Optional Auto title/artist/album extraction for downloads and scrobbling
Downloads output filename builder (similar to yt-dlp)
Multi Library Support (Local/YT/Subsonic/Jellyfin/WebDAV/SMB)

Available formats & example

Formats:
- video_id, id: video identifier
- video_url, url: video full url (https://www.youtube.com/watch?v=id)
- video_title, fulltitle: video full title
- title: extracted music title from video title (Navjaxx - Fading Light (Slowed))
- artist: extracted music artist from video title (*Navjaxx - Fading Light (Slowed)*) or else channel
- genre: music genre. automatically set to Nightcore when the video title contains "nightcore".
- ext: format container extension (mp4, m4a, webm). this is not necessary as it would be added automatically
- channel_fulltitle: channel full name
- channel, uploader: channel name (excluding - Topic)
- channel_id, uploader_id: channel id
- channel_url, uploader_url: channel url
- timestamp: UNIX timestamp of the video (milliseconds since epoch)
- upload_date: upload date of the video, converted to local time (yyyyMMdd)
- view_count: view count of the video
- like_count: like count of the video
- description: video description. links are wrapped in a markdown style
- duration: video duration in seconds (204)
- duration_string: video duration formatted (3:24)
- playlist_title: title of the playlist containing the video
- playlist_id: id of the playlist containing the video
- playlist: playlist_title if available or else playlist_id
- playlist_count: total videos count in the playlist
- playlist_index: index of the video in the playlists (starts at 0)
- playlist_autonumber: position of the video in the playlists (starts at 1)
- none: empty field. useful for tags to override any other settings
Example:

# [04] music title [(channel name)]
[%(playlist_autonumber)s] %(title)s [(%(channel)s)]

# saving to separate folders
# music playlist/02. music title.m4a
%(playlist)s/%(playlist_autonumber)s. %(title)s.%(ext)s

Others:

Lyrics auto fetching & displaying (Synced & Plain) + Support for Word Synced lrc/ttml.
Sleep Timer (Tracks or Minutes)
Crossfade, Play/Pause Fade Effect, along with Skip Silence.
Replay Gain (Normalize Audio)
Control pausing scenarios (calls, notifications, volume 0, etc..)
Search tracks by title, artist, album, filename, even lyrics and more.
Global Tracks Selection
- allows u to select from multiple places into the same list.
Never miss your sessions!
- persistent and reliable queue system, your sessions are saved for later usage.
Reliable History System
- despite being a flexible system (easily modified, manipulated, imported), it lets u specifiy minimum seconds/percentage to count a listen.
Most Played Playlist
- find out your top tracks based on your history record.
Custom Playlists Order & Ability to set custom artworks
Auto Import Playlists from M3U files & Music Web Servers (Jellyfin, Subsonic/Navidrome, etc)
Left & Right swipe actions for tracks and videos
Artwork Gestures (tap and long press)
Support for cover.jpg etc images for folders, & .info.txt for displaying small info
Sync between devices _new
- sync your history, playlists, favourites, queues, lyrics, caches & more over local network.

Some additional cool features:

Smort Tracks Generation:
- uuh.. with dis advanced algorithm brought for you, u can generate tracks related to one you currently listening to, typically the ones that you often listened to in the same period. based on your history.
- also u can generate tracks released around the same time, or from specific range of time, from ratings, from available moods, or randomly.
Animating Thumbnail:
- A thumbnail that animates with the current audio peak, looks cool.
Miniplayer Party Mode:
- Applies an edge breathing effect, colors can be static or dynamic (all the colors extracted from the artwork)
Particles Effect
- they speed up with the audio peak too
Track Play Mode
- when playing from search, you can selected whether to play: selected track only, search results, album, first artist or first genre.
Insert after latest inserted
- Want to insert multiple tracks one after each other? this will get your back.
Repeat for N times
- in addition to normal repeat modes (all, none, one), this one lets you repeat the track for number of times before playing the next track.
Extract feat. & ft. artist
- u won't miss the featured artists in the title, they'll have their own entry inside artists tab.
Dive into your memories
- Find out ur long partners u forgot about, "lost memories" allows u to meet tracks you listened to around this time, but n years ago
- The "Most Played" page also allows you to specify time range, showing ur most beloved tracks at that time
- The "Recommended" tracks addition in queue lets you add tracks you usually listened to with the current one
- The "Similar Release Date" tracks addition in queue lets you add tracks released around the same time as the current one
CAN IMPORT YOUTUBE HISTORY https://raw.githubusercontent.com/namidaco/namida/HEAD/some%20stuff/ong.png
LASTFM, SPOTIFY & LISTENBRAINZ TOO AND MAYBE MORE IN FUTURE https://raw.githubusercontent.com/namidaco/namida/HEAD/some%20stuff/yoowhat.gif
you gonna find decent amount of options/customizations in the settings and inside dialogs so make sure to check them out.

Video Integration

For Local Library, Namida is capable of playing videos related to the music, Video can be found either locally or fetched from youtube

How locally?

typically looks (inside the folders you specificed) for any matching title, matching goes as following:
-- Alan walker - Faded.m4a
-- video alAn WaLkER - faDed (480p).mp4
the video filename should contain at least one of the following:
1. the music filename as shown above.
2. title & first artist of the track.
3. track youtube id (in track comment tag/filename, see "#How youtube?" section below).
note: some cleanup is made to improve the matching, all symbols & whitespaces are ignored.

How youtube?

looks up in the track comment tag (as they are mostly done by @yt-dlp) or filename for any matching youtube link, if found then it starts downloading (and caches) and plays once it's ready, streaming here isn't a good idea as the priority goes for the music file itself.
- for comment tag, any url format should get matched normally (example: https://youtu.be/video_id).
- for filenames, it should contain v=video_id or id=video_id in order to get matched.

Since v4.0.0, full video library indexing & playback is supported, videos can now be played independently, as well as dedicated videos folder view.

Screenshots

https://raw.githubusercontent.com/namidaco/namida/HEAD/screens/collection_light_1.jpg https://raw.githubusercontent.com/namidaco/namida/HEAD/screens/collection_light_2.jpg https://raw.githubusercontent.com/namidaco/namida/HEAD/screens/collection_dark_1.jpg https://raw.githubusercontent.com/namidaco/namida/HEAD/screens/collection_dark_2.jpg

Customization Settings

https://raw.githubusercontent.com/namidaco/namida/HEAD/screens/customization_settings.jpg

YouTube Miniplayer

https://raw.githubusercontent.com/namidaco/namida/HEAD/screens/yt_miniplayer.png

Usage Preview

Animating Thumbnail	Recommends & Listens

Installation

Platform	Stable	Beta
Android	https://raw.githubusercontent.com/namidaco/namida/HEAD/some%20stuff/badge_github.png https://raw.githubusercontent.com/ImranR98/Obtainium/main/assets/graphics/badge_obtainium.png	https://raw.githubusercontent.com/namidaco/namida/HEAD/some%20stuff/badge_github.png https://raw.githubusercontent.com/ImranR98/Obtainium/main/assets/graphics/badge_obtainium.png
Windows	https://raw.githubusercontent.com/namidaco/namida/HEAD/some%20stuff/badge_github.png	https://raw.githubusercontent.com/namidaco/namida/HEAD/some%20stuff/badge_github.png
Linux _new	Soon	https://raw.githubusercontent.com/namidaco/namida/HEAD/some%20stuff/badge_github.png _{Installation steps ↓}

Linux Installation

Install Dependencies

[!IMPORTANT] Install dependencies: mpv for playback (you may skip this if you used a package manager)
sudo pacman -S mpv            # Arch/Manjaro
sudo apt install mpv libmpv2  # Debian/Ubuntu/Mint
sudo dnf install mpv mpv-libs # Fedora/RHEL

[!NOTE] (Optional) Install webkit2gtk for youtube login & poToken

sudo pacman -S webkit2gtk-4.1          # Arch/Manjaro
sudo apt install libwebkit2gtk-4.1-0   # Debian/Ubuntu/Mint
sudo dnf install webkit2gtk4.1         # Fedora/RHEL

Install Namida

# Quick Install
curl -fsSL https://raw.githubusercontent.com/namidaco/namida/main/scripts/install_linux_tar.sh | sudo bash

# Package managers
yay -Sy namida-bin                  # AUR (Arch Linux)
paru -Sy namida-bin                 # AUR (Arch Linux)
sudo apt install ./namida.deb   # Debian/Ubuntu (download .deb from beta releases)
sudo dnf install ./namida.rpm   # Fedora/RHEL (download .rpm from beta releases)

# Nix (Home Manager) Installation
# Available at: https://codeberg.org/iWisp360/namida-nix

Companion Apps:

[!TIP] Community-built tools for an enhanced namida experience

🔄 Namida Sync, a tool for syncing namida backups & files across android, windows and linux

by @010101-sans

📊 Namida Charts, a companion app that shows yearly, monthly & more listening stats with charts based on namida history

by @DiWu17

🎁 Namida Wrapped, a local web ui for generating spotify wrapped-style stats

by @bebrriko

Permission Note:

The permissions namida uses and why:

WAKE_LOCK & FOREGROUND_SERVICE & FOREGROUND_SERVICE_MEDIA_PLAYBACK: keep app alive for media playback.

INTERNET: for many stuff like artist/album images, streaming & downloading, etc.

READ_EXTERNAL_STORAGE (Android ≤ 12): list files from indexer folders only.

READ_MEDIA_AUDIO (Android 13+): list audio files from indexer folders only.

READ_MEDIA_VIDEO (Android 13+): list video files from indexer folders only (for video playback).

READ_MEDIA_IMAGES (Android 13+): list image files from indexer folders only (for fallback covers).

WRITE_EXTERNAL_STORAGE (Android ≤ 10): same as below but less restrict.

MANAGE_EXTERNAL_STORAGE or all_files_access (Android 10+ / requested when needed): used for

editing audio tags

creating or auto-restoring backups

saving artworks

deleting files

compressing images & fix ytdlp images

exporting playlists as m3u

downloading youtube content

playing tracks from a root folder

in-app file browser

VIBRATE: vibrate/haptic feedback while doing some actions (can be turned off in settings).

POST_NOTIFICATIONS (requested when needed): post notifications like history import/download progress.

REQUEST_IGNORE_BATTERY_OPTIMIZATIONS (requested when needed): improve downloads.

WRITE_SETTINGS (requested when needed): to set audio as ringtone/etc.

QUERY_ALL_PACKAGES: to allow opening custom equalizer apps.

Special Thanks:

@MSOB7YY for their youtube client, which powers youtube section.

@cameralis for their awesome miniplayer physics.

@alexmercerind for helping me out a lot.

@lusaxweb for their awesome Iconsax icon pack.

All packages' maintainers which made namida possible.

Translate

You can help translating Namida to your language on Translation Repo

Contribute

Building is not currently directly possible, see why on https://github.com/namidaco/namida/issues/37#issuecomment-1780341883

Donate

Donation will help improve namida and will show appreciation.

Buy Me A Coffee Ko-fi

Bitcoin/ETH/USDT (BEP20): 0x95b2834c84def92860df773d8b3d80d4c296d748

Don't forget to 🌟 star the repo if you like the project ^^

Social

join us on our platforms for updates, tips, discussion & ideas

[!WARNING] Namida is only available through namida.app, GitHub & Telegram. We are not responsible for downloads from other sources.

LICENSE

Project is licensed under EULA License.

© Copyright (C) 2023-present Namidaco <namida.coo@gmail.com>
- You may read/compile/modify the code for your personal usage, or for the purpose of contribution for the software.
- Redistributing the program as a whole under different name or license without permission is not allowed.

namidaco%2Fnamida | Trendshift

https://raw.githubusercontent.com/namidaco/namida/HEAD/some%20stuff/star_history.svg

Made by human, not vibe coded. AI usage is minimal and very selective. Every design choice comes after thoughtful decisions and series of refining, down to every pixel. Parts that are built by ai will have a disclaimer. See here for more info.

Namidaco ↗

技術主題

相關套件與範例

flutter_lints

path_provider

url_launcher

flutter_staggered_grid_view

flutter_local_notifications

permission_handler

flutter_launcher_icons

photo_view

connectivity_plus

device_info_plus

package_info_plus

share_plus