# malkkxd/hypernight architecture

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

- Interactive diagram: https://gitdiagram.com/malkkxd/hypernight
- Repository: https://github.com/malkkxd/hypernight

## Overview

Hypernight is a Hyprland desktop dotfiles configuration, with a Quickshell bar/control center and wallpaper-driven theming. The main user workflow is launching a session, using configured shortcuts and shell UI, and selecting a wallpaper whose accent is reflected in the interface. The graph focuses on documented runtime behavior and major configured applications. Source excerpts were unavailable, so relationships are limited to those stated in the README.

Main entry points: [`home/.config/hypr/conf/keybinds.lua`](https://github.com/malkkxd/hypernight/blob/main/home/.config/hypr/conf/keybinds.lua) (Keyboard shortcuts), [`home/.config/hypr/conf/autostart.lua`](https://github.com/malkkxd/hypernight/blob/main/home/.config/hypr/conf/autostart.lua) (Session autostart), [`home/.config/quickshell/shell.qml`](https://github.com/malkkxd/hypernight/blob/main/home/.config/quickshell/shell.qml) (Bar and control center), [`home/.config/quickshell/scripts/accent-from-wallpaper.sh`](https://github.com/malkkxd/hypernight/blob/main/home/.config/quickshell/scripts/accent-from-wallpaper.sh) (Accent extraction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_session["Session and controls"]
  node_hyprland["Hyprland session<br/>[hyprland.lua]"]
  node_autostart["Session autostart<br/>[autostart.lua]"]
  node_keybinds["Keyboard shortcuts<br/>[keybinds.lua]"]
  node_hypridle["Idle management<br/>[hypridle.conf]"]
end

subgraph group_shell["Quickshell interface"]
  node_shell["Bar and control center<br/>[shell.qml]"]
end

subgraph group_wallpaper["Wallpaper and theme"]
  node_wallpaper_config["Wallpaper settings<br/>[wallpaper.json]"]
  node_wallpapers["Wallpaper collection"]
  node_wallpaper_script["Wallpaper control<br/>[wallpaper.sh]"]
  node_accent_script["Accent extraction"]
  node_theme["Shell theme state<br/>[theme.json]"]
  node_matugen["Theme recoloring<br/>[recolor.sh]"]
  node_matugen_config["Matugen templates<br/>[config.toml]"]
end

subgraph group_apps["Desktop applications"]
  node_kitty["Terminal<br/>[kitty.conf]"]
  node_fuzzel["Application launcher<br/>[fuzzel.ini]"]
  node_dunst["Notifications<br/>[dunstrc]"]
  node_cava["Audio visualizer<br/>[config]"]
end

node_user(("Desktop user"))
node_external_services["Desktop utilities"]

node_user -->|"uses session"| node_hyprland
node_hyprland -->|"uses shortcuts"| node_keybinds
node_user -->|"opens controls"| node_shell
node_autostart -->|"starts Quickshell"| node_shell
node_autostart -->|"starts notifications"| node_dunst
node_autostart -->|"starts idle manager"| node_hypridle
node_autostart -->|"restores wallpaper"| node_wallpaper_script
node_user -->|"configures wallpaper paths"| node_wallpaper_config
node_wallpaper_script -.->|"sets backgrounds"| node_wallpapers
node_accent_script -->|"reads focused wallpaper"| node_wallpaper_config
node_accent_script -->|"updates accent"| node_theme
node_shell -->|"watches theme"| node_theme
node_matugen -->|"recolors from config"| node_matugen_config
node_keybinds -->|"opens terminal"| node_kitty
node_keybinds -->|"opens launcher"| node_fuzzel
node_keybinds -->|"opens control center"| node_shell
node_keybinds -->|"opens wallpaper selector"| node_wallpapers
node_keybinds -->|"launches desktop tools"| node_external_services

click node_hyprland "https://github.com/malkkxd/hypernight/blob/main/home/.config/hypr/hyprland.lua"
click node_autostart "https://github.com/malkkxd/hypernight/blob/main/home/.config/hypr/conf/autostart.lua"
click node_keybinds "https://github.com/malkkxd/hypernight/blob/main/home/.config/hypr/conf/keybinds.lua"
click node_shell "https://github.com/malkkxd/hypernight/blob/main/home/.config/quickshell/shell.qml"
click node_wallpaper_config "https://github.com/malkkxd/hypernight/blob/main/home/.config/quickshell/wallpaper.json"
click node_wallpapers "https://github.com/malkkxd/hypernight/tree/main/wallpapers/WPForDF"
click node_wallpaper_script "https://github.com/malkkxd/hypernight/blob/main/home/.config/hypr/scripts/wallpaper.sh"
click node_accent_script "https://github.com/malkkxd/hypernight/blob/main/home/.config/quickshell/scripts/accent-from-wallpaper.sh"
click node_theme "https://github.com/malkkxd/hypernight/blob/main/home/.config/quickshell/theme.json"
click node_matugen "https://github.com/malkkxd/hypernight/blob/main/home/.config/hypr/scripts/recolor.sh"
click node_matugen_config "https://github.com/malkkxd/hypernight/blob/main/home/.config/matugen/config.toml"
click node_kitty "https://github.com/malkkxd/hypernight/blob/main/home/.config/kitty/kitty.conf"
click node_fuzzel "https://github.com/malkkxd/hypernight/blob/main/home/.config/fuzzel/fuzzel.ini"
click node_dunst "https://github.com/malkkxd/hypernight/blob/main/home/.config/dunst/dunstrc"
click node_cava "https://github.com/malkkxd/hypernight/blob/main/home/.config/cava/config"
click node_hypridle "https://github.com/malkkxd/hypernight/blob/main/home/.config/hypr/hypridle.conf"

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_autostart,node_keybinds,node_hypridle,node_user toneBlue
class node_shell toneAmber
class node_wallpaper_config,node_wallpapers,node_wallpaper_script,node_accent_script,node_theme,node_matugen,node_matugen_config toneMint
class node_kitty,node_fuzzel,node_dunst,node_cava toneRose
class node_external_services toneIndigo
```

## Components

### Session and controls

- [Hyprland session](https://github.com/malkkxd/hypernight/blob/main/home/.config/hypr/hyprland.lua): `home/.config/hypr/hyprland.lua`
- [Session autostart](https://github.com/malkkxd/hypernight/blob/main/home/.config/hypr/conf/autostart.lua): `home/.config/hypr/conf/autostart.lua`
- [Keyboard shortcuts](https://github.com/malkkxd/hypernight/blob/main/home/.config/hypr/conf/keybinds.lua): `home/.config/hypr/conf/keybinds.lua`
- [Idle management](https://github.com/malkkxd/hypernight/blob/main/home/.config/hypr/hypridle.conf): `home/.config/hypr/hypridle.conf`

### Quickshell interface

- [Bar and control center](https://github.com/malkkxd/hypernight/blob/main/home/.config/quickshell/shell.qml): `home/.config/quickshell/shell.qml`

### Wallpaper and theme

- [Wallpaper settings](https://github.com/malkkxd/hypernight/blob/main/home/.config/quickshell/wallpaper.json): `home/.config/quickshell/wallpaper.json`
- [Wallpaper collection](https://github.com/malkkxd/hypernight/tree/main/wallpapers/WPForDF): `wallpapers/WPForDF`
- [Wallpaper control](https://github.com/malkkxd/hypernight/blob/main/home/.config/hypr/scripts/wallpaper.sh): `home/.config/hypr/scripts/wallpaper.sh`
- [Accent extraction](https://github.com/malkkxd/hypernight/blob/main/home/.config/quickshell/scripts/accent-from-wallpaper.sh): `home/.config/quickshell/scripts/accent-from-wallpaper.sh`
- [Shell theme state](https://github.com/malkkxd/hypernight/blob/main/home/.config/quickshell/theme.json): `home/.config/quickshell/theme.json`
- [Theme recoloring](https://github.com/malkkxd/hypernight/blob/main/home/.config/hypr/scripts/recolor.sh): `home/.config/hypr/scripts/recolor.sh`
- [Matugen templates](https://github.com/malkkxd/hypernight/blob/main/home/.config/matugen/config.toml): `home/.config/matugen/config.toml`

### Desktop applications

- [Terminal](https://github.com/malkkxd/hypernight/blob/main/home/.config/kitty/kitty.conf): `home/.config/kitty/kitty.conf`
- [Application launcher](https://github.com/malkkxd/hypernight/blob/main/home/.config/fuzzel/fuzzel.ini): `home/.config/fuzzel/fuzzel.ini`
- [Notifications](https://github.com/malkkxd/hypernight/blob/main/home/.config/dunst/dunstrc): `home/.config/dunst/dunstrc`
- [Audio visualizer](https://github.com/malkkxd/hypernight/blob/main/home/.config/cava/config): `home/.config/cava/config`

### Other components

- **Desktop user**
- **Desktop utilities**

## Connections

- Desktop user → Hyprland session: uses session (evidence: `README.md`)
- Hyprland session → Keyboard shortcuts: uses shortcuts (evidence: `README.md`)
- Desktop user → Bar and control center: opens controls (evidence: `README.md`)
- Session autostart → Bar and control center: starts Quickshell (evidence: `README.md`)
- Session autostart → Notifications: starts notifications (evidence: `README.md`)
- Session autostart → Idle management: starts idle manager (evidence: `README.md`)
- Session autostart → Wallpaper control: restores wallpaper (evidence: `README.md`)
- Desktop user → Wallpaper settings: configures wallpaper paths (evidence: `README.md`)
- Wallpaper control → Wallpaper collection: sets backgrounds
- Accent extraction → Wallpaper settings: reads focused wallpaper (evidence: `README.md`)
- Accent extraction → Shell theme state: updates accent (evidence: `README.md`)
- Bar and control center → Shell theme state: watches theme (evidence: `README.md`)
- Theme recoloring → Matugen templates: recolors from config (evidence: `README.md`)
- Keyboard shortcuts → Terminal: opens terminal (evidence: `README.md`)
- Keyboard shortcuts → Application launcher: opens launcher (evidence: `README.md`)
- Keyboard shortcuts → Bar and control center: opens control center (evidence: `README.md`)
- Keyboard shortcuts → Wallpaper collection: opens wallpaper selector (evidence: `README.md`)
- Keyboard shortcuts → Desktop utilities: launches desktop tools (evidence: `README.md`)
