Installation
Namida runs on Android, Windows and Linux. There are two channels:
- Stable releases, for everyone.
- Beta releases, new features and fixes are released here first. If YouTube or anything else stops working, try the latest beta.
Namida is only available through namida.app, GitHub & Telegram.
We are not responsible for downloads from other sources.
Android
Which file
Every release has an APK per architecture, beta adds a clone variant on top.
| File | Channel | Pick it if |
|---|---|---|
namida-vX.X.X-arm64-v8a.apk |
stable & beta | Default choice, works on any modern 64 bit device. |
namida-vX.X.X-armeabi-v7a.apk |
stable & beta | Old 32 bit device, or the arm64 one refuses to install. |
namida-vX.X.X-clone-arm64-v8a.apk |
beta only | You want the beta beside your stable Namida. Different app id, so it’s a separate app with separate data. |
namida-vX.X.X-clone-armeabi-v7a.apk |
beta only | Same clone, for 32 bit devices. |
You can install beta on top of stable and vice versa, your data stays as is. The clone builds are the only separate app.
Installing
- Download the APK from the release page.
- Open the file, Android asks to allow installing from unknown sources the first time.
- That’s it. Permissions are requested later while you use the app, and only when needed, see Permissions.
If Google blocks the install, see Can’t install the APK.
Updating
Installing a newer APK over the current one keeps your data, no need to uninstall.
Use Obtainium to get update notifications, point it at the stable repo or the snapshots repo for beta.
Namida is not on Google Play and will not be, see Not Planned for the reasoning.
Windows
Which file
| File | Pick it if |
|---|---|
Namida-x86_64-<version>-Installer.exe |
Normal install. Creates shortcuts and updates in place, recommended. |
Namida-x86_64-<version>-Portable.zip |
Nothing installed on the system. Extract anywhere and run namida.exe, good for a usb drive. |
Installing
Run the installer and follow it, or extract the portable zip and start namida.exe.
Stable installers are also published to winget:
winget install namidaco.Namida
Linux
Linux builds are beta only for now, a stable one is coming.
Dependencies
mpv is required for playback. You can skip this if you install through a package manager, the AppImage or the flatpak (they handle it themselves).
sudo pacman -S mpv # Arch/Manjaro
sudo apt install mpv libmpv2 # Debian/Ubuntu/Mint
sudo dnf install mpv mpv-libs # Fedora/RHEL
webkit2gtk is optional and only needed for YouTube login. Most distros already ship it, and the AppImage and flatpak include it.
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
Older betas had separate _login builds bundling wpewebkit. They are gone, every build now logs in through webkit2gtk.
Which file
| File | Pick it if |
|---|---|
namida-vX.X.X-beta.linux.tar.gz |
Any distro. This is what the quick install script below uses, or extract and run it yourself. |
namida-vX.X.X-beta.linux.deb |
Debian, Ubuntu, Mint and friends. |
namida-vX.X.X-beta.linux.rpm |
Fedora, RHEL and friends. |
Namida-x86_64-<version>.AppImage |
A single portable file, no installation. Everything is bundled so it runs on any distro, and it can update itself. |
Namida-x86_64-<version>.flatpak |
You already use flatpak. Ships its own mpv. |
Installing
Quick install, downloads the latest tarball and installs it to /opt/namida:
curl -fsSL https://raw.githubusercontent.com/namidaco/namida/main/scripts/install_linux_tar.sh | sudo bash
Through a package manager:
yay -Sy namida-bin # AUR (Arch Linux)
paru -Sy namida-bin # AUR (Arch Linux)
sudo apt install ./namida.deb # Debian/Ubuntu, download the .deb first
sudo dnf install ./namida.rpm # Fedora/RHEL, download the .rpm first
AppImage, make it executable then run it:
chmod +x Namida-x86_64-<version>.AppImage
./Namida-x86_64-<version>.AppImage
Flatpak:
flatpak install --user ./Namida-x86_64-<version>.flatpak
flatpak run app.namida.Namida
Coming from the old com.msob7y.namida flatpak? The id is now app.namida.Namida 🆕 v8.2.0, close Namida and move your data before removing the old one:
mv ~/.var/app/com.msob7y.namida ~/.var/app/app.namida.Namida
mv ~/.var/app/app.namida.Namida/data/com.msob7y.namida ~/.var/app/app.namida.Namida/data/app.namida.Namida
flatpak uninstall --user com.msob7y.namida
Nix (Home Manager) is available at namida-nix.
Companion Apps
Community built tools around Namida:
- Namida Sync, syncs Namida backups & files across Android, Windows and Linux, by @010101-sans.
- Namida Charts, yearly, monthly & more listening stats with charts, based on Namida history, by @DiWu17.
- Namida Wrapped, a local web ui for generating wrapped style stats, by @bebrriko.
Namida also has its own built in sync, see 🎉 Sync feature ↗.
Author: @MSOB7YY
Writer: @claude
