Skip to main content
Namida features a sophisticated queue management system that preserves your listening sessions, offers intelligent track insertion, and provides extensive playback control.

​
Overview

The queue system in Namida is designed to be:
  • Persistent: Your sessions are automatically saved and restored
  • Reliable: Queue state preserved even after app restarts
  • Flexible: Multiple ways to manipulate playback order
  • Smart: Intelligent track insertion and recommendations
  • Organized: Save and manage multiple queues
Namida’s queue system ensures you never miss your sessions - everything is automatically saved for later usage.

​
Queue Basics

​
Current Queue

The current queue represents your active listening session:
1

Start Playback

Play any track, album, playlist, or folder to create a queue
2

Queue Populated

All tracks from the source are added to the current queue
3

Navigate Queue

Skip forward/backward through queued tracks
4

Auto-Save

Queue is automatically saved as you listen

​
Queue Sources

Queues can be created from various sources:

All Tracks

Queue created from entire library

Album

All tracks from a specific album

Artist

All tracks by an artist

Playlist

Tracks from a specific playlist

Folder

All tracks in a folder

Search Results

Tracks from search query

Generated

Smart-generated related tracks

Custom

Manually built queue

​
Managing the Queue

​
Adding Tracks

Multiple methods to add tracks to the queue:
  • Play Next: Insert track immediately after current track
  • Add to Queue: Append track to end of queue
  • Insert After Latest: Add after the last manually inserted track
  • Replace Queue: Clear queue and add new tracks
  • Shuffle & Add: Randomize before adding to queue

​
Insert After Latest

Unique feature for queue management:
Insert After Latest Inserted: When you add multiple tracks one after another, this option ensures they stay together in the order you added them, inserting after the last track you manually added rather than at the end of the queue.Example: Current queue has 10 tracks. You add Track A with “Insert After Latest”, then Track B. Both tracks are inserted at position 2-3, maintaining your selection order.

​
Removing Tracks

Control what stays in your queue:
  • Remove Track: Swipe to remove individual tracks
  • Remove Played: Clear all previously played tracks
  • Remove Upcoming: Clear tracks after current position
  • Clear Queue: Remove all tracks from queue

​
Reordering Tracks

Flexible queue organization:
1

Long Press

Long press a track in queue view
2

Drag

Drag the track to desired position
3

Drop

Release to place track in new position
Queue changes are automatically saved and will persist across app restarts.

​
Saved Queues

​
Queue History

Namida maintains a history of your listening sessions: 
// Queues are stored chronologically
// Sorted by date (newest first)
// Limited to queues with ≤2000 tracks
Queues with more than 2000 tracks are not saved to prevent performance issues and excessive storage usage.

​
Managing Saved Queues

Access and manage your queue history:

View Queues

Browse all saved listening sessions chronologically

Restore Queue

Load a previous queue to continue that session

Favorite Queues

Mark important queues to prevent auto-deletion

Delete Queues

Remove unwanted queue history entries

​
Favorite Queues

Mark queues as favorites to preserve them:
1

Open Queue History

Navigate to Queues tab to see all saved queues
2

Mark Favorite

Tap star icon on any queue to mark as favorite
3

Protected

Favorite queues are protected from automatic cleanup
Favorite queues are never automatically deleted, making them perfect for sessions you want to revisit.

​
Playback Modes

​
Repeat Modes

Control how the queue repeats:
None: Play through queue once and stopAll: Loop entire queue continuouslyOne: Repeat current track indefinitelyFor N Times: Repeat current track specific number of times before advancing

​
Repeat for N Times

Unique repeat feature: 
// Example: Repeat current track 3 times
// Track plays → Track plays → Track plays → Next track plays
Repeat for N times is perfect when you want to hear a track multiple times without manually replaying it.

​
Shuffle Mode

Randomize playback order:
  • Shuffle Off: Play tracks in queue order
  • Shuffle On: Randomize remaining queue
  • Shuffle All: Re-shuffle entire queue
When shuffle is enabled, Namida creates a randomized playback order while preserving the original queue structure.

​
Advanced Queue Features

​
Track Play Mode

