Welcome
Namida is a beautiful and feature-rich music & video player with YouTube support, built in Flutter. Available on Android, Windows and Linux.
New here? Follow the Quickstart below or check Features to see what Namida can do. Looking for a specific option? Everything is explained in Settings. Stuck on something? Check the FAQ. Just updated? See What’s New.
Search these docs with Ctrl/⌘ + K, or ask the AI assistant using the button below.
They are inside Namida too (even offline), look for the guide icon at the top of a page. 🆕 v8.2.0
Quickstart
- Install Namida.
📒 Installation Guide ↗ - On first launch, add the folders holding your music, Namida only scans the folders you choose. Moving from another device? Restore a backup or sync from it right there instead of starting fresh.
📒 Sync Guide ↗ - Press the arrow to finish, Namida scans the folders and builds your library. Pull down on the Tracks page to refresh whenever you add new music.
⚙️ Configure Indexer ↗ - Tap a track to play it. The miniplayer appears at the bottom, swipe up to expand it, and long press any track for options.
🎉 Playback feature ↗ - For YouTube, open the YouTube tab, or use the Search to find videos. Sign in to get your playlists, subscriptions and more.
🎉 YouTube feature ↗
Then browse Features to see everything else, and Tips & Tricks for what is not obvious.
Philosophy
Preservation. Your data and your music outlive everything else:
- Streamed content is cached and playable offline, nothing is fetched twice for no reason.
- The cache priority system protects what matters when cleaning up, and VIP items are never auto deleted. Private and deleted YouTube videos become VIP automatically.
- Sync between devices only adds, it never wipes the other device’s data.
- Listens can’t be deleted, only replaced, your history stays truthful.
- Every queue is saved automatically and stays forever, the only way to remove one is to delete it yourself.
📄 Queues Page ↗ - The Refresh on Startup scan skips deletions, files that are no longer reachable don’t get removed from your library suddenly.
⚙️ Configure Refresh on Startup ↗ - Destructive actions like deleting files sit behind the advanced dialog, and deleted paths are saved to a file in the app data folder.
The original experience is cherished. Content is presented the way it was made:
- Video integration for local music, the song comes with its video, not just a static artwork.
- The progress bar in the YouTube player sits under the video, not inside it, nothing covers the content.
- There is no way to stretch or zoom the video out of its real aspect ratio.
Music should feel alive. Not just a static artwork and a progress bar:
- Thumbnails animate with the beat.
⚙️ Configure Thumbnail Animation ↗ - The seekbar is the actual waveform of the track.
🎉 Waveform Seekbar ↗ - Local tracks can play with their linked videos.
🎉 Video Integration ↗ - Short loop animations (or animated artworks) that play along with the track.
📒 Loop Animation Guide ↗ - Visualizers and effects that move with the music.
🆕 v7.8.0🎉 Effects & Visualizers ↗
Music should be listened to only when you feel like it. Namida is against endless queues.
Music is a powerful tool that can hijack your brain and take control, and a human should always be in control. So much human potential gets thrown away to entertainment, and music is part of that. Don’t let it consume you, listen to what you enjoy, and only when you really want to.
Get Namida
Not sure which file to download? See 📒 Installation Guide ↗ for every platform.
Community
Namida is only available through namida.app, GitHub & Telegram.
We are not responsible for downloads from other sources.
AI Usage
Namida is 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 built with AI have a disclaimer, see here for more info.
Author: @MSOB7YY
Writer: @claude
