Melotune v1.0.18

* Introduced **Snappy Lists** across the UI — list items now smoothly snap into the viewport for a more polished browsing experience.
* Added the new **Queue System**:

  * **Add to Queue** support.
  * **Play Next** option for better playback control.
* Added **Import** and **Export** buttons for Saved Libraries, making backups and migration easier.
* Removed duplicate entries from search results for cleaner and more accurate searches.

There are two APK variants available:

* **Melotune-X.X.X-nofirebaseRelease.apk**

  * Contains no Firebase, Google services, analytics, or tracking libraries.
  * Suitable for users who prefer a completely telemetry-free experience.

* **Melotune-X.X.X-prodRelease.apk**

  * Includes Firebase Analytics solely for anonymous usage statistics and app analytics.
  * Helps improve the app by providing aggregate usage insights.

> Both APKs are functionally identical. The only difference is the inclusion of analytics in the `prodRelease` build. You can install either version with confidence.

Thank you for using Melotune and helping make it better with your feedback and support!

Author: Harshshah6

app/build.gradle

@@ -13,8 +13,8 @@ android {
         applicationId "com.harsh.shah.saavnmp3"
         minSdk 23
         targetSdk 36
-        versionCode 11
-        versionName '1.0.17'
+        versionCode 12
+        versionName '1.0.18'
 
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
         //Universal APK Supporting All ABIs

app/src/main/java/com/harsh/shah/saavnmp3/activities/ArtistProfileActivity.kt

@@ -27,6 +27,7 @@ import com.harsh.shah.saavnmp3.records.SongResponse.Lyrics
 import com.harsh.shah.saavnmp3.records.SongResponse.Song
 import com.harsh.shah.saavnmp3.utils.MiniPlayerHelper
 import com.harsh.shah.saavnmp3.utils.SharedPreferenceManager
+import com.harsh.shah.saavnmp3.utils.attachSnapHelper
 import com.squareup.picasso.Picasso
 
 class ArtistProfileActivity : AppCompatActivity() {
@@ -58,6 +59,9 @@ class ArtistProfileActivity : AppCompatActivity() {
         binding!!.topSongsRecyclerview.setLayoutManager(LinearLayoutManager(this))
         binding!!.topAlbumsRecyclerview.setLayoutManager(LinearLayoutManager(this))
         binding!!.topSinglesRecyclerview.setLayoutManager(LinearLayoutManager(this))
+        binding!!.topSongsRecyclerview.attachSnapHelper()
+        binding!!.topAlbumsRecyclerview.attachSnapHelper()
+        binding!!.topSinglesRecyclerview.attachSnapHelper()
 
         binding!!.topSongsSeeMore.setOnClickListener { v: View? ->
             startActivity(

app/src/main/java/com/harsh/shah/saavnmp3/activities/DownloadManagerActivity.kt

@@ -1,4 +1,4 @@
-package com.harsh.shah.saavnmp3.activities
+package com.harsh.shah.saavnmp3.activities
 
 import android.os.Bundle
 import android.view.View
@@ -7,6 +7,7 @@ import androidx.recyclerview.widget.LinearLayoutManager
 import com.harsh.shah.saavnmp3.adapters.ActivityDownloadManagerListAdapter
 import com.harsh.shah.saavnmp3.databinding.ActivityDownloadManagerBinding
 import com.harsh.shah.saavnmp3.utils.TrackDownloader
+import com.harsh.shah.saavnmp3.utils.attachSnapHelper
 
 class DownloadManagerActivity : AppCompatActivity() {
     private var binding: ActivityDownloadManagerBinding? = null
@@ -17,6 +18,7 @@ class DownloadManagerActivity : AppCompatActivity() {
         setContentView(binding!!.getRoot())
 
         binding!!.recyclerView.setLayoutManager(LinearLayoutManager(this))
+        binding!!.recyclerView.attachSnapHelper()
         val tracks = TrackDownloader.getDownloadedTracks(this)
         binding!!.recyclerView.setAdapter(
             ActivityDownloadManagerListAdapter(

app/src/main/java/com/harsh/shah/saavnmp3/activities/ListActivity.kt

@@ -32,6 +32,7 @@ import com.harsh.shah.saavnmp3.records.sharedpref.SavedLibraries.Library
 import com.harsh.shah.saavnmp3.utils.MiniPlayerHelper
 import com.harsh.shah.saavnmp3.utils.MusicPlayerManager
 import com.harsh.shah.saavnmp3.utils.SharedPreferenceManager
+import com.harsh.shah.saavnmp3.utils.attachSnapHelper
 import com.harsh.shah.saavnmp3.utils.customview.BottomSheetItemView
 import com.squareup.picasso.Picasso
 
@@ -47,6 +48,7 @@ class ListActivity : AppCompatActivity() {
         MiniPlayerHelper.initMiniPlayer(this)
 
         binding!!.recyclerView.setLayoutManager(LinearLayoutManager(this))
+        binding!!.recyclerView.attachSnapHelper()
         binding!!.addMoreSongs.visibility = View.GONE
 
         Log.i("ListActivity", "onCreate: reached ListActivity")

app/src/main/java/com/harsh/shah/saavnmp3/activities/MainActivity.kt

@@ -51,6 +51,7 @@ import java.util.Calendar
 import androidx.core.net.toUri
 import com.harsh.shah.saavnmp3.utils.MiniPlayerHelper
 import com.harsh.shah.saavnmp3.utils.UpdateUtil
+import com.harsh.shah.saavnmp3.utils.attachSnapHelper
 
 class MainActivity : AppCompatActivity() {
     private var requestStoragePermission: ActivityResultLauncher<Array<String>>? = null
@@ -135,6 +136,12 @@ class MainActivity : AppCompatActivity() {
             )
         )
 
+        // Snap helpers — smooth magnetic scroll on all horizontal lists
+        binding!!.popularSongsRecyclerView.attachSnapHelper()
+        binding!!.popularArtistsRecyclerView.attachSnapHelper()
+        binding!!.popularAlbumsRecyclerView.attachSnapHelper()
+        binding!!.savedRecyclerView.attachSnapHelper()
+
         OverScrollDecoratorHelper.setUpOverScroll(
             binding!!.popularSongsRecyclerView,
             OverScrollDecoratorHelper.ORIENTATION_HORIZONTAL

app/src/main/java/com/harsh/shah/saavnmp3/activities/SavedLibrariesActivity.kt

@@ -4,6 +4,7 @@ import android.annotation.SuppressLint
 import android.os.Bundle
 import android.util.Log
 import android.view.View
+import androidx.activity.result.contract.ActivityResultContracts
 import androidx.appcompat.app.AppCompatActivity
 import androidx.recyclerview.widget.LinearLayoutManager
 import com.google.android.material.bottomsheet.BottomSheetDialog
@@ -17,20 +18,107 @@ import com.harsh.shah.saavnmp3.records.sharedpref.SavedLibraries.Library
 import com.harsh.shah.saavnmp3.utils.SharedPreferenceManager
 import me.everything.android.ui.overscroll.OverScrollDecoratorHelper
 import com.harsh.shah.saavnmp3.utils.MiniPlayerHelper
+import com.harsh.shah.saavnmp3.utils.attachSnapHelper
+import java.io.BufferedReader
+import java.io.InputStreamReader
 import java.text.SimpleDateFormat
 import java.util.Date
 
 class SavedLibrariesActivity : AppCompatActivity() {
     var binding: ActivitySavedLibrariesBinding? = null
     var savedLibraries: SavedLibraries? = null
 
+    private val exportLauncher = registerForActivityResult(
+        ActivityResultContracts.CreateDocument("application/json")
+    ) { uri ->
+        if (uri != null) {
+            try {
+                val sharedPreferenceManager = SharedPreferenceManager.getInstance(this)
+                val savedLibrariesObj = sharedPreferenceManager.savedLibrariesData
+                val exportMap = HashMap<String, Any?>()
+                exportMap["saved_libraries"] = savedLibrariesObj
+
+                val detailsMap = HashMap<String, String>()
+                savedLibrariesObj?.lists?.forEach { lib ->
+                    if (lib != null && lib.id != null) {
+                        val detailJson = sharedPreferenceManager.getJson(lib.id)
+                        if (!detailJson.isNullOrEmpty()) {
+                            detailsMap[lib.id] = detailJson
+                        }
+                    }
+                }
+                exportMap["libraries_details"] = detailsMap
+
+                val exportJson = com.google.gson.Gson().toJson(exportMap)
+                contentResolver.openOutputStream(uri)?.use { outputStream ->
+                    outputStream.write(exportJson.toByteArray())
+                }
+                Snackbar.make(binding!!.getRoot(), "Library exported successfully", Snackbar.LENGTH_SHORT).show()
+            } catch (e: Exception) {
+                Log.e("SavedLibrariesActivity", "Export failed", e)
+                Snackbar.make(binding!!.getRoot(), "Export failed: ${e.message}", Snackbar.LENGTH_SHORT).show()
+            }
+        }
+    }
+
+    private val importLauncher = registerForActivityResult(
+        ActivityResultContracts.OpenDocument()
+    ) { uri ->
+        if (uri != null) {
+            try {
+                contentResolver.openInputStream(uri)?.use { inputStream ->
+                    val reader = BufferedReader(InputStreamReader(inputStream))
+                    val stringBuilder = StringBuilder()
+                    var line: String?
+                    while (reader.readLine().also { line = it } != null) {
+                        stringBuilder.append(line)
+                    }
+                    val importJson = stringBuilder.toString()
+                    val gson = com.google.gson.Gson()
+                    val type = object : com.google.gson.reflect.TypeToken<HashMap<String, Any?>>() {}.type
+                    val importMap = gson.fromJson<HashMap<String, Any?>>(importJson, type)
+
+                    val savedLibrariesJson = gson.toJson(importMap["saved_libraries"])
+                    val importedSavedLibraries = gson.fromJson(savedLibrariesJson, SavedLibraries::class.java)
+
+                    val detailsJson = gson.toJson(importMap["libraries_details"])
+                    val importedDetails = gson.fromJson<HashMap<String, String>>(detailsJson, object : com.google.gson.reflect.TypeToken<HashMap<String, String>>() {}.type)
+
+                    val sharedPreferenceManager = SharedPreferenceManager.getInstance(this)
+                    val currentSavedLibraries = sharedPreferenceManager.savedLibrariesData ?: SavedLibraries(ArrayList())
+                    val currentLists = currentSavedLibraries.lists ?: ArrayList()
+
+                    importedSavedLibraries?.lists?.forEach { importedLib ->
+                        if (importedLib != null && importedLib.id != null) {
+                            if (currentLists.none { it?.id == importedLib.id }) {
+                                currentLists.add(importedLib)
+                            }
+                            val detailJson = importedDetails?.get(importedLib.id)
+                            if (!detailJson.isNullOrEmpty()) {
+                                sharedPreferenceManager.putJson(importedLib.id, detailJson)
+                            }
+                        }
+                    }
+
+                    sharedPreferenceManager.savedLibrariesData = SavedLibraries(currentLists)
+                    showData(sharedPreferenceManager)
+                    Snackbar.make(binding!!.getRoot(), "Library imported successfully", Snackbar.LENGTH_SHORT).show()
+                }
+            } catch (e: Exception) {
+                Log.e("SavedLibrariesActivity", "Import failed", e)
+                Snackbar.make(binding!!.getRoot(), "Import failed: ${e.message}", Snackbar.LENGTH_SHORT).show()
+            }
+        }
+    }
+
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         binding = ActivitySavedLibrariesBinding.inflate(layoutInflater)
         setContentView(binding!!.getRoot())
         MiniPlayerHelper.initMiniPlayer(this)
 
         binding!!.recyclerView.setLayoutManager(LinearLayoutManager(this))
+        binding!!.recyclerView.attachSnapHelper()
         OverScrollDecoratorHelper.setUpOverScroll(
             binding!!.recyclerView,
             OverScrollDecoratorHelper.ORIENTATION_VERTICAL
@@ -81,6 +169,14 @@ class SavedLibrariesActivity : AppCompatActivity() {
             bottomSheetDialog.show()
         })
 
+        binding?.importLibrary?.setOnClickListener {
+            importLauncher.launch(arrayOf("application/json"))
+        }
+
+        binding?.exportLibrary?.setOnClickListener {
+            exportLauncher.launch("saavn_library.json")
+        }
+
         showData()
     }
 

app/src/main/java/com/harsh/shah/saavnmp3/activities/SearchActivity.kt

@@ -27,6 +27,7 @@ import com.harsh.shah.saavnmp3.records.GlobalSearch
 import com.harsh.shah.saavnmp3.records.GlobalSearch.Data.TopQuery
 import com.harsh.shah.saavnmp3.utils.MiniPlayerHelper
 import com.harsh.shah.saavnmp3.utils.SharedPreferenceManager
+import com.harsh.shah.saavnmp3.utils.attachSnapHelper
 import me.everything.android.ui.overscroll.OverScrollDecoratorHelper
 import java.util.Locale
 import androidx.core.net.toUri
@@ -47,6 +48,7 @@ class SearchActivity : AppCompatActivity() {
 
         OverScrollDecoratorHelper.setUpOverScroll(binding!!.hscrollview)
         binding!!.recyclerView.setLayoutManager(LinearLayoutManager(this))
+        binding!!.recyclerView.attachSnapHelper()
 
         binding!!.edittext.requestFocus()
 
@@ -205,7 +207,10 @@ class SearchActivity : AppCompatActivity() {
         } else {
             throw IllegalStateException("Unexpected value: " + binding!!.chipGroup.checkedChipId)
         }
-        if (!data.isEmpty()) binding!!.recyclerView.setAdapter(ActivitySearchListItemAdapter(data.filterNotNull().toMutableList()))
+        if (!data.isEmpty()) {
+            val uniqueData = data.filterNotNull().distinctBy { it.id }.toMutableList()
+            binding!!.recyclerView.setAdapter(ActivitySearchListItemAdapter(uniqueData))
+        }
     }
 
     private fun addSongsData(data: MutableList<SearchListItem?>) {

app/src/main/java/com/harsh/shah/saavnmp3/adapters/ActivitySearchListItemAdapter.kt

@@ -47,7 +47,60 @@ class ActivitySearchListItemAdapter(private val data: MutableList<SearchListItem
         val item = data[position]
 
         (holder.itemView.findViewById<View?>(R.id.title) as TextView).text = item.title()
-        (holder.itemView.findViewById<View?>(R.id.artist) as TextView).text = item.subtitle()
+        
+        val typePrefix = when (item.type) {
+            SearchListItem.Type.SONG -> "Song"
+            SearchListItem.Type.ALBUM -> "Album"
+            SearchListItem.Type.PLAYLIST -> "Playlist"
+            SearchListItem.Type.ARTIST -> "Artist"
+            else -> ""
+        }
+        val formattedSubtitle = if (typePrefix.isNotEmpty() && !item.subtitle().isNullOrEmpty()) {
+            "$typePrefix • ${item.subtitle()}"
+        } else if (typePrefix.isNotEmpty()) {
+            typePrefix
+        } else {
+            item.subtitle()
+        }
+        (holder.itemView.findViewById<View?>(R.id.artist) as TextView).text = formattedSubtitle
+
+        val coverCard = holder.itemView.findViewById<com.google.android.material.card.MaterialCardView>(R.id.coverCard)
+        if (coverCard != null) {
+            val radiusRes = if (item.type == SearchListItem.Type.ARTIST) {
+                com.intuit.sdp.R.dimen._20sdp
+            } else {
+                com.intuit.sdp.R.dimen._4sdp
+            }
+            coverCard.radius = coverCard.context.resources.getDimension(radiusRes)
+        }
+
+        val moreIcon = holder.itemView.findViewById<ImageView>(R.id.more)
+        if (item.type == SearchListItem.Type.SONG) {
+            moreIcon.visibility = View.VISIBLE
+            moreIcon.setOnClickListener { v ->
+                val popup = androidx.appcompat.widget.PopupMenu(v.context, v)
+                popup.menu.add("Play Next")
+                popup.menu.add("Add to Queue")
+                popup.setOnMenuItemClickListener { menuItem ->
+                    when (menuItem.title) {
+                        "Play Next" -> {
+                            MusicPlayerManager.playNext(item.id)
+                            android.widget.Toast.makeText(v.context, "Song will play next", android.widget.Toast.LENGTH_SHORT).show()
+                            true
+                        }
+                        "Add to Queue" -> {
+                            MusicPlayerManager.addToQueue(item.id)
+                            android.widget.Toast.makeText(v.context, "Song added to queue", android.widget.Toast.LENGTH_SHORT).show()
+                            true
+                        }
+                        else -> false
+                    }
+                }
+                popup.show()
+            }
+        } else {
+            moreIcon.visibility = View.GONE
+        }
 
         Picasso.get().load(item.coverImage?.toUri())
             .into((holder.itemView.findViewById<View?>(R.id.coverImage) as ImageView?))