Skip to main content

​
Installation Guide

Namida is available for Android (stable/beta), Windows (beta), and Linux (beta). Choose your platform below for installation instructions.

​
Android Installation

Namida for Android is available in both stable and beta versions.

​
Download Options

1

Download from GitHub

Visit the latest release page and download the APK file.
Look for the file named namida-vX.X.X-release.apk (where X.X.X is the version number).
2

Install the APK

Open the downloaded APK file on your Android device and follow the installation prompts.
You may need to enable “Install from Unknown Sources” in your device settings.
3

Grant Permissions

When you first open Namida, grant the necessary permissions for storage access to scan your music library.

​
Alternative: Obtainium

You can also install Namida using Obtainium for automatic updates:Add to Obtainium

​
Required Permissions

Namida requests the following permissions:
  • WAKE_LOCK & FOREGROUND_SERVICE - Keep app alive for media playback
  • INTERNET - Download artwork, stream YouTube content, etc.
  • READ_MEDIA_AUDIO (Android 13+) / READ_EXTERNAL_STORAGE (Android ≤12) - List audio files from indexer folders
  • READ_MEDIA_VIDEO (Android 13+) - List video files for video playback
  • READ_MEDIA_IMAGES (Android 13+) - List image files for fallback covers
  • MANAGE_EXTERNAL_STORAGE (Android 10+, requested when needed) - For editing tags, backups, downloading, etc.
  • VIBRATE - Haptic feedback (can be disabled in settings)
  • POST_NOTIFICATIONS - Download progress and history import notifications

​
Windows Installation

Windows support is in beta. Some features may not work as expected.
Namida for Windows is available in the beta releases.
1

Download the Installer

Go to the beta releases page and download the Windows installer:
  • MSIX file for Windows Store-style installation
  • EXE installer for traditional installation
2

Run the Installer

Double-click the downloaded file and follow the installation wizard.
Windows may show a SmartScreen warning. Click “More info” and then “Run anyway” if you trust the source.
3

Launch Namida

After installation, launch Namida from the Start Menu or desktop shortcut.
4

Configure Music Library

On first launch, set up your music folders to start indexing your library.

​
Windows Requirements

  • Windows 10 or later
  • 4GB RAM minimum (8GB recommended)
  • 500MB free disk space (more for library and cache)

​
Linux Installation

Linux support is new and in beta. Please report any issues on GitHub.
The easiest way to install Namida on Linux: 
curl -fsSL https://raw.githubusercontent.com/namidaco/namida/main/scripts/install_linux_tar.sh | sudo bash

​
Package Managers

# Using yay
yay namida

# Or using pacman (from AUR)
sudo pacman -S namida-bin

​
Install MPV (Required)

Namida requires MPV for video playback on Linux: 
sudo apt install mpv

​
Linux Requirements

  • Modern Linux distribution (kernel 5.0+)
  • MPV media player
  • 4GB RAM minimum
  • 500MB free disk space

​
Verification

After installation, verify Namida is working correctly:
1

Launch the App

Open Namida from your application launcher or menu.
2

Check Version

Go to Settings → About to verify you have the correct version installed.Current stable version: v5.6.1
3

Grant Permissions

Allow storage access when prompted (Android) or configure folders (Desktop).

​
Troubleshooting

  • Make sure you have enough storage space (at least 200MB free)
  • Enable “Install from Unknown Sources” in Settings → Security
  • Try uninstalling any previous version first
  • Reboot your device and try again
Windows SmartScreen may block the installer because it’s not from the Microsoft Store:
  1. Click “More info” when the warning appears
  2. Click “Run anyway” to proceed with installation
  3. This is normal for open-source applications
  • Verify MPV is installed: mpv --version
  • Check dependencies: ldd $(which namida)
  • Try running from terminal to see error messages
  • Make sure you have necessary permissions
Go to Android Settings → Apps → Namida → Permissions and manually grant:
  • Storage/Files and media
  • Notifications (optional)
For “All files access” (needed for some features):
  1. Go to Settings → Storage → Manage storage
  2. Find Namida and enable “Allow management of all files”

​
Next Steps

Quick Start Guide

Learn how to set up your library and start playing music

Join Community

Get help and updates from the Namida community
Keep Namida Updated: Using Obtainium (Android) or checking the GitHub releases page regularly ensures you get the latest features and bug fixes.

Build docs developers (and LLMs) love

Get started for freeTalk to us