Managing Playlists - Deeztracker Mobile

Overview

Deeztracker Mobile provides powerful playlist management features to organize your downloaded music collection. Create custom playlists, import playlists from Deezer, and manage your favorites.

Creating New Playlists

You can create playlists in multiple ways:

From the Playlists Tab

Navigate to Playlists

Open Local Music and switch to the Playlists tab.

Tap Create Playlist

Tap the large ”+” button at the top of the screen.

Name Your Playlist

Enter a name for your playlist in the dialog
Tap “Create” to confirm
Your new playlist appears in the list

LocalPlaylistsScreen.kt:74-104

item {
    Column(
        modifier = Modifier
            .fillMaxWidth()
            .clickable(onClick = onCreatePlaylist)
            .padding(vertical = 24.dp),
        horizontalAlignment = Alignment.CenterHorizontally
    ) {
        Box(
            modifier = Modifier
                .size(80.dp)
                .clip(RoundedCornerShape(16.dp))
                .background(Primary.copy(alpha = 0.2f)),
            contentAlignment = Alignment.Center
        ) {
            Icon(
                Icons.Default.Add,
                contentDescription = null,
                tint = Primary,
                modifier = Modifier.size(48.dp)
            )
        }

From the Player

While a track is playing:

Open Player Menu

Tap the three dots (⋯) button in the top-right of the player screen.

Select Add to Playlist

Choose “Add to Playlist” from the menu.

Create or Select

Select an existing playlist, OR
Tap “Create New Playlist”
Enter a name and save

From any track in your library:

Tap the three dots (⋮) next to a track
Select “Add to Playlist”
Choose existing or create new

Adding Tracks to Playlists

There are multiple ways to add tracks to your playlists:

Open Track Menu

In the Local Music or Downloads screen, tap the three-dot menu (⋮) next to any track.

Select Add to Playlist

Choose “Add to Playlist” from the dropdown menu.

Choose Playlist

A bottom sheet appears with all your playlists. Tap the playlist you want to add the track to.

Method 2: During Download

When downloading from Deezer:

Start a track download
The download system can optionally add it to a target playlist
This is handled automatically by the DownloadManager

DownloadManager.kt:211-215

if (request.playlistId != null) {
    Log.d(TAG, "Adding downloaded track $trackId to playlist ${request.playlistId}")
    playlistRepository.addTrackToPlaylist(request.playlistId, trackId)
}

Method 3: From Player

While music is playing, use the player menu to add the current track to any playlist.

Removing Tracks from Playlists

Open Playlist

Navigate to Local Music → Playlists tab and tap on a playlist to open it.

Open Track Menu

Tap the three-dot menu (⋮) next to the track you want to remove.

Remove Track

Select “Remove from Playlist” (or “Delete” depending on context).

Removing a track from a playlist doesn’t delete the actual audio file. The track remains in your library and other playlists.

Editing Playlist Details

You can rename and modify playlists after creation:

Renaming a Playlist

Open Playlists Tab

Go to Local Music → Playlists.

Open Playlist Menu

Tap the three-dot menu (⋮) next to the playlist you want to rename.

Select Edit

Choose “Edit” from the menu.

Enter New Name

Type the new name in the dialog
Tap “Save” to confirm

LocalPlaylistsScreen.kt:148-155

DropdownMenuItem(
    text = { Text(stringResource(R.string.action_edit), color = Color.White) },
    onClick = {
        showMenu = false
        showEditDialog = true
    }
)

Deleting a Playlist

Open Playlist Menu

From the Playlists tab, tap the menu (⋮) next to the playlist.

Select Delete

Choose “Delete” from the menu (shown in red).

Confirm

The playlist is immediately deleted. Track files remain intact.

Favorites Playlist: The built-in “Favorites” playlist cannot be edited or deleted. It’s managed automatically when you like/unlike tracks.

Importing Deezer Playlists

Deeztracker allows you to import playlists directly from your Deezer account:

Navigate to Import

Go to Local Music → Playlists tab.

Tap Import Button

Tap the import icon (⤓) in the top-right corner of the screen.

Select Deezer Playlist

A list of your Deezer playlists appears
Browse and tap on a playlist to import it

Download Tracks

The app creates a local playlist with the same name
Optionally, you can download all tracks in the playlist
Tracks are automatically added to the local playlist as they download

LocalMusicScreen.kt:297-301

if (selectedView == 3) { // Playlists Tab
    IconButton(onClick = onImportPlaylist) {
        Icon(Icons.Default.Input, contentDescription = "Import Playlist", tint = Color.White)
    }
}

Importing a playlist from Deezer creates a local copy but doesn’t automatically download the tracks. You’ll need to download tracks separately if you want offline access.

Organizing Your Collection

Playlist Strategies

Here are some effective ways to organize your music:

By Genre

Create playlists for different music genres:

Rock
Jazz
Electronic
Hip-Hop

By Mood

Organize by mood or activity:

Workout
Relaxing
Focus
Party

By Time Period

Sort by when you discovered the music:

New Discoveries
2023 Favorites
Throwbacks

By Quality

Group by audio quality:

FLAC Collection
High Quality (320kbps)
Standard

Playlist Management Tips

Best Practices

Keep playlists focused: Limit playlists to 20-50 tracks for easier navigation
Use descriptive names: “Chill Evening” is better than “Playlist 1”
Regular cleanup: Remove tracks you no longer want
Backup with export: Consider periodically exporting important playlists
Use Favorites wisely: Star only your absolute favorites for quick access

Playing Playlists

Once you’ve created playlists, you can play them:

Standard Play

Navigate to Local Music → Playlists
Tap on a playlist to open it
Tap the Play button to start from the first track
Tracks play in order

Shuffle Play

Open a playlist
Tap the Shuffle button
Tracks play in random order

LocalMusicScreen.kt:259-265

onShufflePlaylist = {
    val playlistTracks = selectedPlaylist.trackIds.mapNotNull { id -> unfilteredTracks.find { it.id == id } }
    if (playlistTracks.isNotEmpty()) {
        val shuffled = playlistTracks.shuffled()
        onTrackClick(shuffled.first(), shuffled, selectedPlaylist.name)
    }
}

Play from Track

Open a playlist
Tap any track in the playlist
Playback starts from that track and continues through the playlist

Favorites Playlist

The Favorites playlist is automatically managed:

Adding to Favorites

Tap the heart icon (❤️) in the player while a track is playing
Or use “Add to Favorites” from track menus
Track is automatically added to your Favorites playlist

Removing from Favorites

Tap the filled heart icon (❤️) again while playing
Or remove from the Favorites playlist directly

The Favorites playlist is stored with ID “favorites” and is automatically created when you first favorite a track.

Playlist Storage

Playlists are stored locally on your device:

Location: App’s private storage (SharedPreferences or local database)
Format: JSON-based playlist definitions
Track references: Playlists store track IDs, not the actual files
Persistence: Playlists survive app updates and restarts

LocalPlaylistRepository.kt

class LocalPlaylistRepository(context: Context) {
    private val prefs = context.getSharedPreferences("playlists", Context.MODE_PRIVATE)
    // Playlists stored as JSON in SharedPreferences
}

Common Playlist Issues

Playlist Shows Missing Tracks

Possible causes:

Tracks were deleted from device
Files were moved to different location
MediaStore hasn’t refreshed

Solutions:

Tap the refresh button (↻) on Local Music screen
Remove missing tracks from playlist manually
Re-download missing tracks
Recreate playlist if many tracks are missing

Can't Create New Playlist

Solutions:

Ensure playlist name is unique
Don’t use special characters in playlist names
Keep playlist names under 50 characters
Restart app if issue persists

Imported Playlist is Empty

This is normal: Importing a Deezer playlist creates the structure but doesn’t download tracks.Solutions:

Download tracks from Deezer individually
Or download the entire playlist from Deezer’s playlist view
Tracks will automatically link to the imported playlist

Playlist Won't Delete

Possible causes:

Trying to delete the Favorites playlist (protected)

Solutions:

Favorites playlist cannot be deleted (by design)
For other playlists, try restarting the app
If issue persists, clear app cache in Android settings

Changes Not Saving

Possible causes:

App was force-closed before saving
Storage permission issue

Solutions:

Give app time to save (don’t force-close immediately)
Check app has storage permissions
Ensure device isn’t low on storage
Try making changes again

Advanced Playlist Features

Track Statistics

View playlist statistics:

Track count displayed below playlist name
Total duration shown in playlist header
Storage size when viewing playlist details

Playlist Artwork

Playlist artwork is automatically generated:

Uses artwork from the first track in the playlist
Updates when first track changes
Falls back to default icon if no artwork available

Next Steps

Download More Music

Add more tracks to expand your playlists

Configure Settings

Customize your playback and storage preferences

Get Started

Features

User Guide

Development

​Overview

​Creating New Playlists

​From the Playlists Tab

​From the Player

​From Track Context Menu

​Adding Tracks to Playlists

​Method 1: From Track Menu

​Method 2: During Download

​Method 3: From Player

​Removing Tracks from Playlists

​Editing Playlist Details

​Renaming a Playlist

​Deleting a Playlist

​Importing Deezer Playlists

​Organizing Your Collection

​Playlist Strategies

By Genre

By Mood

By Time Period

By Quality

​Playlist Management Tips

Best Practices

​Playing Playlists

​Standard Play

​Shuffle Play

​Play from Track

​Favorites Playlist

​Adding to Favorites

​Removing from Favorites

​Playlist Storage

​Common Playlist Issues

​Advanced Playlist Features

​Track Statistics

​Playlist Artwork

​Next Steps

Download More Music

Configure Settings

Build docs developers (and LLMs) love

Overview

Creating New Playlists

From the Playlists Tab

From the Player

From Track Context Menu

Adding Tracks to Playlists

Method 1: From Track Menu

Method 2: During Download

Method 3: From Player

Removing Tracks from Playlists

Editing Playlist Details

Renaming a Playlist

Deleting a Playlist

Importing Deezer Playlists

Organizing Your Collection

Playlist Strategies

Playlist Management Tips

Playing Playlists

Standard Play

Shuffle Play

Play from Track

Favorites Playlist

Adding to Favorites

Removing from Favorites

Playlist Storage

Common Playlist Issues

Advanced Playlist Features

Track Statistics

Playlist Artwork

Next Steps