Namida

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

Namida is more than just a media player. It’s a thoughtfully crafted, feature-rich music and video player built with Flutter, designed to handle local libraries, online streams, and YouTube content with grace. From a polished look inspired by Material3 to a powerful indexing engine, Namida aims to give you control, flexibility, and a delightful listening/viewing experience all in one place. This detailed description brings together the core features, design choices, and usage tips that define Namida, and it highlights what makes it stand out in the landscape of modern media players.

Sections

• Features
• Library & Indexing
• Look & Feel
• Streaming & Youtube
• Video Integration
• Screenshots
• Usage Preview
• Installation
• Companion Apps
• Permission Note
• Special Thanks
• Translate
• Contribute
• Donate
• Social
• License

Features

Namida ships with everything you would expect from a robust media player and then some. Its feature set is broad, carefully organized, and designed to scale with your needs.

• Rich library management:
• A powerful indexer and tag editor powered by jaudiotagger.
• Clear separation of artists and genres for precise organization.
• Duplicate track prevention so your library stays clean.
• Options to set minimum file size and duration to filter out noise.
• A folders-based library system with exclusions to tailor what you index.
• Comprehensive sorting by nearly any track or album property, including custom views and playlists.
• Look and feel:
• A Material 3-inspired theme that looks and feels modern on every device.
• Dynamic theming: the app’s accent colors draw from the current album artwork.
• Dedicated pages for Home, Tracks, Albums, Artists, Genres, Playlists, Queues, and Folders.
• A waveform seekbar that provides a visual rhythm of the current playback.
• Extensive customization options to tailor the app to your preferences.
• Streaming and YouTube:
• High-quality audio and video streaming with support for downloads, caching, and offline playback.
• Audio-only mode for data savings, without sacrificing convenience.
• Video view with gestures: swipe to adjust volume, double-tap to seek, pinch to enter fullscreen, and more.
• SponsorBlock and Return Youtube Dislike integration for ad-aware and user-friendly navigation.
• Video segments and heatmap visualization for better understanding of long content.
• Tags config for downloads and an auto title/artist/album extraction to simplify tagging and scrobbling.
• A downloads output filename builder that mimics yt-dlp’s naming conventions for easy organization.
• Multi-library support (Local, YouTube, Subsonic, WebDAV) for diverse sources.
• A robust set of audio/video tag fields: video_id, url, title, artist, channel, duration, description, and many more with logical defaults and optional overrides.
• Transfer-friendly formats and flexible indexing to ensure your music and videos stay well organized even as you grow your library.
• Video integration:
• Local video playback linked to your music collection: Namida can match video files with your tracks using multiple strategies (filename-based matches, title and artist matching, or a YouTube link embedded in tags or filenames).
• YouTube matching via track comments or filenames (v=videoid or id=videoid) so you can watch the official video alongside the audio track.
• A full video library is supported starting with v4.0.0, letting videos be played independently or together with their music counterparts.
• Other notable features:
• Lyrics auto-fetching and display (synced or plain) with support for Word Sync LRC/TTML.
• Sleep timer by track or by minutes.
• Crossfade, play/pause fade, and skip-silence features for smooth transitions.
• Replay Gain / Normalization to keep playback consistent.
• Smart handling of pausing situations (calls, notifications, etc.).
• Global track selection across multiple sources, so you can curate complex playlists from different locations.
• A persistent queue system that saves your session state for later restoration.
• A robust history system with configurable minimum listening thresholds.
• A “Most Played” playlist that highlights your favorites over time, plus a “Similar Release Date” feature to discover tracks released around the same time.
• “Insert after latest” and “Repeat for N times” features for flexible playback planning.
• A dedicated “Similar Release Date” feature to explore tracks from comparable periods.
• Feature-rich export/import options, playlist management, and artwork handling for folders (cover.jpg and .info.txt support).
• YouTube history import and Last.fm integration (with more to come) to enrich your listening story.
• Customization and experimentation:
• A blend of “Smort Tracks Generation” and mood/era-based recommendations to expand your listening without losing the thread of what you enjoy.
• Animated thumbnails that react to audio peaks, bringing a dynamic visual element to the listening experience.
• Miniplayer Party Mode with edge breathing effects and dynamic color extraction from artwork.
• Particles that pulse with the music, enhancing the mood without distraction.
• A suite of playback modes and nuanced controls for searching, playing, and queuing.

Library & Indexing

Namida’s library system is designed to be comprehensive yet approachable. The indexer works in tandem with the tag editor to maintain a clean, well-organized collection of tracks and albums.

