Skip to main content
Namida provides comprehensive YouTube integration, allowing you to stream music, download videos, cache content for offline playback, and enjoy advanced features like SponsorBlock segment skipping.

​
Overview

The YouTube functionality is powered by youtipie and supports:
  • Streaming: Play YouTube content directly without downloading
  • Downloads: Save videos and audio for offline access
  • Caching: Automatic caching of frequently played content
  • Quality Control: Choose preferred video and audio quality
  • SponsorBlock: Skip sponsor segments, intros, and outros automatically
Namida uses multi-library support, allowing you to seamlessly switch between local files, YouTube content, and other sources.

​
Streaming

​
Audio & Video Quality

Select your preferred quality settings for streaming:

Video Quality

  • 144p (lowest)
  • 240p
  • 360p
  • 480p
  • 720p (HD)
  • 1080p (Full HD)
  • 1440p (2K)
  • 2160p (4K)

Audio Quality

  • Opus format (WebM container)
  • AAC format (M4A container)
  • Automatic quality selection
  • Best available bitrate

​
Playback Modes

1

Audio-Only Mode

Stream only audio track to save bandwidth and battery
2

Video Mode

Stream both video and audio with full quality
3

Data Saver Mode

Automatically select lower quality to reduce data usage
Audio-only mode is recommended for music listening to conserve battery and reduce data consumption.

​
Downloads

​
Download Management

Namida features a sophisticated download system with parallel downloads and queue management: 
// Downloads are organized by group names
// Each video can have separate audio and video streams
// Progress tracking for each download task
  • Parallel Downloads: Download multiple files simultaneously
  • Queue System: Add videos to download queue
  • Pause/Resume: Control downloads at any time
  • Progress Tracking: Real-time progress and speed monitoring
  • Group Organization: Organize downloads into named groups
  • Retry Failed: Automatically retry failed downloads

​
Output Filename Builder

Customize how downloaded files are named using a powerful template system similar to yt-dlp:
  • %(video_id)s or %(id)s: Video identifier
  • %(video_title)s or %(fulltitle)s: Full video title
  • %(title)s: Extracted music title from video title
  • %(artist)s: Extracted artist or channel name
  • %(channel)s: Channel name (excluding ” - Topic”)
  • %(upload_date)s: Upload date (yyyyMMdd)
  • %(duration_string)s: Duration formatted (3:24)
  • %(playlist_title)s: Playlist title
  • %(playlist_autonumber)s: Position in playlist (starts at 1)
  • %(ext)s: File extension (automatically added)

​
Filename Examples

# Basic format: music title [(channel name)]
%(title)s [(%(channel)s)]

# Numbered playlist format: [04] music title
[%(playlist_autonumber)s] %(title)s

# Organize into folders by playlist
%(playlist)s/%(playlist_autonumber)s. %(title)s.%(ext)s
# Example output: music playlist/02. music title.m4a

# Artist - Title format
%(artist)s - %(title)s

​
Tags Configuration

Automatically tag downloaded files with metadata:
1

Auto Title Extraction

Extract clean music title from video title (removes “(Official Music Video)”, “(Audio)”, etc.)
2

Auto Artist Extraction

Extract artist name from video title or use channel name
3

Album Configuration

Set album name from playlist title or custom value
4

Genre Detection

Automatically set genre to “Nightcore” when detected in title
Downloaded files are automatically integrated into your local library with proper tags for seamless playback.

​
Caching System

​
Intelligent Caching

Namida employs a smart caching system to optimize storage and performance:
  • Automatic Caching: Frequently played content is cached automatically
  • Cache Priority: Keep important content based on play count
  • Size Limits: Configure maximum cache size
  • Cleanup: Automatic removal of least-used cached content
  1. High Priority: Manually downloaded content (never auto-deleted)
  2. Medium Priority: Frequently played content (kept longer)
  3. Low Priority: Streamed content (removed first when space needed)

​
Offline Playback

Cached and downloaded content is available offline:

Downloads

Permanently stored until manually deleted

Cache

Temporarily stored, subject to cache management policies

​
Advanced Features

​
SponsorBlock Integration

Automatically skip unwanted segments in videos:
1

Enable SponsorBlock

Turn on SponsorBlock in YouTube settings
2

Choose Categories

Select which segment types to skip (sponsor, intro, outro, self-promo, etc.)
3

Auto-Skip

Segments are automatically skipped during playback

​
Supported Segment Types

  • Sponsor: Paid promotion segments
  • Intro: Intermission/intro animation
  • Outro: Endcards/credits
  • Self-Promotion: Unpaid self-promotion
  • Interaction Reminder: “Like, subscribe, comment”
  • Preview/Recap: Preview of upcoming content or recap
  • Music: Non-Music Section: Non-music sections in music videos
  • Filler: Tangential content
