# xiao-huang585/formatstudio architecture

> Architecture diagram of the GitHub repository xiao-huang585/formatstudio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/xiao-huang585/formatstudio
- Repository: https://github.com/xiao-huang585/formatstudio

## Overview

FormatStudio is an Android media utility whose main workflow starts in the app UI, invokes native JNI functions for media operations, and returns results to the user; playback additionally renders video through the Android surface. The README documents decryption, media-information parsing, and playback, while the sampled native entry-point references connect to the FFmpeg wrapper and player. Detailed JNI operation routing and several player implementation calls were not sampled, so those links are omitted or marked unverified.

Main entry points: [`app/src/main/java/com/kgmdecoder/app/MainActivity.java`](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/java/com/kgmdecoder/app/MainActivity.java) (Main screen), [`app/src/main/cpp/YsPlayer/YsFFmpegPlayer.cpp`](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/YsPlayer/YsFFmpegPlayer.cpp) (Player controller), [`app/src/main/cpp/native-lib.cpp`](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/native-lib.cpp) (JNI entry points), [`app/src/main/cpp/functions.cpp`](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/functions.cpp) (Media operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Android app"]
  node_main["Main screen<br/>[MainActivity.java]"]
  node_select["Feature selection<br/>[Selecting.java]"]
  node_help["Help screen<br/>[Help.java]"]
end

subgraph group_bridge["JNI and media operations"]
  node_jni["JNI entry points<br/>[native-lib.cpp]"]
  node_operations["Media operations<br/>[functions.cpp]"]
  node_ffmpeg["FFmpeg wrapper<br/>[FFmpeg.cpp]"]
  node_strings["Language strings<br/>[strings.h]"]
end

subgraph group_player["Native playback"]
  node_player_core["Player controller<br/>[YsFFmpegPlayer.cpp]"]
  node_audio["Audio playback<br/>[YsAudioPlayer.cpp]"]
  node_video["Video playback<br/>[YsVideoPlayer.cpp]"]
  node_stream_queue["Stream queue<br/>[YsStreamQueue.cpp]"]
  node_java_callbacks["Java callbacks<br/>[YsCallJava.cpp]"]
end

subgraph group_nativeui["Playback UI"]
  node_java_player["Java player<br/>[YsPlayer.java]"]
  node_gl_view["GL surface view"]
end

node_user(("User"))

node_user -->|"uses"| node_main
node_main -->|"opens"| node_select
node_main -->|"opens"| node_help
node_main -->|"uses"| node_java_player
node_main -.->|"invokes"| node_jni
node_jni -->|"dispatches"| node_operations
node_jni -->|"uses"| node_ffmpeg
node_jni -->|"creates"| node_player_core
node_operations -.->|"delegates"| node_ffmpeg
node_operations -->|"uses"| node_strings
node_player_core -.->|"dispatches"| node_audio
node_player_core -.->|"dispatches"| node_video
node_video -->|"reads"| node_stream_queue
node_video -->|"calls"| node_java_callbacks
node_player_core -.->|"calls"| node_java_callbacks
node_java_callbacks -.->|"returns frames"| node_java_player
node_java_player -.->|"renders"| node_gl_view
node_ffmpeg -->|"parses media"| node_user
node_operations -->|"decrypts audio"| node_user
node_player_core -->|"plays video"| node_user

click node_main "https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/java/com/kgmdecoder/app/MainActivity.java"
click node_select "https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/java/com/kgmdecoder/app/Selecting.java"
click node_help "https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/java/com/kgmdecoder/app/Help.java"
click node_java_player "https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/java/com/kgmdecoder/app/YsPlayer.java"
click node_gl_view "https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/java/com/kgmdecoder/app/YsGLSurfaceView.java"
click node_jni "https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/native-lib.cpp"
click node_operations "https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/functions.cpp"
click node_ffmpeg "https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/FFmpeg.cpp"
click node_strings "https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/strings.h"
click node_player_core "https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/YsPlayer/YsFFmpegPlayer.cpp"
click node_audio "https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/YsPlayer/YsAudioPlayer.cpp"
click node_video "https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/YsPlayer/YsVideoPlayer.cpp"
click node_stream_queue "https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/YsPlayer/YsStreamQueue.cpp"
click node_java_callbacks "https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/YsPlayer/YsCallJava.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_select,node_help,node_user toneBlue
class node_jni,node_operations,node_ffmpeg,node_strings toneAmber
class node_player_core,node_audio,node_video,node_stream_queue,node_java_callbacks toneMint
class node_java_player,node_gl_view toneRose
```

## Components

### Android app

- [Main screen](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/java/com/kgmdecoder/app/MainActivity.java): `app/src/main/java/com/kgmdecoder/app/MainActivity.java`
- [Feature selection](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/java/com/kgmdecoder/app/Selecting.java): `app/src/main/java/com/kgmdecoder/app/Selecting.java`
- [Help screen](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/java/com/kgmdecoder/app/Help.java): `app/src/main/java/com/kgmdecoder/app/Help.java`

### JNI and media operations

- [JNI entry points](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/native-lib.cpp): `app/src/main/cpp/native-lib.cpp`
- [Media operations](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/functions.cpp): `app/src/main/cpp/functions.cpp`
- [FFmpeg wrapper](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/FFmpeg.cpp): `app/src/main/cpp/FFmpeg.cpp`
- [Language strings](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/strings.h): `app/src/main/cpp/strings.h`

### Native playback

- [Player controller](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/YsPlayer/YsFFmpegPlayer.cpp): `app/src/main/cpp/YsPlayer/YsFFmpegPlayer.cpp`
- [Audio playback](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/YsPlayer/YsAudioPlayer.cpp): `app/src/main/cpp/YsPlayer/YsAudioPlayer.cpp`
- [Video playback](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/YsPlayer/YsVideoPlayer.cpp): `app/src/main/cpp/YsPlayer/YsVideoPlayer.cpp`
- [Stream queue](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/YsPlayer/YsStreamQueue.cpp): `app/src/main/cpp/YsPlayer/YsStreamQueue.cpp`
- [Java callbacks](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/cpp/YsPlayer/YsCallJava.cpp): `app/src/main/cpp/YsPlayer/YsCallJava.cpp`

### Playback UI

- [Java player](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/java/com/kgmdecoder/app/YsPlayer.java): `app/src/main/java/com/kgmdecoder/app/YsPlayer.java`
- [GL surface view](https://github.com/xiao-huang585/formatstudio/blob/main/app/src/main/java/com/kgmdecoder/app/YsGLSurfaceView.java): `app/src/main/java/com/kgmdecoder/app/YsGLSurfaceView.java`

### Other components

- **User**

## Connections

- User → Main screen: uses (evidence: `README.md`)
- Main screen → Feature selection: opens (evidence: `app/src/main/java/com/kgmdecoder/app/MainActivity.java`)
- Main screen → Help screen: opens (evidence: `app/src/main/java/com/kgmdecoder/app/MainActivity.java`)
- Main screen → Java player: uses (evidence: `app/src/main/java/com/kgmdecoder/app/MainActivity.java`)
- Main screen → JNI entry points: invokes
- JNI entry points → Media operations: dispatches (evidence: `app/src/main/cpp/native-lib.cpp`)
- JNI entry points → FFmpeg wrapper: uses (evidence: `app/src/main/cpp/native-lib.cpp`)
- JNI entry points → Player controller: creates (evidence: `app/src/main/cpp/native-lib.cpp`)
- Media operations → FFmpeg wrapper: delegates
- Media operations → Language strings: uses
- Player controller → Audio playback: dispatches
- Player controller → Video playback: dispatches
- Video playback → Stream queue: reads
- Video playback → Java callbacks: calls (evidence: `app/src/main/cpp/YsPlayer/YsVideoPlayer.cpp`)
- Player controller → Java callbacks: calls
- Java callbacks → Java player: returns frames
- Java player → GL surface view: renders
- FFmpeg wrapper → User: parses media (evidence: `README.md`)
- Media operations → User: decrypts audio (evidence: `README.md`)
- Player controller → User: plays video (evidence: `README.md`)
