Skip to main content

​
Overview

The Settings screen allows you to customize Deeztracker Mobile’s behavior, audio quality, storage location, language, and manage your account. Access Settings by tapping the gear icon in the bottom navigation bar.

​
Audio Quality Preferences

Configure the audio quality for your downloads:
1

Navigate to Audio Settings

Open Settings and locate the Audio Quality section.
2

Select Quality

Tap “Audio Quality” to open the quality selector dropdown.
3

Choose Your Preferred Quality

Select from three options:
  • FLAC: Lossless audio, largest file size
  • MP3_320: High quality 320kbps MP3
  • MP3_128: Standard quality 128kbps MP3 (default)
SettingsScreen.kt:98-118
SettingItem(
    title = stringResource(R.string.settings_audio_quality_title),
    value = audioQuality.name,
    onClick = { showQualityDropdown = true }
) {
    DropdownMenu(
        expanded = showQualityDropdown,
        onDismissRequest = { showQualityDropdown = false },
        modifier = Modifier.background(SurfaceDark)
    ) {
        DownloadQuality.values().forEach { quality ->
            DropdownMenuItem(
                text = { Text(quality.name, color = Color.White) },
                onClick = {
                    viewModel.setAudioQuality(quality)
                    showQualityDropdown = false
                }
            )
        }
    }
}

​
Quality Comparison

QualityBitrateApprox. Size per MinuteQuality LevelPremium Required?
FLAC~1000 kbps~7-8 MBLosslessYes
MP3_320320 kbps~2.5 MBHighYes
MP3_128128 kbps~1 MBStandardNo
Premium Account Required: FLAC and 320kbps MP3 downloads require a Deezer Premium subscription. If you select these qualities with a free account, downloads will fail.See the premium warning displayed in the app:
SettingsScreen.kt:123-142
item {
    Row(verticalAlignment = Alignment.CenterVertically) {
        Icon(
            imageVector = Icons.Default.Info,
            contentDescription = null,
            tint = TextGray,
            modifier = Modifier.size(16.dp)
        )
        Spacer(modifier = Modifier.width(4.dp))
        Text(
            text = stringResource(R.string.settings_premium_warning),
            color = TextGray,
            fontSize = 12.sp,
            lineHeight = 16.sp
        )
    }
}

​
Choosing the Right Quality

Best for:
  • Audiophiles with high-end audio equipment
  • Archiving music in highest quality
  • When storage space is not a concern
Consider:
  • Files are 5-7x larger than MP3 128kbps
  • Requires Premium account
  • Longer download times
Best for:
  • High-quality listening on good headphones/speakers
  • Balance between quality and file size
  • Most users’ sweet spot
Consider:
  • Requires Premium account
  • 2-3x larger than 128kbps
  • Excellent quality for most listening scenarios
Best for:
  • Free Deezer accounts
  • Limited device storage
  • Mobile data downloads
  • Casual listening
Consider:
  • Works with free accounts
  • Smallest file size
  • Acceptable quality for most casual listening

​
Download Location

Choose where downloaded music is saved on your device:
1

Open Storage Settings

In Settings, find the Storage section.
2

Select Download Location

Tap “Download Location” to open the location selector.
3

Choose Folder

Select between two options:
  • Music folder: /Music/Deeztracker/ (default)
  • Downloads folder: /Download/Deeztracker/
