# deskime/deskime_app architecture

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

- Interactive diagram: https://gitdiagram.com/deskime/deskime_app
- Repository: https://github.com/deskime/deskime_app

## Overview

##### Main Components Identification
The system consists of several independent but interconnected modules:
- Custom Taskbar Module
- Desktop Time Widget
- Search Bar
- Video & Website Wallpaper System
- Web Widget
- Desktop Pet (Duckies)

**┌─────────────────────────────────────────────┐**
- Deskime Core                   │
- ┘

**┌─────────────┐  ┌──────────┐  ┌────────────┐**
- Taskbar   │  │  Widget  │  │  Wallpaper │
- Module    │  │  Module  │  │   Module   │
- ┘  └──────────┘  └────────────┘

##### Component Relationships

Following interactions:
- Configuration Flow: JSON files → Python modules
- UI Elements: How widgets position on screen

##### Technical Details

A. For each module, show:
- Entry point (.pyw files)
- Configuration files (.json)
- External dependencies

- Blue: User Interface Components
- Green: Configuration Files
- Yellow: Resource Files
- Red: Core System Components

**┌─────────────────────────────────────────┐**
- Desktop UI                 │
- ┬─────────┬─────────┬──────────┤
- Taskbar │ Search  │  Time   │   Web    │
- Bar   │ Widget  │ Widget   │
- ┴─────────┴─────────┴──────────┘

**┌─────────────────────────────────────┐**
- Configuration Files         │
- ┬────────────┬──────────┤
- Taskbar    │ Office     │ Folders  │
- Items.json │ Items.json │ .json    │
- ┴────────────┴──────────┘

**┌─────────────────────────────────────┐**
- Shared Resources          │
- ┬────────────┬──────────┤
- ┴────────────┴──────────┘

##### Important Elements to Highlight

- Python runtime environment
- Windows-specific dependencies
- User interaction points
- Configuration file relationships
- Shared resource usage

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Core System"
        DeskimeCore["Deskime Core"]
    end

    subgraph "UI Layer"
        direction TB
        TaskbarUI["Custom Taskbar"]:::ui
        TimeWidget["Time Widget"]:::ui
        SearchBar["Search Bar"]:::ui
        WebWidget["Web Widget"]:::ui
        WallpaperSystem["Wallpaper System"]:::ui
        Duckies["Desktop Pet (Duckies)"]:::ui
    end

    subgraph "Implementation Layer"
        direction TB
        TaskbarImpl["taskbar.pyw"]:::implementation
        TimeWidgetImpl["timewidget.pyw"]:::implementation
        SearchImpl["search.pyw"]:::implementation
        WebWidgetImpl["webwidget.pyw"]:::implementation
        VideoWallImpl["Lpv.pyw"]:::implementation
        WebWallImpl["web-bk.pyw"]:::implementation
        DuckiesImpl["duck.pyw"]:::implementation
    end

    subgraph "Configuration Layer"
        direction TB
        TaskbarConfig["Taskbar Configs"]:::config
        TimeConfig["Time Widget Config"]:::config
        TaskbarItems["Taskbar_Items.json"]:::config
        StartItems["Start_Items.json"]:::config
        OfficeItems["Office_Items.json"]:::config
        FoldersConfig["Folders.json"]:::config
        TimeSettings["settings.json"]:::config
    end

    subgraph "Resource Layer"
        direction TB
        Icons["Icons"]:::resource
        Fonts["Fonts"]:::resource
        VideoRes["Video Resources"]:::resource
        WebRes["Website Resources"]:::resource
    end

    %% Core Relationships
    DeskimeCore --> TaskbarUI
    DeskimeCore --> TimeWidget
    DeskimeCore --> SearchBar
    DeskimeCore --> WebWidget
    DeskimeCore --> WallpaperSystem
    DeskimeCore --> Duckies

    %% UI to Implementation
    TaskbarUI --> TaskbarImpl
    TimeWidget --> TimeWidgetImpl
    SearchBar --> SearchImpl
    WebWidget --> WebWidgetImpl
    WallpaperSystem --> VideoWallImpl
    WallpaperSystem --> WebWallImpl
    Duckies --> DuckiesImpl

    %% Configuration Relationships
    TaskbarConfig --> TaskbarItems
    TaskbarConfig --> StartItems
    TaskbarConfig --> OfficeItems
    TaskbarConfig --> FoldersConfig
    TaskbarImpl --> TaskbarConfig
    TimeWidgetImpl --> TimeConfig
    TimeConfig --> TimeSettings

    %% Resource Usage
    Icons --> TaskbarImpl
    Fonts --> TimeWidgetImpl
    VideoRes --> VideoWallImpl
    WebRes --> WebWallImpl

    %% Click Events
    click TaskbarUI "https://github.com/Deskime/Deskime_App/tree/main/Custom Taskbar"
    click TimeWidget "https://github.com/Deskime/Deskime_App/tree/main/Desktop_TimeWidget"
    click SearchBar "https://github.com/Deskime/Deskime_App/tree/main/Search Bar"
    click WebWidget "https://github.com/Deskime/Deskime_App/tree/main/WebWidget"
    click Duckies "https://github.com/Deskime/Deskime_App/tree/main/Duckies"
    click TaskbarImpl "https://github.com/Deskime/Deskime_App/blob/main/Custom Taskbar/taskbar.pyw"
    click TimeWidgetImpl "https://github.com/Deskime/Deskime_App/blob/main/Desktop_TimeWidget/timewidget.pyw"
    click SearchImpl "https://github.com/Deskime/Deskime_App/blob/main/Search Bar/search.pyw"
    click WebWidgetImpl "https://github.com/Deskime/Deskime_App/blob/main/WebWidget/webwidget.pyw"
    click VideoWallImpl "https://github.com/Deskime/Deskime_App/blob/main/Video & Website Wallpaper/Video Wallpaper/Lpv.pyw"
    click WebWallImpl "https://github.com/Deskime/Deskime_App/blob/main/Video & Website Wallpaper/Website Wallpaper/web-bk.pyw"
    click DuckiesImpl "https://github.com/Deskime/Deskime_App/blob/main/Duckies/duck.pyw"
    click TaskbarItems "https://github.com/Deskime/Deskime_App/blob/main/Custom Taskbar/Taskbar_Items.json"
    click StartItems "https://github.com/Deskime/Deskime_App/blob/main/Custom Taskbar/Start_Items.json"
    click OfficeItems "https://github.com/Deskime/Deskime_App/blob/main/Custom Taskbar/Office_Items.json"
    click FoldersConfig "https://github.com/Deskime/Deskime_App/blob/main/Custom Taskbar/Folders.json"
    click TimeSettings "https://github.com/Deskime/Deskime_App/blob/main/Desktop_TimeWidget/Config/settings.json"
    click Icons "https://github.com/Deskime/Deskime_App/tree/main/Custom Taskbar/icons"
    click Fonts "https://github.com/Deskime/Deskime_App/tree/main/Fonts"

    %% Styling
    classDef ui fill:#2374ab
    classDef implementation fill:#048ba8
    classDef config fill:#16db93
    classDef resource fill:#efea5a
    classDef core fill:#f29e4c

    %% Legend
    subgraph Legend
        UI[UI Component]:::ui
        Impl[Implementation]:::implementation
        Conf[Configuration]:::config
        Res[Resource]:::resource
        CoreComp[Core Component]:::core
    end
```