Control what plays when you select a track from search:
  • Selected Track Only: Play just the tapped track
  • Search Results: Play all tracks from current search results
  • Album: Play the track’s full album
  • First Artist: Play all tracks by the track’s first artist
  • First Genre: Play all tracks in the track’s genre
This feature gives you flexibility when playing tracks from search - quickly play just that song or explore the full context.

​
Smart Track Recommendations

Add intelligent recommendations to your queue:

Recommended

Tracks you usually listened to with the current track

Similar Release

Tracks released around the same time

Same Mood

Tracks tagged with similar moods

Random Related

Random tracks from same artist/genre/album

​
Queue Statistics

View information about current queue:
  • Total Tracks: Number of tracks in queue
  • Total Duration: Combined length of all tracks
  • Remaining Duration: Time left in queue from current position
  • Queue Source: What generated this queue
  • Creation Date: When queue was created

​
Queue Persistence

​
Automatic Saving

Queues are automatically saved:
1

Continuous Saving

Queue state saved as you add/remove/reorder tracks
2

Position Tracking

Current playback position preserved
3

Source Tracking

Original queue source remembered
4

Restore on Launch

Last queue automatically loaded when app starts

​
Latest Queue File

The most recent queue is stored separately: 
// Latest queue is immediately accessible on app startup
// No need to load queue history to continue listening
// Supports mixed content (local tracks + YouTube)

​
Queue Updates

​
Automatic Updates

Queues are updated when library changes:
When you move or rename track files, Namida automatically updates:
  • Current queue references
  • All saved queue history
  • Track paths adjusted to new locations
  • Preserves playback continuity

​
Manual Queue Updates

Modify saved queues:
  • Add Tracks: Insert tracks into saved queue
  • Remove Tracks: Delete specific tracks from queue
  • Reorder: Change track order in saved queue
  • Update Metadata: Refresh queue source information

​
Queue Integration

​
History Integration

Queue works seamlessly with history tracking:
  • Each track in queue contributes to history when played
  • Minimum listen time/percentage respected
  • Skip counts tracked separately
  • Session data preserved for analytics

​
Playlist Integration

Convert queues to playlists:
1

Open Queue

View current or saved queue
2

Save as Playlist

Tap “Save as Playlist” option
3

Name Playlist

Give your new playlist a name
4

Permanent Collection

Queue is now saved as a permanent playlist

​
Best Practices

1

Use Insert After Latest

When adding multiple related tracks, use this option to keep them together
2

Favorite Important Sessions

Mark queues you want to revisit as favorites
3

Clear Old Queues

Periodically clean up queue history to free storage
4

Save as Playlist

Convert great queues to playlists for permanent access
5

Use Track Play Mode

Configure play mode based on how you typically listen from search

​
Performance Tips

​
Queue Size Management

Large Queue Warning: While Namida can handle large queues, queues exceeding 2000 tracks:
  • Will not be saved to queue history
  • May impact performance on lower-end devices
  • Consider breaking into smaller queues or playlists

​
Optimization

  • Clean History: Remove old queues you won’t use
  • Favorite Selectively: Only favorite queues you’ll truly revisit
  • Limit Queue Size: Keep active queue under 500 tracks for best performance
  • Use Playlists: Convert large queues to playlists for better management

​
Troubleshooting

  • Check if app has storage permissions
  • Verify queue wasn’t empty when app closed
  • Ensure queue file isn’t corrupted (Settings → Reset Queue)
  • Check if battery optimization is killing app abruptly
  • Try manually saving queue as playlist
  • Verify track files still exist on device
  • Check if tracks were excluded from library
  • Ensure library is fully indexed
  • Look for tracks in different queue source
  • Try refreshing library and reloading queue
  • Ensure you’re long-pressing correctly
  • Check if queue is locked or read-only
  • Verify app has write permissions
  • Try disabling shuffle mode first
  • Restart app if drag gesture not responding
  • Check repeat mode settings (None mode stops after queue)
  • Verify you’re not triggering “Clear Queue” accidentally
  • Check if battery saver is affecting app
  • Ensure queue is being saved (favorite it to test)
  • Look for saved version in queue history

Build docs developers (and LLMs) love

Get started for freeTalk to us