• The indexer:
• Creates a searchable, filterable catalog of your media.
• Works with multiple metadata fields to ensure precise results.
• Tag editing:
• Integrated tools allow you to fix titles, artists, albums, and other metadata on the fly.
• Export and import of tags enable easy sharing of curated metadata across devices.
• Organization:
• Separate sections for artists and genres help you explore your collection naturally.
• Folders can be indexed while excluding others, giving you granular control.
• Duplicates and quality controls:
• The system detects duplicates to prevent clutter.
• You can set minimum file size and duration to avoid indexing low-quality or incidental files.
• Playback and search:
• Sorting by a wide array of properties makes it easy to find the exact track you want.
• Global search supports matching by title, artist, album, filename, and even lyrics for quick discovery.

Look & Feel

Namida embraces a modern, color-rich design that emphasizes usability and aesthetics.

• Material 3-inspired interface:
• Clean typography, responsive layouts, and a tactile feel that adapts to device size.
• Dynamic theming:
• The app adapts its color palette based on the album artwork, creating a cohesive visual identity for each listen.
• Core pages:
• Home, Tracks, Albums, Artists, Genres, Playlists, Queues, and Folders provide multiple ways to navigate your library.
• Visual playback cues:
• A waveform seekbar gives you a sense of rhythm even when you’re skimming through the timeline.
• Customization:
• Numerous settings and dialogs offer granular control over appearance, behavior, and interactions.
• Usage previews:
• A streamlined, intuitive design aims to minimize friction when exploring or playing.

Streaming & Youtube

If you love YouTube as a source for music and videos, Namida provides a robust set of features to optimize quality, data usage, and convenience.

• Quality and efficiency:
• Supports high-quality video and audio playback with data-saving options.
• Downloads, caching, and offline playback ensure you can enjoy content without constant network access.
• Video controls:
• Gesture-based video viewing: swipe to adjust volume, double-tap to seek, pinch to fullscreen, swipe to seek, long-press for 2x speed, and more.
• YouTube integration:
• SponsorBlock and Return Youtube Dislike integration help tailor the viewing experience.
• Video segmentation and heatmaps offer insights into long videos.
• Data management:
• Data saver mode and a cache-priority system help ensure important content remains accessible.
• Tagging and organization:
• Tags for downloads and a flexible filename scheme help keep downloaded content tidy.
• Auto title/artist/album extraction simplifies tagging and supports scrobbling.
• Formats and multi-library support:
• A range of formats and a structured tagging system support both local and online sources, including YouTube, Subsonic, and WebDAV.
• Examples of available tag fields include videoid, videourl, title, artist, channel, duration, description, playlist, and more, with sensible defaults and optional overrides.

Video Integration

Namida is designed to blur the line between music and video in ways that feel natural and integrated.

• Local video matching:
• For local libraries, Namida looks for matching titles in video files that live in user-specified folders.
• Matching logic accepts variations in capitalization and punctuation to improve robust matching.
• YouTube matching:
• If a video URL is embedded in the track’s metadata or filename (e.g., in a comment tag or video link), Namida can download and cache the video for playback.
• Streaming is prioritized for the audio track, but the full video can be played when available, providing a richer multimedia experience.
• Full video library support:
• Since version 4.0.0, Namida supports full video indexing and playback as a standalone experience.

Screenshots

To illustrate the look and flow, Namida provides a visual snapshot of its interface and customization options:

• Screenshots:
• Collection view in light and dark themes
• Individual track and artist listings
• Customization settings panel
• YouTube miniplayer in action

Usage Preview

A quick look at what it feels like to use Namida in the wild:

• The app surfaces your most recent listening and watching history, dynamically updating as you explore more content.
• The dynamic theming and artwork-driven accents create an immersive experience that stays fresh across diverse libraries.
• The miniplayer and responsive gestures let you keep control without breaking your flow.
• You can experiment with “Smort Tracks Generation” and other recommendations to discover new content tied to your listening history.
• The extensive tagging and metadata support make it easy to keep everything organized, even as your collection expands.

Installation

Namida’s installation notes cover platforms and the practical steps you’ll need to get started.

