# greedysky/ttkmusicplayer architecture

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

- Interactive diagram: https://gitdiagram.com/greedysky/ttkmusicplayer
- Repository: https://github.com/greedysky/ttkmusicplayer

## Overview

##### Main Architecture Components

- Presentation Layer                                    |

- Main Window    |  |  Music Player UI  |  |    LRC Window   |  |   Video Player   | |

- ↕

- Core Modules                                         |

- Music Core     |  |   Network Core    |  |   Player Core   |  |   Tools Core     | |

- ↕

- Service Layer                                         |

- Network Services |  |  Storage Services |  | Plugin Services |  |  DLNA Services   | |

- ↕

- Third-Party Components                                    |

- QMMP        |  |      QJson        |  |    QRencode    |  |     Others       | |

##### Key Components to Highlight

a) Core Components:
- TTKCore: Main application logic
- TTKWidget: UI components
- TTKNetwork: Network operations
- TTKTools: Utility functions

b) Feature Modules:
- Music playback engine
- Lyrics display system
- Video playback
- Network streaming
- File format support
- Visualization effects

##### Data Flow Indicators

- Audio stream flow
- Network data flow
- User interaction flow
- Plugin communication

##### Integration Points

Connections with:
- External music services
- Local file system
- Plugin system
- Network services

##### Important Notes for Implementation

- Modular architecture
- Plugin system integration
- Multiple format support
- Network functionality
- UI component relationships

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Presentation
        MainWindow["Main Window"]:::ui
        MusicPlayerUI["Music Player UI"]:::ui
        LRCWindow["LRC Window"]:::ui
        VideoPlayer["Video Player"]:::ui
        SearchUI["Search Interface"]:::ui
        RemoteUI["Remote Control"]:::ui
        Settings["Settings Manager"]:::ui
    end

    subgraph Core
        MusicCore["Music Core"]:::core
        NetworkCore["Network Core"]:::core
        PlayerCore["Player Core"]:::core
        ToolsCore["Tools Core"]:::core
    end

    subgraph Services
        NetworkServices["Network Services"]:::service
        StorageServices["Storage Services"]:::service
        PluginServices["Plugin System"]:::service
        DLNAServices["DLNA Services"]:::service
    end

    subgraph ThirdParty["Third-Party Components"]
        QMMP["QMMP"]:::external
        QJson["QJson"]:::external
        QRencode["QRencode"]:::external
        Others["Other Libraries"]:::external
    end

    MainWindow --> MusicCore
    MainWindow --> NetworkCore
    MusicPlayerUI --> PlayerCore
    LRCWindow --> MusicCore
    VideoPlayer --> PlayerCore
    SearchUI --> NetworkCore
    RemoteUI --> PlayerCore
    Settings --> ToolsCore

    MusicCore --> StorageServices
    NetworkCore --> NetworkServices
    PlayerCore --> PluginServices
    NetworkServices --> DLNAServices

    PlayerCore --> QMMP
    NetworkCore --> QJson
    ToolsCore --> QRencode

    classDef ui fill:#90EE90,stroke:#333,stroke-width:2px
    classDef core fill:#87CEEB,stroke:#333,stroke-width:2px
    classDef service fill:#FFA500,stroke:#333,stroke-width:2px
    classDef external fill:#DDA0DD,stroke:#333,stroke-width:2px

    click MainWindow "https://github.com/Greedysky/TTKMusicPlayer/tree/master/TTKModule/TTKWidget/musicWidgetKits"
    click MusicCore "https://github.com/Greedysky/TTKMusicPlayer/tree/master/TTKModule/TTKCore/musicCoreKits"
    click NetworkCore "https://github.com/Greedysky/TTKMusicPlayer/tree/master/TTKModule/TTKCore/musicNetworkKits"
    click LRCWindow "https://github.com/Greedysky/TTKMusicPlayer/tree/master/TTKModule/TTKWidget/musicLrcKits"
    click VideoPlayer "https://github.com/Greedysky/TTKMusicPlayer/tree/master/TTKModule/TTKWidget/musicVideoKits"
    click PluginServices "https://github.com/Greedysky/TTKMusicPlayer/blob/master/TTKModule/TTKWidget/musicWidgetKits/musicpluginwidget.h"
    click DLNAServices "https://github.com/Greedysky/TTKMusicPlayer/tree/master/TTKThirdParty/TTKExtras/qdlna"
    click StorageServices "https://github.com/Greedysky/TTKMusicPlayer/tree/master/TTKModule/TTKCore/musicPlaylistKits"
    click ToolsCore "https://github.com/Greedysky/TTKMusicPlayer/tree/master/TTKModule/TTKCore/musicToolsKits"
    click QMMP "https://github.com/Greedysky/TTKMusicPlayer/tree/master/TTKThirdParty/TTKqmmp"
    click QJson "https://github.com/Greedysky/TTKMusicPlayer/tree/master/TTKThirdParty/TTKExtras/qjson"
    click QRencode "https://github.com/Greedysky/TTKMusicPlayer/tree/master/TTKThirdParty/TTKExtras/qrencode"
    click SearchUI "https://github.com/Greedysky/TTKMusicPlayer/tree/master/TTKModule/TTKWidget/musicSearchKits"
    click RemoteUI "https://github.com/Greedysky/TTKMusicPlayer/tree/master/TTKModule/TTKWidget/musicRemoteKits"
    click Settings "https://github.com/Greedysky/TTKMusicPlayer/blob/master/TTKModule/TTKWidget/musicWidgetKits/musicsettingwidget.h"
```
