Skip to main content
Namida is available for Windows as a beta release, bringing the powerful music and video player experience to desktop.

​
Installation

1

Download Namida

Choose your preferred installation method:

MSIX Installer

Recommended for most users. Integrates with Windows and auto-updates.

Portable EXE

Run without installation. Useful for USB drives or restricted environments.
Download from GitHub Releases (Beta)
2

Install MSIX (Recommended)

For MSIX installation:
  1. Download the .msix file
  2. Double-click to open
  3. Click Install
  4. Wait for installation to complete
  5. Launch Namida from Start Menu
The MSIX package is configured with proper capabilities:
  • Music Library access
  • Videos Library access
  • Internet Client access
3

Or Use Portable Version

For portable installation:
  1. Download the portable .zip file
  2. Extract to your desired location
  3. Run namida.exe
  4. All settings and data are stored in the app folder

​
System Requirements

  • Operating System: Windows 10 (1809) or later, Windows 11
  • Architecture: x64 (64-bit)
  • RAM: 4GB minimum, 8GB recommended
  • Storage: 200MB for the app + space for media cache
  • Display: 1280x720 minimum resolution
  • Graphics: DirectX 11 compatible GPU
Windows 7 and 8.1 are not supported. Namida requires Windows 10 version 1809 or newer.

​
Windows-Specific Features

​
System Integration

Namida integrates with the Windows taskbar:
  • Thumbnail Toolbar: Playback controls in taskbar preview
  • Progress Bar: Track progress shown in taskbar icon
  • Jump List: Quick access to recent playlists
  • Thumbnail Preview: Album artwork in hover preview
Native Windows media controls:
  • Control playback from keyboard media keys
  • Show in Windows 11 Quick Settings media panel
  • Lock screen playback controls
  • Volume mixer integration
Full desktop window features:
  • Minimize, maximize, and restore window states
  • Custom title bar with app controls
  • Resize to any dimension
  • Remember window position and size
  • Multi-monitor support
Control Namida from anywhere:
  • Register system-wide keyboard shortcuts
  • Control playback without focusing the window
  • Customizable key combinations
  • Configure in Settings > Keyboard Shortcuts

​
File Handling

​
Drag and Drop Support

Namida supports native Windows drag and drop: 
Supported Actions:
- Drag audio files into Namida to add to queue
- Drag folders to add all music files
- Drag playlist files (.m3u, .m3u8) to import
- Drag YouTube links to download

​
File Associations

Namida automatically registers for these file types: 
m4a, mp3, wav, flac, ogg, oga, ogx, aac, opus, weba
m4b, alac, ac3, mp2, m4p, mpa, amr, ape, aa, aax
act, dss, dts, dvf, dct, dff, dsf, mmf, mid, mpc
msv, mogg, raw, ra, voc, wma, caf, aiff, wv, aif
aifc, m4r, mac, mka, mlp, mpp, uax
You can double-click any supported file to open it directly in Namida.

​
File Picker

Namida uses the native Windows file picker:
  • Browse files and folders with familiar Windows interface
  • Quick access to common locations (Desktop, Documents, Music)
  • Network drive support
  • Recently used locations

​
Features & Capabilities

​
Supported Features

Full Library Management

  • Index music from multiple folders
  • Tag editor with metadata support
  • Album artwork management
  • Smart playlists

YouTube Integration

  • Stream YouTube content
  • Download videos and audio
  • Cache management
  • Offline playback

Video Playback

  • Hardware-accelerated decoding
  • Multiple format support
  • Fullscreen mode
  • Subtitle support

Audio Processing

  • Crossfade and fade effects
  • Equalizer
  • Replay Gain
  • Skip silence

​
Media Kit Integration

Namida on Windows uses Media Kit for video playback:
  • Version: media_kit ^1.2.0
  • Video Support: media_kit_video ^2.0.1
  • Windows Libraries: media_kit_libs_windows_video ^1.0.11
This provides:
  • Hardware acceleration
  • Wide format support
  • Low latency playback
  • Subtitle rendering

​
Configuration

​
Settings Storage

MSIX Installation: 
C:\Users\[YourName]\AppData\Local\Packages\com.msob7y.namida_[id]\LocalState
Portable Installation: 
[Installation Directory]\data\

