# moneytoo/player architecture

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

- Interactive diagram: https://gitdiagram.com/moneytoo/player
- Repository: https://github.com/moneytoo/player

## Overview

##### Project type and purpose
- This is a multi-module Android application (“Just (Video) Player”) whose main purpose is to play local and streaming video/audio using Media3/ExoPlayer with the FFmpeg extension.
- It includes two reusable library modules (android-file-chooser and doubletapplayerview) and one application module (app).

##### File structure
- Top-level modules:
- android-file-chooser – a library providing a ChooserDialog, file filters, permission helpers.
- doubletapplayerview – a library providing a custom PlayerView subclass with double-tap and swipe gesture listeners.
- app – the main Android application: Activities (PlayerActivity, MediaStoreChooserActivity, SettingsActivity), custom views (CustomPlayerView, PlayerDoubleTapView), utility classes (Prefs, SubtitleUtils, Utils), resources, manifest.
- Build and config: Gradle wrappers, fastlane metadata for Play Store, proguard rules.

##### Readme insights
- Architecture not explicitly diagrammed, but features list reveals: file chooser integration, Media3/ExoPlayer engine, input gestures, subtitle handling, PiP, preference-driven behavior, external provider integrations (Bluetooth, document providers).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User Interaction
    User["User"]:::external

    %% UI Layer
    subgraph "UI Layer (app module)"
        direction TB
        PA["PlayerActivity"]:::ui
        click PA "https://github.com/moneytoo/player/blob/master/app/src/main/java/com/brouken/player/PlayerActivity.java"
        MSCA["MediaStoreChooserActivity"]:::ui
        click MSCA "https://github.com/moneytoo/player/blob/master/app/src/main/java/com/brouken/player/MediaStoreChooserActivity.java"
        SA["SettingsActivity"]:::ui
        click SA "https://github.com/moneytoo/player/blob/master/app/src/main/java/com/brouken/player/SettingsActivity.java"
        CPV["CustomPlayerView"]:::ui
        click CPV "https://github.com/moneytoo/player/blob/master/app/src/main/java/com/brouken/player/CustomPlayerView.java"
        DTPV["DoubleTapPlayerView"]:::ui
        click DTPV "https://github.com/moneytoo/player/blob/master/app/src/main/java/com/brouken/player/dtpv/DoubleTapPlayerView.java"
        YO["YouTubeOverlay"]:::ui
        click YO "https://github.com/moneytoo/player/blob/master/app/src/main/java/com/brouken/player/dtpv/youtube/YouTubeOverlay.java"
        CCT["CircleClipTapView"]:::ui
        click CCT "https://github.com/moneytoo/player/blob/master/app/src/main/java/com/brouken/player/dtpv/youtube/views/CircleClipTapView.java"
        SV["SecondsView"]:::ui
        click SV "https://github.com/moneytoo/player/blob/master/app/src/main/java/com/brouken/player/dtpv/youtube/views/SecondsView.java"
    end

    %% File Chooser Library
    subgraph "File Chooser Library (android-file-chooser)" 
        direction TB
        CD["ChooserDialog"]:::library
        click CD "https://github.com/moneytoo/player/blob/master/android-file-chooser/src/main/java/com/obsez/android/lib/filechooser/ChooserDialog.java"
        PAH["PermissionActivity"]:::library
        click PAH "https://github.com/moneytoo/player/blob/master/android-file-chooser/src/main/java/com/obsez/android/lib/filechooser/permissions/PermissionActivity.java"
        PU["PermissionsUtil"]:::library
        click PU "https://github.com/moneytoo/player/blob/master/android-file-chooser/src/main/java/com/obsez/android/lib/filechooser/permissions/PermissionsUtil.java"
    end

    %% Domain/Controller Layer
    subgraph "Domain / Controller"
        direction TB
        Prefs["Prefs"]:::domain
        click Prefs "https://github.com/moneytoo/player/blob/master/app/src/main/java/com/brouken/player/Prefs.java"
        SF["SubtitleFetcher"]:::domain
        click SF "https://github.com/moneytoo/player/blob/master/app/src/main/java/com/brouken/player/SubtitleFetcher.java"
        SFi["SubtitleFinder"]:::domain
        click SFi "https://github.com/moneytoo/player/blob/master/app/src/main/java/com/brouken/player/SubtitleFinder.java"
        SU["SubtitleUtils"]:::domain
        click SU "https://github.com/moneytoo/player/blob/master/app/src/main/java/com/brouken/player/SubtitleUtils.java"
        UT["Utils"]:::domain
        click UT "https://github.com/moneytoo/player/blob/master/app/src/main/java/com/brouken/player/Utils.java"
        BC["BrightnessControl"]:::domain
        click BC "https://github.com/moneytoo/player/blob/master/app/src/main/java/com/brouken/player/BrightnessControl.java"
    end

    %% Playback Engine
    subgraph "Playback Engine"
        direction TB
        EP["ExoPlayer Core & AARs"]:::engine
        click EP "https://github.com/moneytoo/player/blob/master/app/libs/lib-exoplayer-release.aar"
        FF["FFmpeg Extension"]:::engine
        click FF "https://github.com/moneytoo/player/blob/master/app/libs/lib-decoder-ffmpeg-release.aar"
        TS["Track Selector"]:::engine
        RD["Renderers"]:::engine
    end

    %% External / System Services
    subgraph "External / System Services"
        direction TB
        SAF["Storage Access Framework / MediaStore"]:::external
        DP["DocumentProviders (SMB/WebDAV/SFTP)"]:::external
        BT["Bluetooth Audio Stack"]:::external
        HTTP["HTTP/HTTPS Subtitles"]:::external
    end

    %% Interactions
    User -->|taps Open File| PA
    PA -->|invokes| CD
    CD -->|requests permission| PAH
    PAH -->|checks| PU
    CD -->|returns URI| PA
    PA -->|passes URI| EP
    EP -->|uses| FF
    EP -->|configures with| TS
    EP -->|renders via| RD
    RD -->|video->| CPV
    RD -->|audio->| BT
    CPV -->|gesture events| DTPV
    DTPV -->|double-tap/swipe| UT
    UT -->|adjusts| EP
    SU -->|processes subtitles| SF
    SF -->|fetches from| HTTP
    SF -->|finds| SFi
    SF -->|attaches text tracks| EP
    SA -->|updates| Prefs
    Prefs -->|reconfigures| TS

    %% Integration with external storage
    CD -->|uses| SAF
    CD -->|uses| DP

    %% Style Classes
    classDef ui fill:#D0E8FF,stroke:#0366D6,color:#0366D6;
    classDef library fill:#E2F0D9,stroke:#22863A,color:#22863A;
    classDef domain fill:#FFF5B1,stroke:#D29922,color:#D29922;
    classDef engine fill:#FFE0B2,stroke:#E36209,color:#E36209;
    classDef external fill:#F0F0F0,stroke:#6A737D,color:#6A737D;
```
