# l41n-pr0t0/fedora-2026 architecture

> Architecture diagram of the GitHub repository l41n-pr0t0/fedora-2026, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/l41n-pr0t0/fedora-2026
- Repository: https://github.com/l41n-pr0t0/fedora-2026

## Overview

This repository is a Fedora KDE Plasma desktop customization, not a standalone application. Its main runtime contribution is a collection of KWin scripted window effects, alongside a browser-shortcut script and patched Control Station widget helpers. README capabilities such as themes, panels, widgets, and login styling are part of the overall desktop setup, but their implementation files are absent from this supplied tree. Effect internals are sampled only for selected scripts, so the graph groups the larger effect catalog without inferring links between its siblings.

Main entry points: [`widgets/KdeControlStation-patched`](https://github.com/l41n-pr0t0/fedora-2026/tree/main/widgets/KdeControlStation-patched) (Control Station widget), [`kwin/effects`](https://github.com/l41n-pr0t0/fedora-2026/tree/main/kwin/effects) (Shader window effects), [`kwin/effects/kwin6_effect_ripple/contents/code/main.js`](https://github.com/l41n-pr0t0/fedora-2026/blob/main/kwin/effects/kwin6_effect_ripple/contents/code/main.js) (Ripple effect), [`kwin/effects/kwin6_effect_glass_warp/contents/code/main.js`](https://github.com/l41n-pr0t0/fedora-2026/blob/main/kwin/effects/kwin6_effect_glass_warp/contents/code/main.js) (Glass Warp)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_effects["KWin Effects"]
  node_shaderfx["Shader window effects"]
  node_ripple["Ripple effect<br/>[main.js]"]
  node_glasswarp["Glass Warp<br/>[main.js]"]
  node_dissolve["Dissolve<br/>[main.js]"]
  node_pixelate["Pixelate<br/>[main.js]"]
  node_circle["Circle<br/>[main.js]"]
  node_glitch["Glitch<br/>[main.js]"]
end

subgraph group_desktop["Desktop Controls"]
  node_browser["Browser shortcut<br/>[main.js]"]
  node_controlstation["Control Station widget"]
  node_controlfuncs["Control actions<br/>[funcs.js]"]
  node_ini["INI merger utility<br/>[apply_ini.py]"]
end

node_kwin(("KWin compositor"))

node_kwin -.->|"runs effects"| node_shaderfx
node_kwin -->|"dispatches window events"| node_ripple
node_kwin -->|"dispatches window events"| node_glasswarp
node_kwin -->|"dispatches window events"| node_dissolve
node_kwin -->|"dispatches window events"| node_pixelate
node_kwin -->|"dispatches window events"| node_circle
node_kwin -->|"dispatches window events"| node_glitch
node_controlstation -.->|"uses actions"| node_controlfuncs

click node_shaderfx "https://github.com/l41n-pr0t0/fedora-2026/tree/main/kwin/effects"
click node_ripple "https://github.com/l41n-pr0t0/fedora-2026/blob/main/kwin/effects/kwin6_effect_ripple/contents/code/main.js"
click node_glasswarp "https://github.com/l41n-pr0t0/fedora-2026/blob/main/kwin/effects/kwin6_effect_glass_warp/contents/code/main.js"
click node_dissolve "https://github.com/l41n-pr0t0/fedora-2026/blob/main/kwin/effects/kwin6_effect_dissolve/contents/code/main.js"
click node_pixelate "https://github.com/l41n-pr0t0/fedora-2026/blob/main/kwin/effects/kwin6_effect_pixelate/contents/code/main.js"
click node_circle "https://github.com/l41n-pr0t0/fedora-2026/blob/main/kwin/effects/kwin6_effect_circle/contents/code/main.js"
click node_glitch "https://github.com/l41n-pr0t0/fedora-2026/blob/main/kwin/effects/kwin6_effect_glitch/contents/code/main.js"
click node_browser "https://github.com/l41n-pr0t0/fedora-2026/blob/main/kwin/scripts/open-browser-shortcut/contents/code/main.js"
click node_controlstation "https://github.com/l41n-pr0t0/fedora-2026/tree/main/widgets/KdeControlStation-patched"
click node_controlfuncs "https://github.com/l41n-pr0t0/fedora-2026/blob/main/widgets/KdeControlStation-patched/contents/ui/js/funcs.js"
click node_ini "https://github.com/l41n-pr0t0/fedora-2026/blob/main/tools/apply_ini.py"

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_shaderfx,node_ripple,node_glasswarp,node_dissolve,node_pixelate,node_circle,node_glitch toneBlue
class node_browser,node_controlstation,node_controlfuncs,node_ini toneAmber
class node_kwin toneIndigo
```

## Components

### KWin Effects

- [Shader window effects](https://github.com/l41n-pr0t0/fedora-2026/tree/main/kwin/effects): `kwin/effects`
- [Ripple effect](https://github.com/l41n-pr0t0/fedora-2026/blob/main/kwin/effects/kwin6_effect_ripple/contents/code/main.js): `kwin/effects/kwin6_effect_ripple/contents/code/main.js`
- [Glass Warp](https://github.com/l41n-pr0t0/fedora-2026/blob/main/kwin/effects/kwin6_effect_glass_warp/contents/code/main.js): `kwin/effects/kwin6_effect_glass_warp/contents/code/main.js`
- [Dissolve](https://github.com/l41n-pr0t0/fedora-2026/blob/main/kwin/effects/kwin6_effect_dissolve/contents/code/main.js): `kwin/effects/kwin6_effect_dissolve/contents/code/main.js`
- [Pixelate](https://github.com/l41n-pr0t0/fedora-2026/blob/main/kwin/effects/kwin6_effect_pixelate/contents/code/main.js): `kwin/effects/kwin6_effect_pixelate/contents/code/main.js`
- [Circle](https://github.com/l41n-pr0t0/fedora-2026/blob/main/kwin/effects/kwin6_effect_circle/contents/code/main.js): `kwin/effects/kwin6_effect_circle/contents/code/main.js`
- [Glitch](https://github.com/l41n-pr0t0/fedora-2026/blob/main/kwin/effects/kwin6_effect_glitch/contents/code/main.js): `kwin/effects/kwin6_effect_glitch/contents/code/main.js`

### Desktop Controls

- [Browser shortcut](https://github.com/l41n-pr0t0/fedora-2026/blob/main/kwin/scripts/open-browser-shortcut/contents/code/main.js): `kwin/scripts/open-browser-shortcut/contents/code/main.js`
- [Control Station widget](https://github.com/l41n-pr0t0/fedora-2026/tree/main/widgets/KdeControlStation-patched): `widgets/KdeControlStation-patched`
- [Control actions](https://github.com/l41n-pr0t0/fedora-2026/blob/main/widgets/KdeControlStation-patched/contents/ui/js/funcs.js): `widgets/KdeControlStation-patched/contents/ui/js/funcs.js`
- [INI merger utility](https://github.com/l41n-pr0t0/fedora-2026/blob/main/tools/apply_ini.py): `tools/apply_ini.py`

### Other components

- **KWin compositor**

## Connections

- KWin compositor → Shader window effects: runs effects
- KWin compositor → Ripple effect: dispatches window events (evidence: `kwin/effects/kwin6_effect_ripple/contents/code/main.js`)
- KWin compositor → Glass Warp: dispatches window events (evidence: `kwin/effects/kwin6_effect_glass_warp/contents/code/main.js`)
- KWin compositor → Dissolve: dispatches window events (evidence: `kwin/effects/kwin6_effect_dissolve/contents/code/main.js`)
- KWin compositor → Pixelate: dispatches window events (evidence: `kwin/effects/kwin6_effect_pixelate/contents/code/main.js`)
- KWin compositor → Circle: dispatches window events (evidence: `kwin/effects/kwin6_effect_circle/contents/code/main.js`)
- KWin compositor → Glitch: dispatches window events (evidence: `kwin/effects/kwin6_effect_glitch/contents/code/main.js`)
- Control Station widget → Control actions: uses actions
