SkillAgentSearch skills...

MediainfoAndroid

An Android library wrapper for MediaInfoLib, providing comprehensive media file analysis capabilities. Extract detailed technical and tag information from video, audio, and image files directly in your Android app.

GenerateConvertImprove

Install / Use

/learn @marlboro-advance/MediainfoAndroid
About this skill

Quality Score

0/100

Supported Platforms

Universal

README

MediaInfo Android Library

Android Build CI

An Android library wrapper for MediaInfoLib, providing comprehensive media file analysis capabilities. Extract detailed technical and tag information from video, audio, and image files directly in your Android app.

Features

  • Complete Media Analysis - Get detailed information about video, audio, text, and other streams
  • Multiple Output Formats - XML, JSON, Text, HTML, PBCore, EBUCore
  • Easy to Use - Simple API with both high-level utilities and low-level access
  • Native Performance - Built on top of the robust MediaInfoLib C++ library
  • Android Optimized - Supports all major architectures (arm64-v8a, armeabi-v7a, x86, x86_64)
  • Modern Android - Supports Android 5.0 (API 21) and above

Installation

Step 1: Add JitPack repository

Add the JitPack repository to your project's settings.gradle or settings.gradle.kts:

Groovy (settings.gradle):

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
}

Kotlin (settings.gradle.kts):

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://jitpack.io") }
    }
}

Step 2: Add the dependency

Add the MediaInfo library to your app's build.gradle or build.gradle.kts:

Groovy (build.gradle):

dependencies {
    implementation 'com.github.marlboro-advance:mediainfoAndroid:v1.0.0-fix'
}

Kotlin (build.gradle.kts):

dependencies {
    implementation("com.github.marlboro-advance:mediainfoAndroid:v1.0.0-fix")
}

Quick Start

Using the Simple Utility API

The easiest way to get media information is using the MediaInfoUtil class:

package com.example.mediainfo

import android.net.Uri
import android.os.ParcelFileDescriptor
import net.mediaarea.mediainfo.lib.MediaInfoUtil

fun getMediaInfo(uri: Uri) {
    val pfd: ParcelFileDescriptor? = contentResolver.openFileDescriptor(uri, "r")
    val fd = pfd?.detachFd() ?: return
    
    try {
        // Get XML output (recommended format)
        val xmlOutput = MediaInfoUtil.getMediaInfoXml(fd, "video.mp4")
        println(xmlOutput)
    } finally {
        pfd?.close()
    }
}

Get Different Output Formats

package com.example.mediainfo

import net.mediaarea.mediainfo.lib.MediaInfoUtil

// XML format (most detailed)
val xmlOutput = MediaInfoUtil.getMediaInfo(fd, "video.mp4", "MIXML")

// JSON format
val jsonOutput = MediaInfoUtil.getMediaInfo(fd, "video.mp4", "JSON")

// Human-readable text (like MediaInfo desktop app)
val textOutput = MediaInfoUtil.getMediaInfo(fd, "video.mp4", "Text")

// HTML format
val htmlOutput = MediaInfoUtil.getMediaInfo(fd, "video.mp4", "HTML")

Check Library Version

package com.example.mediainfo

import net.mediaarea.mediainfo.lib.MediaInfoUtil

val version = MediaInfoUtil.getVersion()
println("MediaInfo version: $version")

Advanced Usage

Using the Low-Level API

For more control and to query specific parameters:

package com.example.mediainfo

import net.mediaarea.mediainfo.lib.MediaInfo

val mi = MediaInfo()

// Open file
mi.Open(fd, "video.mp4")

// Get general information
val format = mi.Get(MediaInfo.Stream.General, 0, "Format")
val duration = mi.Get(MediaInfo.Stream.General, 0, "Duration")
val fileSize = mi.Get(MediaInfo.Stream.General, 0, "FileSize")

// Get video stream information
val videoCount = mi.Count_Get(MediaInfo.Stream.Video)
if (videoCount > 0) {
    val videoFormat = mi.Get(MediaInfo.Stream.Video, 0, "Format")
    val width = mi.Get(MediaInfo.Stream.Video, 0, "Width")
    val height = mi.Get(MediaInfo.Stream.Video, 0, "Height")
    val frameRate = mi.Get(MediaInfo.Stream.Video, 0, "FrameRate")
    val bitRate = mi.Get(MediaInfo.Stream.Video, 0, "BitRate")
    
    println("Video: $videoFormat ${width}x${height} @ $frameRate fps, $bitRate bps")
}

// Get audio stream information
val audioCount = mi.Count_Get(MediaInfo.Stream.Audio)
for (i in 0 until audioCount) {
    val audioFormat = mi.Get(MediaInfo.Stream.Audio, i, "Format")
    val channels = mi.Get(MediaInfo.Stream.Audio, i, "Channels")
    val sampleRate = mi.Get(MediaInfo.Stream.Audio, i, "SamplingRate")
    
    println("Audio $i: $audioFormat, $channels channels, $sampleRate Hz")
}