​
Library Indexing

1

Add Music Folders

  1. Open Settings > Indexer
  2. Click Add Folder
  3. Browse to your music folder (e.g., C:\Users\[Name]\Music)
  4. Click Select Folder
2

Configure Index Settings

Customize what gets indexed:
  • Set minimum file size filter
  • Set minimum duration filter
  • Enable duplicate prevention
  • Choose separator for multiple artists/genres
3

Start Indexing

  1. Click Start Indexing
  2. Wait for the process to complete
  3. Progress is shown in the status bar

​
Network Folders

Access music on network drives:
  1. Map network drive in Windows Explorer
  2. Add the mapped drive letter in Namida indexer
  3. Ensure network connection is stable
  4. Consider caching for offline access

​
Performance Optimization

​
Windows-Specific Tips

Windows Defender

Add Namida to Windows Defender exclusions to prevent scanning during playback and indexing.

Power Plan

Use “High Performance” power plan for best audio/video performance, especially on laptops.

Startup Performance

Disable startup apps you don’t need to free up resources for Namida.

Storage Type

Store your music library on an SSD for faster indexing and loading times.

​
Resource Usage

Typical resource consumption:
  • Idle: ~100-200MB RAM
  • Audio Playback: ~150-250MB RAM
  • Video Playback: ~300-500MB RAM
  • Indexing: ~200-400MB RAM (temporary spike)

​
Troubleshooting

If Namida fails to launch:
  1. Ensure you’re on Windows 10 (1809) or later
  2. Install Visual C++ Redistributable 2015-2022
  3. Update Windows to the latest version
  4. Check Windows Event Viewer for error details
If MSIX installation fails:
  1. Enable Developer Mode in Windows Settings > Update & Security > For developers
  2. Or right-click the MSIX file > Properties > Digital Signatures > Details > View Certificate > Install Certificate
  3. Choose “Local Machine” and place in “Trusted Root Certification Authorities”
If you can’t hear audio:
  1. Check Windows volume mixer (Namida should appear when playing)
  2. Right-click the volume icon > Open Sound settings
  3. Ensure correct output device is selected
  4. Try switching audio output in Namida settings
If videos won’t play or stutter:
  1. Update your graphics drivers
  2. Disable hardware acceleration in Settings > Video if issues persist
  3. Close other video applications
  4. Check if your GPU supports the video codec
If Namida uses excessive CPU:
  1. Disable visual effects in Settings > Customization
  2. Reduce particle effects and animations
  3. Close other resource-intensive applications
  4. Check for Windows updates

​
Keyboard Shortcuts

Default keyboard shortcuts:
ShortcutAction
SpacePlay/Pause
→Next track
←Previous track
↑Volume up
↓Volume down
MMute/Unmute
LToggle repeat
SToggle shuffle
FToggle fullscreen (video)
Ctrl+FSearch
Ctrl+OOpen file
Ctrl+,Settings
All shortcuts can be customized in Settings > Keyboard Shortcuts

​
Known Limitations

Some features are still in development for Windows:
  • No system tray minimize option yet
  • Sleep timer may not work reliably on some systems
  • Some Flutter plugins may have limited functionality
  • Windows 11 snap layouts not yet fully supported

​
Updates

​
MSIX Updates

MSIX installations can check for updates:
  1. Go to Settings > About
  2. Click Check for Updates
  3. If available, download and install the new version

​
Portable Updates

For portable versions:
  1. Download the latest version
  2. Extract to a temporary location
  3. Copy your data folder from the old version
  4. Replace the old installation
Always backup your data folder before updating!

​
Developer Information

  • Application ID: com.msob7y.namida
  • Display Name: Namida
  • Publisher: namidaco
  • Build System: CMake with Flutter
  • C++ Standard: C++17
  • Required Dependencies: Visual C++ Redistributable 2015-2022

​
Build Configuration

From pubspec.yaml: 
msix_config:
  display_name: Namida
  publisher_display_name: namidaco
  identity_name: com.msob7y.namida
  capabilities: musicLibrary, videosLibrary, internetClient
  file_extension: .audio, .music, .video

Build docs developers (and LLMs) love

Get started for freeTalk to us