base on A Beautiful and Feature-rich Music & Video Player with Youtube Support, Built in Flutter <link rel="stylesheet" href="styles.css" /> # <div style="margin-right: 18px; margin-top: 18px; display:flex; vertical-align: middle; align-items: center; max-width: 100%;"><img src="some stuff/namida.png" width="82" style="margin-right: 18px;">Namida</div> A Beautiful and Feature-rich Music & Video Player with Youtube Support, Built in Flutter <a href="https://github.com/flutter/flutter"> </a> <a href="https://t.me/namida_official"> </a> <a href="https://t.me/+FmdfsgKoGmM1ZGFk"> </a> <a href="https://discord.gg/WeY7DTVChT"> </a> <a href="https://github.com/namidaco/namida/releases">  </a> <a href="https://github.com/namidaco/namida/releases"> [](https://hitsofcode.com/github/namidaco/namida/view?branch=main) </a> <a href="https://github.com/namidaco/namida/releases"> [](https://ghloc.vercel.app/namidaco/namida?branch=main) </a> <div style="display:flex; gap:8px; align-items:center;"> <a href="https://github.com/namidaco/namida/releases/latest"> <img src="https://raw.githubusercontent.com/machiav3lli/oandbackupx/034b226cea5c1b30eb4f6a6f313e4dadcbb0ece4/badge_github.png" height="75"> </a> <a href="https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/namidaco/namida/"> <img src="https://raw.githubusercontent.com/ImranR98/Obtainium/main/assets/graphics/badge_obtainium.png" height="50"> </a> </div> # Sections: - [Features](#-features) - [Library \& Indexing](#library--indexing) - [Look \& Feel](#look--feel) - [Streaming & Youtube](#streaming--youtube) - [Others](#others) - [Some additional cool features](#some-additional-cool-features) - [Video Integration](#video-integration) - [Screenshots](#screenshots) - [Usage Preview](#usage-preview) - [Installation](#installation) - [Permission Note](#permission-note) - [Special Thanks](#special-thanks) - [Contribute](#contribute) - [Donate](#donate) - [Social](#social) - [LICENSE](#license) # 🎉 Features - Everything you might expect from a music player, in addition to the following: ## Library & Indexing - Powerful Indexer & Tag Editor, powered by @jaudiotagger. - 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](#customization-settings)). ## 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, etc) - Tags config for downloads - Optional Auto title/artist/album extraction for downloads and scrobbling - Downloads output filename builder (similar to yt-dlp) <details> <summary>Available formats & example</summary> - 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 - **<ins>Fading Light</ins>** (Slowed)*) - `artist`: extracted music artist from video title (***<ins>Navjaxx</ins>** - 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: ```bash # [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 ``` </details> ## Others: - Lyrics auto fetching & displaying (Synced & Plain). - 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..) - Define parameters to use for filtering tracks in search lists. - 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. ## 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 - <p>CAN IMPORT YOUTUBE HISTORY <img src="some stuff/ong.png" width=16 height=16/></p> - <p>LASTFM TOO AND MAYBE MORE IN FUTURE <img src="some stuff/yoowhat.gif" width=16 height=16/></p> - 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 <details> <summary> ###### How locally? </summary> typically looks (inside the folders you specificed) for any matching title, matching goes as following: <br> -- Alan walker - Faded.m4a <br> -- video alAn WaLkER - faDed (480p).mp4 <br> the video filename should contain at least one of the following: <br> 1. the music filename as shown above. <br> 2. title & first artist of the track. <br> 3. track youtube id (in track comment tag/filename, see "#How youtube?" section below). <br> note: some cleanup is made to improve the matching, all symbols & whitespaces are ignored. </details> <details> <summary> ###### How youtube? </summary> - 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. - for filenames, it should contain `v=video_id` or `id=video_id` in order to get matched. </details> - 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 <img src="screens/collection_light_1.jpg" class="imgbr"/> <img src="screens/collection_light_2.jpg" class="imgbr"/> <img src="screens/collection_dark_1.jpg" class="imgbr"/> <img src="screens/collection_dark_2.jpg" class="imgbr"/> <details> <summary> ### Customization Settings </summary> <img src="screens/customization_settings.jpg" class="imgbr" width="50%"> </details> <details> <summary> ### YouTube Miniplayer </summary> <img src="screens/yt_miniplayer.png" class="imgbr" width="50%"> </details> <br> ### Usage Preview Animating Thumbnail | Recommends & Listens :-------------------------:|:-------------------------: <video src="https://github.com/namidaco/namida/assets/85245079/da47c270-9f45-4ff5-a08e-e99e4b7ebb7c.mp4"> | <video src="https://github.com/namidaco/namida/assets/85245079/72e978b3-6e15-4b4e-948a-03b470802b30.mp4"> # Installation - Namida is available for - **Android** (stable/beta) - **Windows** (beta) _`new` <div align="center"> <table> <tr> <th><div align="center">Stable</div></th> <th><div align="center">Beta</div></th> </tr> <tr> <td align="center" width="200"> <div style="display:flex; flex-direction:column; align-items:center;"> <a href="https://github.com/namidaco/namida/releases/latest"> <img src="https://raw.githubusercontent.com/machiav3lli/oandbackupx/034b226cea5c1b30eb4f6a6f313e4dadcbb0ece4/badge_github.png" height="75"> </a> <a href="https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/namidaco/namida/"> <img src="https://raw.githubusercontent.com/ImranR98/Obtainium/main/assets/graphics/badge_obtainium.png" height="50" style="margin-top:8px;"> </a> </div> </td> <td align="center" width="200"> <div style="display:flex; flex-direction:column; align-items:center;"> <a href="https://github.com/namidaco/namida-snapshots/releases/latest"> <img src="https://raw.githubusercontent.com/machiav3lli/oandbackupx/034b226cea5c1b30eb4f6a6f313e4dadcbb0ece4/badge_github.png" height="75"> </a> <a href="https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/namidaco/namida-snapshots/"> <img src="https://raw.githubusercontent.com/ImranR98/Obtainium/main/assets/graphics/badge_obtainium.png" height="50" style="margin-top:8px;"> </a> </div> </td> </tr> </table> </div> ### 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. ### Special Thanks: > - [@MSOB7YY](https://github.com/MSOB7YY) for their youtube client, which powers youtube section. > - [@010101-sans](https://github.com/010101-sans) for creating [namida_sync](https://github.com/010101-sans/namida_sync), which makes syncing namida backups/files between android/windows easier. > - [@cameralis](https://github.com/cameralis) for their awesome miniplayer physics. > - [@alexmercerind](https://github.com/alexmercerind) for helping me out a lot. > - [@lusaxweb](https://github.com/lusaxweb) for their awesome Iconsax icon pack. > - All packages' maintainers which made namida possible. > <br> > ### © Logo by @midjourney # Contribute - You can help translating Namida to your language on [Translation Repo](https://github.com/namidaco/namida-translations) - Building is not currently directly possible, see why on https://github.com/namidaco/namida/issues/37#issuecomment-1780341883 <!-- [](https://translate.codeberg.org/engage/namida-translations/) --> # Donate - Donation will help improve namida and will show appreciation. <a href="https://www.buymeacoffee.com/namidaco" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 42px;" ></a> <a href="https://ko-fi.com/namidaco" target="_blank"><img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="Ko-fi" style="height: 42px;" ></a> > 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 - [Telegram (Updates)](https://t.me/namida_official) - [Telegram (Chat)](https://t.me/+FmdfsgKoGmM1ZGFk) - [Discord](https://discord.gg/WeY7DTVChT) - ⚠️ there are no websites for namidaco/namida other than github & telegram, we are not resposible for downloading from other sources. # LICENSE Project is licensed under [EULA](https://github.com/namidaco/namida/blob/main/LICENSE) License. ``` © Copyright (C) 2023-present Namidaco <[email protected]> - 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. ``` <a href="https://star-history.com/#namidaco/namida&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=namidaco/namida&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=namidaco/namida&type=Date" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=namidaco/namida&type=Date" /> </picture> </a>", Assign "at most 3 tags" to the expected json: {"id":"9581","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"