SettingsScreen.kt:190-215
SettingItem(
    title = stringResource(R.string.settings_download_location_title),
    value = if (downloadLocation == "MUSIC") 
        stringResource(R.string.settings_location_music) 
        else stringResource(R.string.settings_location_downloads),
    onClick = { showLocationDropdown = true }
) {
    DropdownMenu(
        expanded = showLocationDropdown,
        onDismissRequest = { showLocationDropdown = false },
        modifier = Modifier.background(SurfaceDark)
    ) {
        DropdownMenuItem(
            text = { Text(stringResource(R.string.settings_location_music), color = Color.White) },
            onClick = {
                viewModel.setDownloadLocation("MUSIC")
                showLocationDropdown = false
            }
        )

​
Location Details

LocationPathBest For
Music folder/sdcard/Music/Deeztracker/Integration with music apps, organized music library
Downloads folder/sdcard/Download/Deeztracker/Easy access via file manager, temporary storage
Changing the download location only affects future downloads. Existing files remain in their current location. You’ll need to manually move files if you want everything in the new location.

​
File Access Permissions

On Android 11+, Deeztracker requires All Files Access permission:
SettingsScreen.kt:290-349
@Composable
fun PermissionSettingItem() {
    val context = LocalContext.current
    val hasPermission = remember { mutableStateOf(PermissionHelper.hasAllFilesAccess()) }
    
    // Permission status display and grant button
    Row(
        modifier = Modifier.fillMaxWidth()
            .clip(RoundedCornerShape(12.dp))
            .background(SurfaceDark)
            .padding(16.dp),
        horizontalArrangement = Arrangement.SpaceBetween
    ) {
        Column(modifier = Modifier.weight(1f)) {
            Text(
                text = stringResource(R.string.settings_all_files_access),
                color = Color.White,
                fontSize = 16.sp
            )
            Spacer(modifier = Modifier.height(4.dp))
            Text(
                text = if (hasPermission.value) {
                    stringResource(R.string.settings_permission_granted)
                } else {
                    stringResource(R.string.settings_permission_not_granted)
                },
                color = if (hasPermission.value) Color(0xFF4CAF50) else TextGray,
                fontSize = 12.sp
            )
        }
        
        if (!hasPermission.value) {
            Button(
                onClick = { PermissionHelper.requestAllFilesAccess(context) },
                colors = ButtonDefaults.buttonColors(containerColor = Primary),
                shape = RoundedCornerShape(8.dp)
            ) {
                Text(stringResource(R.string.settings_grant_permission), fontSize = 14.sp)
            }
        }
    }
}
Permission Required: Without “All Files Access” permission, downloads will fail on Android 11 and newer. The Settings screen shows permission status and provides a button to grant access.

​
Language Selection

Deeztracker Mobile supports multiple languages:
1

Open Language Settings

In Settings, find the General section.
2

Select Language

Tap “Language” to open the language selector.
3

Choose Your Language

Currently supported languages:
  • English (English)
  • Español (Spanish)
4

Restart App

The app will automatically restart to apply the new language.
SettingsScreen.kt:154-176
SettingItem(
    title = stringResource(R.string.settings_language_title),
    value = language,
    onClick = { showLanguageDropdown = true }
) {
    DropdownMenu(
        expanded = showLanguageDropdown,
        onDismissRequest = { showLanguageDropdown = false },
        modifier = Modifier.background(SurfaceDark)
    ) {
        LanguageHelper.getAllDisplayNames().forEach { lang ->
            DropdownMenuItem(
                text = { Text(lang, color = Color.White) },
                onClick = {
                    viewModel.setLanguage(lang)
                    showLanguageDropdown = false
                    (context as? android.app.Activity)?.recreate()
                }
            )
        }
    }
}
Changing the language requires restarting the app to apply all translations throughout the interface.

​
App Preferences and Configuration

​
Settings Storage

All settings are persisted locally using SharedPreferences:
SettingsViewModel.kt
class SettingsViewModel : ViewModel() {
    private val prefs = context.getSharedPreferences("app_settings", Context.MODE_PRIVATE)
    
    fun setAudioQuality(quality: DownloadQuality) {
        prefs.edit().putString("audio_quality", quality.name).apply()
    }
    
    fun setDownloadLocation(location: String) {
        prefs.edit().putString("download_location", location).apply()
    }
}

​
Theme

Deeztracker Mobile uses a dark theme optimized for music apps:
  • Background: Dark black (#121212)
  • Surface: Slightly lighter dark (#1E1E1E)
  • Primary accent: Blue (#0066FF)
  • Text colors: White and gray for contrast
Currently, only dark mode is supported. Light theme may be added in future updates.

​
Data Management

​
Clear Cache

To clear app cache:
  1. Go to Android Settings → Apps → Deeztracker
  2. Tap Storage
  3. Tap Clear Cache
Clearing cache removes:
  • Cached album artwork
  • Cached lyrics
  • Temporary files
It does NOT remove:
  • Downloaded music files
  • Playlists
  • ARL token
  • Settings

​
Reset App Data

To completely reset the app:
  1. Go to Android Settings → Apps → Deeztracker
  2. Tap Storage
  3. Tap Clear Data or Clear Storage
Destructive Action: Clearing app data removes:
  • Your ARL token (you’ll need to log in again)
  • All playlists
  • All settings
  • Favorites
Downloaded music files remain on your device but will need to be re-scanned.

​
Logging Out

To log out of your Deezer account:
1

Open Settings

Navigate to the Settings screen.
2

Scroll to Bottom

Scroll down to find the Logout button.
3

Tap Logout

Tap the red “Logout” button.
4

Confirm

Your ARL token is cleared, and you return to the login screen.
SettingsScreen.kt:237-254
item {
    Button(
        onClick = {
            viewModel.logout()
            onLogout()
        },
        modifier = Modifier
            .fillMaxWidth()
            .height(50.dp),
        colors = ButtonDefaults.buttonColors(
            containerColor = Color(0xFFCF6679) // Reddish color for logout
        ),
        shape = RoundedCornerShape(12.dp)
    ) {
        Icon(Icons.Default.Logout, contentDescription = null, tint = Color.White)
        Spacer(modifier = Modifier.width(8.dp))
        Text(stringResource(R.string.settings_logout), color = Color.White, fontWeight = FontWeight.Bold)
    }
}
Logging out only removes your ARL token from the app. It does not:
  • Delete downloaded music
  • Remove playlists
  • Clear settings preferences
  • Affect your Deezer account
You can log back in anytime with the same or a different ARL token.

​
Settings Structure

The Settings screen is organized into sections: 
Settings
├── Audio
│   └── Audio Quality (FLAC/MP3_320/MP3_128)
│       └── Premium warning
├── General
│   └── Language (English/Español)
├── Storage
│   └── Download Location (Music/Downloads)
├── Permissions
│   └── All Files Access (Grant/Granted)
└── Account
    └── Logout Button

​
Common Settings Issues

Possible causes:
  • Setting was changed after downloads already started
  • App didn’t save the preference
Solutions:
  1. Change quality before starting downloads
  2. Existing downloads continue with original quality
  3. Restart app if setting doesn’t seem to save
  4. Check that new downloads use the correct quality
Possible causes:
  • Missing storage permissions
  • External SD card not accessible
Solutions:
  1. Grant “All Files Access” permission first
  2. Only internal storage locations are supported
  3. Ensure the target folder is writable
Solutions:
  1. App should restart automatically after language change
  2. If not, manually close and reopen the app
  3. Some system text may remain in device language
Solutions:
  1. Manually grant permission:
    • Android Settings → Apps → Deeztracker
    • Permissions → Files and Media
    • Select “Allow management of all files”
  2. Return to app and refresh permission status
Rare issue: Sometimes app updates can reset settings.Solutions:
  1. Re-configure your preferred settings
  2. Your ARL token should persist
  3. Playlists should remain intact
  4. Downloaded files are unaffected

​
Tips for Optimal Configuration

Recommended Settings

For Premium Users:
  • Quality: MP3 320kbps (best balance of quality and size)
  • Location: Music folder (better integration)
  • Grant all permissions immediately
For Free Users:
  • Quality: MP3 128kbps (only option)
  • Location: Music folder
  • Monitor storage space regularly
For Audiophiles:
  • Quality: FLAC
  • Location: Music folder
  • Ensure ample storage (FLAC files are large)
  • Use high-quality playback equipment

​
Next Steps

Start Downloading

Apply your quality settings and start downloading music

Authentication

Learn more about managing your ARL token

Build docs developers (and LLMs) love

Get started for freeTalk to us