# wseemann/ffmpegmediametadataretriever architecture

> Architecture diagram of the GitHub repository wseemann/ffmpegmediametadataretriever, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wseemann/ffmpegmediametadataretriever
- Repository: https://github.com/wseemann/ffmpegmediametadataretriever

## Overview

##### Project type and purpose
- This is an Android multi-module library + demo app.
- Purpose: provide a drop-in replacement for Android’s MediaMetadataRetriever using FFmpeg as the backend.

##### File structure
- Top-level modules:
- core/       → Java API module (FFmpegMediaMetadataRetriever.java + tests)
- native/     → NDK module (JNI wrappers, FFmpeg build scripts, OpenSSL, static libs per ABI)
- fmmr-demo/  → Android demo app (Kotlin/Java UI, ViewModel, adapters, resources)
- Build orchestration: root build.gradle + settings.gradle + versions.gradle + publishing.gradle
- Configuration files: gradle.properties, local.properties (SDK/NDK paths), proguard rules
- Native details: scripts to download & compile FFmpeg 4.2.2 & OpenSSL; prebuilt static libs under jni/openssl & ffmpeg-android-maker

##### README
- Confirms multi-module Gradle setup, dependencies on Android SDK/NDK, uses JNI to call FFmpeg, shipments via Maven AAR, supports multiple ABIs, API 16+

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Build System
    Gradle["Gradle Build System"]:::external

    %% Modules
    subgraph "Core Java Module"
        CoreAPI["FFmpegMediaMetadataRetriever.java"]:::frontend
        CoreTests["FFmpegMediaMetadataRetrieverTest.java"]:::frontend
    end

    subgraph "Native NDK Module"
        Scripts["FFmpeg & OpenSSL Build Scripts"]:::native
        JNI["JNI Wrapper Layer"]:::native
        PrebuiltFFmpeg["FFmpeg C Libraries (.so per ABI)"]:::native
        PrebuiltOpenSSL["OpenSSL C Libraries (.so per ABI)"]:::native
    end

    subgraph "Demo App Module"
        DemoMain["FMMRDemo.kt"]:::frontend
        DemoUI["UI (Activity/Fragment)"]:::frontend
        ViewModel["FMMRViewModel.kt"]:::frontend
        Adapter["MetadataAdapter.kt"]:::frontend
    end

    %% External Dependencies
    SDK_NDK["Android SDK & NDK"]:::external
    Maven["Maven Repo (AAR Distribution)"]:::external

    %% Build-time Flows
    Gradle -->|"compile FFmpeg/OpenSSL"| Scripts
    Scripts -->|"produce .so"| PrebuiltFFmpeg
    Scripts -->|"produce .so"| PrebuiltOpenSSL
    Gradle -->|"build Core"| CoreAPI
    CoreAPI -->|"links"| PrebuiltFFmpeg
    CoreAPI -->|"links"| PrebuiltOpenSSL
    Gradle -->|"build Demo"| DemoMain
    DemoMain -->|"depends on Core"| CoreAPI
    DemoMain -->|"includes native libs"| PrebuiltFFmpeg
    DemoMain -->|"includes native libs"| PrebuiltOpenSSL
    Gradle -->|"publish AARs"| Maven

    %% Runtime Flows
    DemoUI -->|"user action"| ViewModel
    ViewModel -->|"invokes"| CoreAPI
    CoreAPI -->|"JNI call"| JNI
    JNI -->|"calls C code"| PrebuiltFFmpeg
    PrebuiltFFmpeg -->|"returns metadata"| JNI
    JNI -->|"callback"| CoreAPI
    CoreAPI -->|"return data"| ViewModel
    ViewModel -->|"update UI"| DemoUI

    %% Tooling
    SDK_NDK --> Gradle

    %% Click Events
    click Gradle "https://github.com/wseemann/ffmpegmediametadataretriever/tree/master//"
    click CoreAPI "https://github.com/wseemann/ffmpegmediametadataretriever/blob/master/core/src/main/java/wseemann/media/FFmpegMediaMetadataRetriever.java"
    click CoreTests "https://github.com/wseemann/ffmpegmediametadataretriever/blob/master/core/src/androidTest/java/wseemann/media/FFmpegMediaMetadataRetrieverTest.java"
    click Scripts "https://github.com/wseemann/ffmpegmediametadataretriever/blob/master/native/src/main/ffmpeg/build-ffmpeg.sh"
    click JNI "https://github.com/wseemann/ffmpegmediametadataretriever/blob/master/native/src/main/jni/metadata/ffmpeg_mediametadataretriever.c"
    click PrebuiltFFmpeg "https://github.com/wseemann/ffmpegmediametadataretriever/tree/master/native/src/main/jni/ffmpeg"
    click PrebuiltOpenSSL "https://github.com/wseemann/ffmpegmediametadataretriever/tree/master/native/src/main/jni/openssl"
    click DemoMain "https://github.com/wseemann/ffmpegmediametadataretriever/blob/master/fmmr-demo/src/main/java/wseemann/media/demo/FMMRDemo.kt"
    click DemoUI "https://github.com/wseemann/ffmpegmediametadataretriever/blob/master/fmmr-demo/src/main/res/layout/activity_main.xml"
    click ViewModel "https://github.com/wseemann/ffmpegmediametadataretriever/blob/master/fmmr-demo/src/main/java/wseemann/media/demo/FMMRViewModel.kt"
    click Adapter "https://github.com/wseemann/ffmpegmediametadataretriever/blob/master/fmmr-demo/src/main/java/wseemann/media/demo/MetadataAdapter.kt"
    click SDK_NDK "https://github.com/wseemann/ffmpegmediametadataretriever/blob/master/local.properties"
    click Maven "https://github.com/wseemann/ffmpegmediametadataretriever/blob/master/publishing.gradle"

    %% Styles
    classDef frontend fill:#E8F0FE,stroke:#1A73E8;
    classDef native fill:#FDEFEF,stroke:#D93025;
    classDef external fill:#F1F3F4,stroke:#5F6368;
```
