1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
# 🧭 Hyprland → Lua Migration Analysis (Phase 1)
<span style="color:#7dd3fc">Focus: identify scripts/configs that **write Hyprland config files** and therefore must change for Lua.</span>
---
## 📌 Table of Contents
- [🎯 Scope & Assumptions](#-scope--assumptions)
- [🧩 Hyprland Config Entry Points](#-hyprland-config-entry-points)
- [✍️ Direct Hyprland Config Writers (must change)](#️-direct-hyprland-config-writers-must-change)
- [🧪 Indirect / Generated Config Writers](#-indirect--generated-config-writers)
- [🧰 Install/Upgrade Writers (copy/restore paths)](#-installupgrade-writers-copyrestore-paths)
- [📟 Runtime‑Only Files (no file writes)](#-runtime-only-files-no-file-writes)
- [📝 Notes / Follow‑ups](#-notes--follow-ups)
---
## 🎯 Scope & Assumptions
<span style="color:#fbbf24">Goal:</span> Identify **files that directly modify Hyprland config on disk** (or generate files sourced by Hyprland), because those will need updating for Lua.
<span style="color:#a3e635">Out of scope:</span> The new Lua syntax itself.
---
## 🧩 Hyprland Config Entry Points
**Primary file:** `Hyprland-Dots/config/hypr/hyprland.conf`
This file **sources**:
- `Hyprland-Dots/config/hypr/configs/*.conf`
- `Hyprland-Dots/config/hypr/UserConfigs/*.conf`
- `Hyprland-Dots/config/hypr/monitors.conf`
- `Hyprland-Dots/config/hypr/workspaces.conf`
Also:
- `Hyprland-Dots/config/hypr/UserConfigs/UserDecorations.conf` **sources**
`~/.config/hypr/wallust/wallust-hyprland.conf`
➡️ Any script that writes these files must be updated for Lua.
---
## ✍️ Direct Hyprland Config Writers (must change)
These **write/overwrite Hyprland config files**:
### 🖥️ Monitor Profiles
- `Hyprland-Dots/config/hypr/scripts/MonitorProfiles.sh`
**Writes:** `~/.config/hypr/monitors.conf`
**How:** `cp` chosen profile from `Monitor_Profiles/*.conf`
### 🎞️ Animations
- `Hyprland-Dots/config/hypr/scripts/Animations.sh`
**Writes:** `~/.config/hypr/UserConfigs/UserAnimations.conf`
**How:** `cp` selected animation file into UserConfigs
### 🧱 Window Rules Version Switch
- `Hyprland-Dots/config/hypr/scripts/update_WindowRules.sh`
**Writes:** `~/.config/hypr/configs/WindowRules.conf`
**How:** backup + `cp` from `WindowRules-config-v3.conf`, then `hyprctl reload`
### 🎬 Startup Apps (wallpaper switching)
- `Hyprland-Dots/config/hypr/UserScripts/WallpaperSelect.sh`
**Writes:** `~/.config/hypr/UserConfigs/Startup_Apps.conf`
**How:** `sed -i` toggles `exec-once` lines and updates `$livewallpaper`
### 🗂️ UserConfig swapper
- `Hyprland-Dots/config/hypr/scripts/UserConfigsSwitcher.sh`
**Writes:** directory move/rename
**How:** `mv` between `UserConfigs` and `UserConfigsBak`
---
## 🧪 Indirect / Generated Config Writers
These generate **files that Hyprland sources**:
### 🎨 Wallust → Hyprland colors
- `Hyprland-Dots/config/hypr/scripts/ThemeChanger.sh`
- `Hyprland-Dots/config/hypr/scripts/WallustSwww.sh`
**Writes/overwrites:**
`~/.config/hypr/wallust/wallust-hyprland.conf`
**Used by:**
`Hyprland-Dots/config/hypr/UserConfigs/UserDecorations.conf` (sources it)
➡️ The Lua migration must either keep a compatible generated file or switch the generator target.
---
## 🧰 Install/Upgrade Writers (copy/restore paths)
These **modify Hyprland configs during install/upgrade**:
### 🔧 `copy.sh`
- Edits `Hyprland-Dots/config/hypr/configs/ENVariables.conf` (enables hyprcursor)
- Modifies `~/.config/hypr/configs/Startup_Apps.conf` (quickshell migration)
- Renames/switches `hyprlock.conf` variants (not Hyprland config, but in same dir)
- Calls restore helpers below
### 🧱 `scripts/lib_copy.sh`
Restores/copies:
- `~/.config/hypr/monitors.conf`
- `~/.config/hypr/workspaces.conf`
- `~/.config/hypr/UserConfigs/Startup_Apps.conf`
- `~/.config/hypr/UserConfigs/WindowRules.conf`
- `~/.config/hypr/UserConfigs/UserKeybinds.conf`
- Additional UserConfigs overlay logic
---
## 📟 Runtime‑Only Files (no file writes)
These **appear to be runtime-only** (no direct file writes detected; they act via `hyprctl`, process control, notifications, etc.):
### ✅ Scripts
- `Hyprland-Dots/config/hypr/scripts/AirplaneMode.sh`
- `Hyprland-Dots/config/hypr/scripts/Battery.sh`
- `Hyprland-Dots/config/hypr/scripts/BrightnessKbd.sh`
- `Hyprland-Dots/config/hypr/scripts/Brightness.sh`
- `Hyprland-Dots/config/hypr/scripts/ChangeBlur.sh`
- `Hyprland-Dots/config/hypr/scripts/ChangeLayout.sh`
- `Hyprland-Dots/config/hypr/scripts/ClipManager.sh`
- `Hyprland-Dots/config/hypr/scripts/ExternalBrightness.sh`
- `Hyprland-Dots/config/hypr/scripts/fastfetch-wrapper.sh`
- `Hyprland-Dots/config/hypr/scripts/Float-all-Windows.sh`
- `Hyprland-Dots/config/hypr/scripts/GameMode.sh`
- `Hyprland-Dots/config/hypr/scripts/Hypridle.sh`
- `Hyprland-Dots/config/hypr/scripts/KeybindsLayoutInit.sh`
- `Hyprland-Dots/config/hypr/scripts/keybinds_parser.py`
- `Hyprland-Dots/config/hypr/scripts/KeyboardLayout.sh`
- `Hyprland-Dots/config/hypr/scripts/KeyHints.sh`
- `Hyprland-Dots/config/hypr/scripts/KillActiveProcess.sh`
- `Hyprland-Dots/config/hypr/scripts/LockScreen.sh`
- `Hyprland-Dots/config/hypr/scripts/MediaCtrl.sh`
- `Hyprland-Dots/config/hypr/scripts/OverviewToggle.sh`
- `Hyprland-Dots/config/hypr/scripts/Polkit-NixOS.sh`
- `Hyprland-Dots/config/hypr/scripts/Polkit.sh`
- `Hyprland-Dots/config/hypr/scripts/PortalHyprland.sh`
- `Hyprland-Dots/config/hypr/scripts/PortalHyprlandUbuntu.sh`
- `Hyprland-Dots/config/hypr/scripts/RefreshNoWaybar.sh`
- `Hyprland-Dots/config/hypr/scripts/rofi-emacs-keybinds`
- `Hyprland-Dots/config/hypr/scripts/RofiSearch.sh`
- `Hyprland-Dots/config/hypr/scripts/Sounds.sh`
- `Hyprland-Dots/config/hypr/scripts/Toggle-Active-Window-Audio.sh`
- `Hyprland-Dots/config/hypr/scripts/UptimeNixOS.sh`
- `Hyprland-Dots/config/hypr/scripts/Volume.sh`
- `Hyprland-Dots/config/hypr/scripts/WallpaperDaemon.sh`
- `Hyprland-Dots/config/hypr/scripts/WaybarScripts.sh`
- `Hyprland-Dots/config/hypr/scripts/Wlogout.sh`
### ✅ UserScripts
- `Hyprland-Dots/config/hypr/UserScripts/00-Readme`
- `Hyprland-Dots/config/hypr/UserScripts/RofiCalc.sh`
- `Hyprland-Dots/config/hypr/UserScripts/WallpaperRandom.sh`
- `Hyprland-Dots/config/hypr/UserScripts/WeatherWrap.sh`
---
## 📝 Notes / Follow‑ups
<span style="color:#f97316">Important:</span>
Some scripts are **file writers but not Hyprland config writers** (e.g., `install-uv.sh`, `Distro_update.sh`, and the binary `dots-tui-ubuntu-2404`). They don’t touch Hyprland configs but do modify the system.
If you want an **exact “no file writes anywhere” list**, I can do a stricter pass (including temp/status files, downloads, etc.).
|