• Android (Stable vs Beta):
• Stable: Access the latest official release on GitHub and install via the provided APK or package, with direct links to your preferred distribution channel.
• Beta: Access beta builds for earlier access to upcoming features.
• Windows:
• Stable: Download the latest release from GitHub.
• Beta: Access beta releases from the corresponding beta channel.
• Linux:
• Linux installation is forthcoming for some platforms; a dedicated beta channel provides the latest updates in packages and scripts.
• Quick Linux install guidance includes dependency setup and ready-to-run scripts.
• Important dependencies include mpv for playback, with optional wpewebkit for login support on supported distros.
• Quick start tips:
• The Linux setup includes commands to install mpv and (optionally) wpewebkit, and provides one-liner scripts to install Namida via tarball or AUR-like packages.
• If you prefer a comprehensive setup path, the guide includes package manager commands for Arch/Manjaro, Debian/Ubuntu, and Fedora/RHEL.

Companion Apps

Namida’s ecosystem extends beyond the core app with community-developed tools that enhance backup, statistics, and visualizations.

• Namida Sync: Sync Namida backups and files across Android, Windows, and Linux.
• Namida Charts: A companion app that visualizes yearly and monthly listening statistics with charts.
• Namida Wrapped: A local web UI for Spotify-wrapped-style stat generation.
• These tools are community-driven contributions that enhance the Namida experience and help you extract more value from your listening history.

Permission Note

Namida requires a thoughtful set of permissions to deliver a robust media experience while respecting user privacy and device resources.

• Core media permissions:
• WAKELOCK and FOREGROUNDSERVICE to keep playback alive and responsive.
• INTERNET for streaming, image retrieval, and downloads.
• Storage and media access:
• READEXTERNALSTORAGE / READMEDIA* permissions (Android variations) to index media from user folders.
• WRITEEXTERNALSTORAGE and MANAGEEXTERNALSTORAGE (Android 10+) to edit tags, back up data, manage artworks, and support advanced file operations.
• VIBRATE for haptic feedback, with the option to disable.
• POST_NOTIFICATIONS for progress updates like history imports or downloads.
• System integration:
• REQUESTIGNOREBATTERY_OPTIMIZATIONS to improve downloads when needed.
• WRITE_SETTINGS to allow actions like setting audio as a ringtone.
• QUERYALLPACKAGES to interact with external equalizers.
• Note: Permissions are requested as needed, with clear explanations for why each is necessary.

Special Thanks

Namida credits several contributors whose work underpins the project’s capabilities and user experience:

• MSOB7YY for their YouTube client powering the YouTube section.
• cameralis for miniplayer physics and smooth interactions.
• alexmercerind for valuable guidance and support.
• lusaxweb for the Iconsax icon pack, which informs a consistent visual language.
• All package maintainers who contributed to making Namida possible.

Translate

Namida invites contributors to help translate the user interface and experience. You can participate via the Translation Repository.

Contribute

Namida welcomes contributions and feedback. Building is not currently possible directly within the project for all environments, and the project team explains why in their issue tracker. If you’re interested in contributing, you can follow the guidance provided on the repository to propose improvements, fixes, or new features.

Donate

Support Namida’s ongoing development with donations. Options include Buy Me a Coffee, Ko-fi, and cryptocurrency (Bitcoin/ETH/USDT BEP20). Support helps maintain and improve Namida and shows appreciation for the work of the developers.

Social

Stay connected with the Namida community and updates:

• Telegram (Updates): https://t.me/namida_official
• Telegram (Chat): https://t.me/+FmdfsgKoGmM1ZGFk
• Discord: https://discord.gg/WeY7DTVChT

Note on sources: There are no external Namida websites beyond GitHub and Telegram. Be cautious with unofficial sources.

License

Namida is licensed under the project’s EULA. The license governs usage, modification, and redistribution, with emphasis on personal use and respecting the rights of the project maintainers.

Images and visuals referenced in this description

• Namida icon: Included at the top of the post to anchor the brand and identity.
• Screenshots:
• collectionlight1.jpg
• collectionlight2.jpg
• collectiondark1.jpg
• collectiondark2.jpg
• Customization settings: customization_settings.jpg
• YouTube miniplayer: yt_miniplayer.png

In closing

Namida stands out as a polished, feature-rich media player that respects both local and online content while delivering a visually engaging and highly customizable experience. Built with Flutter, it embraces modern design principles, integrates YouTube with thoughtful controls, and offers robust library management, video integration, and an ecosystem of companion tools. Whether you’re a casual listener who wants a clean interface or a power user who needs advanced tagging, playlisting, and cross-library organization, Namida provides a compelling foundation. If you’re curious to explore more, check out the GitHub repository for releases, beta channels, and the latest community-driven enhancements.

[![Featured on TechLogHub](https://techloghub.com/badge-neutral.svg)](https://techloghub.com/open-source/namida?utm_source=techloghub_badge&utm_medium=referral&utm_campaign=readme)