feat: support to parse lyrics

Author: zeevenn

README.md

@@ -11,7 +11,7 @@ A powerful React Native library for accessing local music files with full metada
 
 ## Features & Roadmap
 
-- [x] 🎵 Access local music library with rich metadata
+- [x] 🎵 Access local music library with rich metadata(including lyrics)
 - [x] 🚀 Built with TurboModules for maximum performance
 - [x] 📄 Pagination support for large music collections  
 - [x] 🔍 Flexible sorting and filtering options
@@ -122,10 +122,11 @@ console.log('Has more:', customResult.hasNextPage);
 interface Track {
   id: string;
   title: string;           // Track title
-  artwork: string;         // Artwork file URI
-  artist: string;          // Artist name
-  album: string;           // Album name
-  genre: string;           // Music genre
+  artist?: string;         // Artist name
+  artwork?: string;        // Artwork file URI
+  album?: string;          // Album name
+  genre?: string;          // Music genre
+  lyrics?: string          // Lyrics
   duration: number;        // Duration in seconds
   url: string;             // File URL or path
   createdAt?: number;      // Date added (Unix timestamp)

README_ZH.md

@@ -11,7 +11,7 @@
 
 ## 特性与路线图
 
-- [x] 🎵 访问本地音乐库并获取丰富的元数据
+- [x] 🎵 访问本地音乐库并获取丰富的元数据（包括歌词）
 - [x] 🚀 基于 TurboModules 构建，性能卓越
 - [x] 📄 支持大型音乐集合的分页功能
 - [x] 🔍 灵活的排序和过滤选项
@@ -122,10 +122,11 @@ console.log('是否还有更多:', customResult.hasNextPage);
 interface Track {
   id: string;
   title: string;           // 曲目标题
-  artwork: string;         // 专辑封面 URI
-  artist: string;          // 艺术家名称
-  album: string;           // 专辑名称
-  genre: string;           // 音乐类型
+  artist?: string;         // 艺术家名称
+  artwork?: string;        // 专辑封面 URI
+  album?: string;          // 专辑名称
+  genre?: string;          // 音乐流派
+  lyrics?: string;         // 歌词
   duration: number;        // 持续时间（秒）
   url: string;             // 文件 URL 或路径
   createdAt?: number;      // 添加日期（Unix 时间戳）

android/build.gradle

@@ -74,6 +74,7 @@ def kotlin_version = getExtOrDefault("kotlinVersion")
 dependencies {
   implementation "com.facebook.react:react-android"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+  implementation("net.jthink:jaudiotagger:3.0.1")
 }
 
 react {

android/src/main/java/com/musiclibrary/models/Assets.kt

@@ -3,10 +3,11 @@ package com.musiclibrary.models
 data class Track(
   val id: String,
   val title: String,
-  val artwork: String,
-  val artist: String,
-  val album: String,
-  val genre: String,
+  val artist: String? = null,
+  val artwork: String? = null,
+  val album: String? = null,
+  val genre: String? = null,
+  val lyrics: String? = null,
   val duration: Double,
   val url: String,
   val createdAt: Long? = null,

android/src/main/java/com/musiclibrary/tracks/GetTracksQuery.kt

@@ -7,8 +7,30 @@ import android.net.Uri
 import android.provider.DocumentsContract
 import com.musiclibrary.models.*
 import androidx.core.net.toUri
+import java.io.File
+import org.jaudiotagger.audio.AudioFileIO
+import org.jaudiotagger.tag.FieldKey
+import java.util.concurrent.Executors
+import java.util.concurrent.TimeUnit
 
 object GetTracksQuery {
+  // Create a thread pool
+  private val executor = Executors.newFixedThreadPool(4)
+
+  private fun getAudioTagInfo(filePath: String): Pair<String?, String?> {
+    return try {
+      val audioFile = AudioFileIO.read(File(filePath))
+      val tag = audioFile.tag
+      
+      // Try to read the genre and lyrics from the tag
+      val genre = tag?.getFirst(FieldKey.GENRE)
+      val lyrics = tag?.getFirst(FieldKey.LYRICS)
+      
+      Pair(genre, lyrics)
+    } catch (e: Exception) {
+      Pair(null, null)
+    }
+  }
 
   fun getTracks(
     contentResolver: ContentResolver,
@@ -23,8 +45,7 @@ object GetTracksQuery {
       MediaStore.Audio.Media.DATA,
       MediaStore.Audio.Media.DATE_ADDED,
       MediaStore.Audio.Media.SIZE,
-      MediaStore.Audio.Media.ALBUM_ID,
-      MediaStore.Audio.Media.GENRE
+      MediaStore.Audio.Media.ALBUM_ID
     )
 
     val selection = buildSelection(options)
@@ -53,8 +74,6 @@ object GetTracksQuery {
       val dataColumn = c.getColumnIndexOrThrow(MediaStore.Audio.Media.DATA)
       val dateAddedColumn = c.getColumnIndexOrThrow(MediaStore.Audio.Media.DATE_ADDED)
       val sizeColumn = c.getColumnIndexOrThrow(MediaStore.Audio.Media.SIZE)
-      val genreColumn = c.getColumnIndexOrThrow(MediaStore.Audio.Media.GENRE)
-      val albumIdColumn = c.getColumnIndexOrThrow(MediaStore.Audio.Media.ALBUM_ID)
 
       // Jump to the specified start position
       val foundAfter = if (options.after == null) {
@@ -78,50 +97,80 @@ object GetTracksQuery {
       var count = 0
       val maxItems = options.first.coerceAtMost(1000) // Limit the maximum number of queries
 
+      val trackPaths = mutableListOf<Pair<String, String>>() // (id, path) pairs
+
       while (foundAfter && count < maxItems) {
         try {
           val id = c.getLong(idColumn)
-          val title = c.getString(titleColumn) ?: ""
-          val artist = c.getString(artistColumn) ?: "Unknown Artist"
-          val album = c.getString(albumColumn) ?: "Unknown Album"
-          val duration = c.getLong(durationColumn) / 1000.0 // Convert to seconds
           val data = c.getString(dataColumn) ?: ""
-          val dateAdded = c.getLong(dateAddedColumn)
-          val fileSize = c.getLong(sizeColumn)
-          val genre = c.getString(genreColumn) ?: ""
-          val albumId = c.getLong(albumIdColumn)
-          val artworkUri: Uri = "content://media/external/audio/media/${id}/albumart".toUri()
 
           // Skip invalid data
           if (data.isEmpty()) {
             continue
           }
 
+          val title = c.getString(titleColumn) ?: ""
+          val artist = c.getString(artistColumn)
+          val album = c.getString(albumColumn)
+          val duration = c.getLong(durationColumn) / 1000.0 // Convert to seconds
+          val dateAdded = c.getLong(dateAddedColumn)
+          val fileSize = c.getLong(sizeColumn)
+          val artworkUri: Uri = "content://media/external/audio/media/${id}/albumart".toUri()
+
+          // Create a Track without lyrics and genre
           val track = Track(
             id = id.toString(),
             title = title,
-            artwork = artworkUri.toString(),
             artist = artist,
+            artwork = artworkUri.toString(),
             album = album,
-            genre = genre,
+            genre = null,
             duration = duration,
             url = "file://$data",
             createdAt = dateAdded * 1000, // Convert to milliseconds
             modifiedAt = dateAdded * 1000, // Convert to milliseconds
-            fileSize = fileSize
+            fileSize = fileSize,
+            lyrics = null
           )
 
           tracks.add(track)
+          trackPaths.add(id.toString() to data)
           endCursor = id.toString()
           count++
         } catch (e: Exception) {
-          // Continue processing other tracks if a single track fails to parse
           continue
         }
 
         if (!cursor.moveToNext()) break
       }
 
+      // Batch process tag information loading
+      val futures = trackPaths.map { (id, path) ->
+        executor.submit<Pair<String, Pair<String?, String?>>> {
+          val tagInfo = getAudioTagInfo(path)
+          Pair(id, tagInfo)
+        }
+      }
+
+      // Wait for all tag information to be loaded
+      futures.forEach { future ->
+        try {
+          val result = future.get(5, TimeUnit.SECONDS)
+          val id = result.first
+          val (genre, lyrics) = result.second
+          val index = tracks.indexOfFirst { it.id == id }
+          if (index != -1) {
+            val track = tracks[index]
+            tracks[index] = track.copy(
+              genre = genre,
+              lyrics = lyrics
+            )
+          }
+        } catch (e: Exception) {
+          // If the loading times out or fails, keep the original value
+        }
+      }
+
       // Check if there are more data
       hasNextPage = !c.isAfterLast
     }
@@ -199,12 +248,6 @@ object GetTracksQuery {
         "duration" -> MediaStore.Audio.Media.DURATION
         "created_at" -> MediaStore.Audio.Media.DATE_ADDED
         "modified_at" -> MediaStore.Audio.Media.DATE_MODIFIED
-        "genre" -> if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
-          MediaStore.Audio.Media.GENRE
-        } else {
-          null
-        }
-
         "track_count" -> MediaStore.Audio.Media.TRACK
         else -> throw IllegalArgumentException("Unsupported SortKey: ${parts[0]}")
       }

android/src/main/java/com/musiclibrary/utils/DataConverter.kt

@@ -10,10 +10,11 @@ object DataConverter {
     val map = Arguments.createMap()
     map.putString("id", track.id)
     map.putString("title", track.title)
-    map.putString("artwork", track.artwork)
-    map.putString("artist", track.artist)
-    map.putString("album", track.album)
-    map.putString("genre", track.genre)
+    track.artist?.let { map.putString("artist", it) }
+    track.artwork?.let { map.putString("artwork", it) }
+    track.album?.let { map.putString("album", it) }
+    track.genre?.let { map.putString("genre", it) }
+    track.lyrics?.let { map.putString("lyrics", it) }
     map.putDouble("duration", track.duration)
     map.putString("url", track.url)
     map.putLong("fileSize", track.fileSize)