# jack02134x/hypr-rice architecture

> Architecture diagram of the GitHub repository jack02134x/hypr-rice, 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/jack02134x/hypr-rice
- Repository: https://github.com/jack02134x/hypr-rice

## Overview

hypr-rice is a personal Hyprland desktop configuration: users select and copy modular configs, then reload the desktop to use its bar, lock screen, shell widgets, and quality-of-life scripts. A separate YouTube audio program supports streaming, downloads, playlist viewing, and playback. The README documents broad config/script relationships; source excerpts are limited to the audio program, so links among desktop components are shown only where documented, not inferred from filenames.

Main entry points: [`python-yt-project/mainfile.py`](https://github.com/jack02134x/hypr-rice/blob/main/python-yt-project/mainfile.py) (Audio menu), [`python-yt-project/play_entire_playlist.py`](https://github.com/jack02134x/hypr-rice/blob/main/python-yt-project/play_entire_playlist.py) (Shuffle player), [`.config/hypr`](https://github.com/jack02134x/hypr-rice/tree/main/.config/hypr) (Hyprland setup), [`.scripts`](https://github.com/jack02134x/hypr-rice/tree/main/.scripts) (Desktop scripts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop session"]
  node_hyprland["Hyprland setup<br/>[hypr]"]
  node_niri["Niri config<br/>[niri]"]
end

subgraph group_widgets["Desktop interface"]
  node_waybar["Waybar themes<br/>[waybar]"]
  node_hyprlock["Hyprlock layouts<br/>[hyprlock]"]
  node_quickshell["Quickshell UI<br/>[quickshell]"]
  node_eww["Eww widgets<br/>[eww]"]
  node_swaync["Notifications<br/>[swaync]"]
end

subgraph group_theme["Colors and themes"]
  node_matugen["Matugen templates<br/>[matugen]"]
  node_kitty["Kitty themes<br/>[kitty]"]
end

subgraph group_helpers["Desktop helpers"]
  node_scripts["Desktop scripts<br/>[.scripts]"]
  node_waybar_scripts["Waybar scripts<br/>[scripts]"]
end

subgraph group_audio["YouTube audio"]
  node_yt_menu["Audio menu<br/>[mainfile.py]"]
  node_playlist["Playlist file<br/>[Yt-playlist.txt]"]
  node_downloaded_audio["Downloaded audio<br/>[mainfile.py]"]
  node_playlist_player["Shuffle player"]
end

node_user(("User"))
node_yt_user(("Audio user"))
node_yt_services["yt-dlp and mpv"]

node_user -->|"copies and reloads"| node_hyprland
node_user -->|"selects and copies"| node_waybar
node_user -->|"selects and copies"| node_hyprlock
node_user -->|"selects and copies"| node_quickshell
node_user -->|"copies as needed"| node_scripts
node_hyprland -->|"binds call scripts"| node_scripts
node_yt_user -->|"chooses action"| node_yt_menu
node_yt_menu -->|"streams audio"| node_yt_services
node_yt_menu -->|"downloads audio"| node_yt_services
node_yt_menu -->|"appends links"| node_playlist
node_yt_menu -->|"reads links"| node_playlist
node_yt_menu -->|"lists local files"| node_downloaded_audio
node_yt_menu -->|"plays local files"| node_yt_services
node_playlist_player -->|"lists and selects"| node_downloaded_audio
node_playlist_player -->|"plays shuffled"| node_yt_services

click node_hyprland "https://github.com/jack02134x/hypr-rice/tree/main/.config/hypr"
click node_niri "https://github.com/jack02134x/hypr-rice/tree/main/.config/niri"
click node_waybar "https://github.com/jack02134x/hypr-rice/tree/main/.config/waybar"
click node_hyprlock "https://github.com/jack02134x/hypr-rice/tree/main/.config/hypr/hyprlock"
click node_quickshell "https://github.com/jack02134x/hypr-rice/tree/main/.config/quickshell"
click node_eww "https://github.com/jack02134x/hypr-rice/tree/main/.config/eww"
click node_swaync "https://github.com/jack02134x/hypr-rice/tree/main/.config/swaync"
click node_matugen "https://github.com/jack02134x/hypr-rice/tree/main/.config/matugen"
click node_kitty "https://github.com/jack02134x/hypr-rice/tree/main/.config/kitty"
click node_scripts "https://github.com/jack02134x/hypr-rice/tree/main/.scripts"
click node_waybar_scripts "https://github.com/jack02134x/hypr-rice/tree/main/.config/waybar/scripts"
click node_yt_menu "https://github.com/jack02134x/hypr-rice/blob/main/python-yt-project/mainfile.py"
click node_playlist "https://github.com/jack02134x/hypr-rice/blob/main/python-yt-project/Yt-playlist.txt"
click node_downloaded_audio "https://github.com/jack02134x/hypr-rice/blob/main/python-yt-project/mainfile.py"
click node_playlist_player "https://github.com/jack02134x/hypr-rice/blob/main/python-yt-project/play_entire_playlist.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_hyprland,node_niri,node_user,node_yt_user toneBlue
class node_waybar,node_hyprlock,node_quickshell,node_eww,node_swaync toneAmber
class node_matugen,node_kitty toneMint
class node_scripts,node_waybar_scripts toneRose
class node_yt_menu,node_playlist,node_downloaded_audio,node_playlist_player,node_yt_services toneIndigo
```

## Components

### Desktop session

- [Hyprland setup](https://github.com/jack02134x/hypr-rice/tree/main/.config/hypr): `.config/hypr`
- [Niri config](https://github.com/jack02134x/hypr-rice/tree/main/.config/niri): `.config/niri`

### Desktop interface

- [Waybar themes](https://github.com/jack02134x/hypr-rice/tree/main/.config/waybar): `.config/waybar`
- [Hyprlock layouts](https://github.com/jack02134x/hypr-rice/tree/main/.config/hypr/hyprlock): `.config/hypr/hyprlock`
- [Quickshell UI](https://github.com/jack02134x/hypr-rice/tree/main/.config/quickshell): `.config/quickshell`
- [Eww widgets](https://github.com/jack02134x/hypr-rice/tree/main/.config/eww): `.config/eww`
- [Notifications](https://github.com/jack02134x/hypr-rice/tree/main/.config/swaync): `.config/swaync`

### Colors and themes

- [Matugen templates](https://github.com/jack02134x/hypr-rice/tree/main/.config/matugen): `.config/matugen`
- [Kitty themes](https://github.com/jack02134x/hypr-rice/tree/main/.config/kitty): `.config/kitty`

### Desktop helpers

- [Desktop scripts](https://github.com/jack02134x/hypr-rice/tree/main/.scripts): `.scripts`
- [Waybar scripts](https://github.com/jack02134x/hypr-rice/tree/main/.config/waybar/scripts): `.config/waybar/scripts`

### YouTube audio

- [Audio menu](https://github.com/jack02134x/hypr-rice/blob/main/python-yt-project/mainfile.py): `python-yt-project/mainfile.py`
- [Playlist file](https://github.com/jack02134x/hypr-rice/blob/main/python-yt-project/Yt-playlist.txt): `python-yt-project/Yt-playlist.txt`
- [Downloaded audio](https://github.com/jack02134x/hypr-rice/blob/main/python-yt-project/mainfile.py): `python-yt-project/mainfile.py`
- [Shuffle player](https://github.com/jack02134x/hypr-rice/blob/main/python-yt-project/play_entire_playlist.py): `python-yt-project/play_entire_playlist.py`

### Other components

- **User**
- **Audio user**
- **yt-dlp and mpv**

## Connections

- User → Hyprland setup: copies and reloads (evidence: `README.md`)
- User → Waybar themes: selects and copies (evidence: `README.md`)
- User → Hyprlock layouts: selects and copies (evidence: `README.md`)
- User → Quickshell UI: selects and copies (evidence: `README.md`)
- User → Desktop scripts: copies as needed (evidence: `README.md`)
- Hyprland setup → Desktop scripts: binds call scripts (evidence: `README.md`)
- Audio user → Audio menu: chooses action (evidence: `python-yt-project/mainfile.py`)
- Audio menu → yt-dlp and mpv: streams audio (evidence: `python-yt-project/mainfile.py`)
- Audio menu → yt-dlp and mpv: downloads audio (evidence: `python-yt-project/mainfile.py`)
- Audio menu → Playlist file: appends links (evidence: `python-yt-project/mainfile.py`)
- Audio menu → Playlist file: reads links (evidence: `python-yt-project/mainfile.py`)
- Audio menu → Downloaded audio: lists local files (evidence: `python-yt-project/mainfile.py`)
- Audio menu → yt-dlp and mpv: plays local files (evidence: `python-yt-project/mainfile.py`)
- Shuffle player → Downloaded audio: lists and selects (evidence: `python-yt-project/play_entire_playlist.py`)
- Shuffle player → yt-dlp and mpv: plays shuffled (evidence: `python-yt-project/play_entire_playlist.py`)
