# zhaoxiaozhao07/dynamic-photo-video-display-wall architecture

> Architecture diagram of the GitHub repository zhaoxiaozhao07/dynamic-photo-video-display-wall, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zhaoxiaozhao07/dynamic-photo-video-display-wall
- Repository: https://github.com/zhaoxiaozhao07/dynamic-photo-video-display-wall

## Overview

##### Project type and purpose
- This is a desktop multimedia‐display application written in Python. It consists of a launcher (main.py) that can concurrently start two GUI modules: a “dynamic photo wall” (Photos.py) and a “dynamic video wall” (Videos.py). It uses PyQt6 for all GUI functionality and OpenCV (cv2) for video decoding and playback.

##### File structure
- Top-level files:
- LICENSE
- requirements.txt (PyQt6, OpenCV)
- main.py (common launcher)
- Photos.py (photo-wall module)
- Videos.py (video-wall module)
- No separate frontend/backend folders—everything is in one monolithic Python package, but logically partitioned into three subcomponents.

##### README for architectural clues
- The README emphasizes:
- Unified dark-theme GUI
- Independent modules for photos vs. videos
- Shared functionality (theme, window management, file selection)
- Multimedia loading, caching, and rendering pipelines

## Diagram (Mermaid)

```mermaid
flowchart TB
    User["User"]:::external
    subgraph "Presentation Layer"
        PyQt["PyQt6 Framework"]:::presentation
    end
    subgraph "Application Logic Layer"
        Main["Launcher UI\n(main.py)"]:::logic
        Photos["Photo Engine\n(Photos.py)"]:::logic
        Videos["Video Engine\n(Videos.py)"]:::logic
    end
    subgraph "Data/Resource Layer"
        FS["File System\n(media folders)"]:::resource
        Cache["Cache Manager\n(in-memory)"]:::resource
        OpenCV["OpenCV\n(cv2)"]:::resource
    end

    User -->|click| Main
    Main -->|"spawn()"| Photos
    Main -->|"spawn()"| Videos
    Photos -->|"scan_folder() / list files"| FS
    Videos -->|"scan_folder() / list files"| FS
    Photos -->|"load/evict()"| Cache
    Photos -->|"render_images()"| PyQt
    Videos -->|"decode_frames()"| OpenCV
    OpenCV -->|"render_frames()"| PyQt
    Videos -->|"render_videos()"| PyQt
    Photos -.->|coordination| Main
    Videos -.->|coordination| Main
    PyQt -->|"events/signals"| Main

    click Main "https://github.com/zhaoxiaozhao07/dynamic-photo-video-display-wall/blob/main/main.py"
    click Photos "https://github.com/zhaoxiaozhao07/dynamic-photo-video-display-wall/blob/main/Photos.py"
    click Videos "https://github.com/zhaoxiaozhao07/dynamic-photo-video-display-wall/blob/main/Videos.py"
    click PyQt "https://github.com/zhaoxiaozhao07/dynamic-photo-video-display-wall/blob/main/requirements.txt"
    click OpenCV "https://github.com/zhaoxiaozhao07/dynamic-photo-video-display-wall/blob/main/requirements.txt"
    click Cache "https://github.com/zhaoxiaozhao07/dynamic-photo-video-display-wall/blob/main/Photos.py"
    click README "https://github.com/zhaoxiaozhao07/dynamic-photo-video-display-wall/blob/main/README.md"

    classDef presentation fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef logic fill:#90EE90,stroke:#333,stroke-width:1px
    classDef resource fill:#FFFFE0,stroke:#333,stroke-width:1px
    classDef external fill:#f5f5f5,stroke:#333,stroke-width:1px
```