SponsorBlock relies on community-submitted segments. Some videos may not have segment data available.

​
Return YouTube Dislike

View dislike counts on YouTube videos with Return YouTube Dislike integration:
  • Displays accurate dislike counts
  • Shows like/dislike ratio
  • Community-driven data source

​
Segments & Heatmap

Visual representation of video segments:
  • Segment Markers: See sponsor segments on the seekbar
  • Heatmap: View most-replayed sections (based on YouTube data)
  • Chapter Support: Navigate video chapters easily

​
Search & Discovery

Search YouTube directly from Namida: 
// Search supports:
// - Videos
// - Playlists
// - Channels
// - Filters (duration, upload date, type)
  • Duration: Any, Short (<4 min), Medium (4-20 min), Long (>20 min)
  • Upload Date: Any time, Hour, Today, Week, Month, Year
  • Type: Video, Channel, Playlist
  • Features: Live, 4K, HD, Subtitles, Creative Commons

​
History Import

Import your YouTube history for personalized recommendations:
1

Export from YouTube

Download your YouTube watch history from Google Takeout
2

Import to Namida

Load the history file into Namida
3

Enjoy Recommendations

Get personalized recommendations based on your YouTube habits
You can import both YouTube and Last.fm history for comprehensive listening data.

​
Subscriptions & Playlists

​
YouTube Subscriptions

Manage your YouTube channel subscriptions within Namida:
  • View latest uploads from subscribed channels
  • Sync subscriptions from your YouTube account
  • Get notifications for new content

​
YouTube Playlists

Access and play YouTube playlists:
  • Import public playlists by URL
  • Play entire playlists seamlessly
  • Download playlists for offline access
  • Automatic playlist metadata extraction

​
Video Playback

​
Gestures Support

Intuitive gesture controls for video playback:

Swipe Gestures

  • Swipe left/right to seek
  • Swipe up/down (left side) for brightness
  • Swipe up/down (right side) for volume

Tap Gestures

  • Double tap left to seek backward
  • Double tap right to seek forward
  • Single tap to show/hide controls

Advanced Gestures

  • Swipe up to enter fullscreen
  • Pinch in to enter fullscreen
  • Long press for 2x speed

Zoom Controls

  • Pinch to zoom video
  • Aspect ratio adjustment
  • Fit/Fill/Stretch modes

​
Fullscreen Mode

Immersive video viewing experience:
  • Automatic rotation support
  • Hide system UI in fullscreen
  • Gesture controls optimized for fullscreen
  • Brightness and volume overlays

​
Data Management

​
Data Saver Mode

Reduce data consumption:
  • Lower Quality: Automatically select lower video quality
  • Audio-Only Preference: Default to audio-only streaming
  • Cache Less: Reduce automatic caching
  • Thumbnail Quality: Load lower resolution thumbnails

​
Storage Management

  • View Downloads: See all downloaded content and sizes
  • Clear Cache: Remove cached streams to free space
  • Delete Downloads: Remove specific downloaded files
  • Download Location: Choose where files are saved

​
Preferences

​
Quality Preferences

// Configure preferred formats
// - Prefer Opus audio format (better quality at lower bitrate)
// - Prefer specific video quality (e.g., always 720p)
// - Allow experimental codecs (VP9, AV1)
Opus vs AAC: Opus typically provides better audio quality at the same bitrate but may have compatibility issues on some devices.

​
Codec Settings

  • Standard Codecs: H.264 (AVC), AAC (more compatible)
  • Experimental Codecs: VP9, AV1, Opus (better quality, newer devices)
Experimental codecs may not be supported on all devices. Disable if you experience playback issues.

​
Best Practices

1

Set Quality Based on Connection

Use data saver mode on mobile data, higher quality on Wi-Fi
2

Download for Offline

Download frequently played content to avoid repeated streaming
3

Organize Downloads

Use groups and filename templates to keep downloads organized
4

Manage Cache Size

Set appropriate cache limits based on available storage
5

Enable SponsorBlock

Skip unwanted segments for better listening experience

​
Troubleshooting

  • Check internet connection stability
  • Try lower quality settings
  • Enable data saver mode
  • Clear cache and try again
  • Update Namida to latest version
  • Ensure stable internet connection
  • Check available storage space
  • Pause and resume the download
  • Try downloading one file at a time
  • Check if video is still available on YouTube
  • Check download location in settings
  • Ensure download completed successfully
  • Refresh library to index downloaded files
  • Look in YouTube downloads folder

Build docs developers (and LLMs) love

Get started for freeTalk to us