// Get human-readable text output
mi.Option("Inform", "Text")
val textReport = mi.Inform()
println(textReport)

// Close
mi.Close()

Output Format Options

The library supports multiple output formats through the Inform option:

| Format | Description | Use Case | |-----------|----------------------|----------------------------------| | Text | Human-readable text | Display to users, logs | | MIXML | MediaInfo XML format | Structured parsing (recommended) | | JSON | JSON format | API integration, web apps | | HTML | HTML format | Web pages, reports | | XML | Alternative XML | Legacy compatibility | | PBCore | PBCore 2.0 XML | Broadcasting metadata | | EBUCore | EBUCore 1.8 XML | European broadcast standard |

Example with custom format:

package com.example.mediainfo

import net.mediaarea.mediainfo.lib.MediaInfo

val mi = MediaInfo()
mi.Open(fd, "video.mp4")

// Get text format output
mi.Option("Inform", "Text")
val textOutput = mi.Inform()

// Get JSON format output
mi.Option("Inform", "JSON")
val jsonOutput = mi.Inform()

mi.Close()

Stream Types

The library supports the following stream types:

  • MediaInfo.Stream.General - General container information
  • MediaInfo.Stream.Video - Video stream data
  • MediaInfo.Stream.Audio - Audio stream data
  • MediaInfo.Stream.Text - Subtitle/caption data
  • MediaInfo.Stream.Image - Image data
  • MediaInfo.Stream.Menu - Menu/chapter data
  • MediaInfo.Stream.Other - Other streams

Complete Example

Here's a complete example in an Android Activity:

package com.example.mediainfo

import android.net.Uri
import android.os.Bundle
import android.os.ParcelFileDescriptor
import android.widget.Button
import android.widget.TextView
import android.widget.Toast
import androidx.activity.result.contract.ActivityResultContracts
import androidx.appcompat.app.AppCompatActivity
import androidx.lifecycle.lifecycleScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch
import kotlinx.coroutines.withContext
import net.mediaarea.mediainfo.lib.MediaInfo

class MainActivity : AppCompatActivity() {
    
    private val pickMediaLauncher = registerForActivityResult(
        ActivityResultContracts.OpenDocument()
    ) { uri ->
        uri?.let { analyzeMedia(it) }
    }
    
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        
        findViewById<Button>(R.id.btnPickFile).setOnClickListener {
            pickMediaLauncher.launch(arrayOf("video/*", "audio/*"))
        }
    }
    
    private fun analyzeMedia(uri: Uri) {
        lifecycleScope.launch(Dispatchers.IO) {
            try {
                val pfd: ParcelFileDescriptor? = contentResolver.openFileDescriptor(uri, "r")
                val fd = pfd?.detachFd() ?: return@launch
                
                val mi = MediaInfo()
                mi.Open(fd, uri.lastPathSegment ?: "unknown")
                
                // Build detailed report
                val report = buildString {
                    appendLine("=== GENERAL INFO ===")
                    appendLine("Format: ${mi.Get(MediaInfo.Stream.General, 0, "Format")}")
                    appendLine("Duration: ${mi.Get(MediaInfo.Stream.General, 0, "Duration/String")}")
                    appendLine("File Size: ${mi.Get(MediaInfo.Stream.General, 0, "FileSize/String")}")
                    appendLine()
                    
                    val videoCount = mi.Count_Get(MediaInfo.Stream.Video)
                    for (i in 0 until videoCount) {
                        appendLine("=== VIDEO STREAM $i ===")
                        appendLine("Format: ${mi.Get(MediaInfo.Stream.Video, i, "Format")}")
                        appendLine("Resolution: ${mi.Get(MediaInfo.Stream.Video, i, "Width")}x${mi.Get(MediaInfo.Stream.Video, i, "Height")}")
                        appendLine("Frame Rate: ${mi.Get(MediaInfo.Stream.Video, i, "FrameRate")} fps")
                        appendLine("Bit Rate: ${mi.Get(MediaInfo.Stream.Video, i, "BitRate/String")}")
                        appendLine()
                    }
                    
                    val audioCount = mi.Count_Get(MediaInfo.Stream.Audio)
                    for (i in 0 until audioCount) {
                        appendLine("=== AUDIO STREAM $i ===")
                        appendLine("Format: ${mi.Get(MediaInfo.Stream.Audio, i, "Format")}")
                        appendLine("Channels: ${mi.Get(MediaInfo.Stream.Audio, i, "Channels")}")
                        appendLine("Sample Rate: ${mi.Get(MediaInfo.Stream.Audio, i, "SamplingRate")} Hz")
                        appendLine("Bit Rate: ${mi.Get(MediaInfo.Stream.Audio, i, "BitRate/String")}")
                        appendLine()
                    }
                }
                
                mi.Close()
                pfd

marlboro-advance

View profile

View on GitHub
GitHub Stars6
CategoryContent
Updated2mo ago
Forks2
marlboro-advance/mediainfoAndroid

Languages

Kotlin

Security Score

90/100

Audited on Jan 15, 2026

No findings