timusus/ktaglib

Taglib Kotlin Library

KTagLib

Kotlin bindings for TagLib

Gradle:

Step 1. Add the Jitpack repository to the root build.gradle

allprojects {
	repositories {
		...
		maven { url 'https://jitpack.io' }
	}
}

Step 2. Add the dependency

dependencies {
    implementation("com.github.timusus:KTagLib:release-SNAPSHOT") // or kTagLib:1.4
}

See the sample app for an example of reading tags, using the Storage Access Framework.

Usage

Read Tags

Read the tags from a file descriptor:

KTagLib().getMetadata(fileDescriptor: Int)

This returns a Metadata object, containing the tags and audio properties of the audio file located at fileDescriptor, or null if none are found

Retrieve Artwork

KTagLib().getArtwork(fileDescriptor: Int)

Returns a ByteArray (or null) representing the image data of the largest image found.

Write Tags

fun writeMetadata(
    fileDescriptor: Int,
    properties : HashMap<String, ArrayList<String>>
): Boolean

Attempts to write the tags supplied via the map to the file located at fileDescriptor. Existing tags with the same key are replaced.

Returns true if the tags are successfully updated.

ktaglib's Issues

Use HashMap for retrieving and writing tag fields

Instead of directly creating an AudioFile in the JNI from TagLib's PropertyMap, it is better to convert it into a Java/Kotlin HashMap.
The HashMap can be mapped in the Kotlin code to produce an AudioFile. This way any new tag fields can be supported or removed by only changing the Kotlin code. This is beneficial as the JNI code does not provide any compile time safety. Errors in the JNI code will lead to runtime crashes whereas the compiler will catch a large number of errors at the compile time. @timusus Thoughts ?

Overwrite / Save Artwork

I see we have the getArtwork method available but how do I replace or add a new artwork to the file?