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
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
|
#!/usr/bin/env bash
# ==================================================
# KoolDots (2026)
# Project URL: https://github.com/LinuxBeginnings
# License: GNU GPLv3
# SPDX-License-Identifier: GPL-3.0-or-later
# ==================================================
# ─────────────────────────────────────────────────────────────────────────────
# Tak0-Autodispatch.sh
# ─────────────────────────────────────────────────────────────────────────────
# This script is an "authoritative spawn dispatcher" for Hyprland.
#
# Its purpose is to FORCE all windows belonging to a single application launch
# (main window + helpers + Electron / Steam child processes)
# onto a specific workspace.
#
# It explicitly ignores:
# • spawn race conditions
# • delayed window creation
# • detached helper processes
# • Electron / Chromium / Steam madness
#
# Typical use cases:
# • Launch Steam / Discord / browsers without window leakage
# • Prevent apps from spawning on the currently focused workspace
# • Control applications that completely ignore static windowrules
#
# Invocation:
# ./Tak0-Autodispatch.sh <workspace> [rule ...] -- <command>
#
# Important notes:
# • All window rules are TEMPORARY
# • No permanent pollution of Hyprland configuration
# ─────────────────────────────────────────────────────────────────────────────
# REQUIREMENTS:
# - hyprctl → runtime control of Hyprland
# - jq → JSON client parsing
# - pgrep/ps → process tree inspection
set -u
LOGFILE="$(dirname "$0")/dispatch.log"
# ─────────────────────────────────────────────────────────────────────────────
# 0️⃣ ARGUMENT PARSING
# ─────────────────────────────────────────────────────────────────────────────
# $1 → target workspace
# Next args → optional capture rules (windowrulev2 syntax)
# "--" → argument separator
# After "--" → command to execute (verbatim)
TARGET_WS="$1"
shift || true
CAPTURE_RULES=()
while [[ "${1-}" != "--" && -n "${1-}" ]]; do
CAPTURE_RULES+=("$1")
shift || break
done
if [[ "${1-}" == "--" ]]; then
shift
fi
CMD="$*"
if [[ -z "$TARGET_WS" || -z "$CMD" ]]; then
echo "Usage: $0 <workspace> [rule rule ...] -- <command>" >>"$LOGFILE"
exit 1
fi
echo "=== Deploy '$CMD' → WS $TARGET_WS @ $(date) ===" >>"$LOGFILE"
# ─────────────────────────────────────────────────────────────────────────────
# 1️⃣ HYPRLAND READINESS GATE
# ─────────────────────────────────────────────────────────────────────────────
# Hyprland may not be fully initialized during early autostart.
# hyprctl silently fails if called too early.
for _ in {1..50}; do
hyprctl -j monitors >/dev/null 2>&1 && break
sleep 0.1
done
# ─────────────────────────────────────────────────────────────────────────────
# 2️⃣ CLEANUP GUARANTEE
# ─────────────────────────────────────────────────────────────────────────────
# Ensures that ALL temporary rules are removed
# even on crash, SIGTERM, or user interruption.
cleanup() {
echo "Cleanup: removing temporary capture rules and initialWorkspace at $(date)" >>"$LOGFILE"
hyprctl keyword windowrulev2 "unset, initialClass:.*" >>"$LOGFILE" 2>&1 || true
for RULE in "${CAPTURE_RULES[@]}"; do
echo "Cleanup: removing temporary capture rule: $RULE" >>"$LOGFILE"
hyprctl keyword windowrulev2 "unset, $RULE" >>"$LOGFILE" 2>&1 || true
done
}
trap cleanup EXIT INT TERM ERR
# ─────────────────────────────────────────────────────────────────────────────
# 3️⃣ ULTRA-EARLY GLOBAL CAPTURE (NUCLEAR OPTION)
# ─────────────────────────────────────────────────────────────────────────────
# Temporarily forces ALL windows (initialClass:.*)
# onto the target workspace.
#
# Protects against ultra-fast helpers:
# • gpu-process
# • renderer
# • steamwebhelper
echo "Applying temporary initialWorkspace capture (initialClass:.*)" >>"$LOGFILE"
hyprctl keyword windowrulev2 \
"initialWorkspace $TARGET_WS silent, initialClass:.*" \
>>"$LOGFILE" 2>&1 || true
# ─────────────────────────────────────────────────────────────────────────────
# 3️⃣.1 OPTIONAL CLASS-BASED PRE-CAPTURE
# ─────────────────────────────────────────────────────────────────────────────
# Additional precision rules.
# Useful for Electron / Steam multi-process hell.
for RULE in "${CAPTURE_RULES[@]}"; do
echo "Applying temporary capture rule: $RULE" >>"$LOGFILE"
hyprctl keyword windowrulev2 \
"initialWorkspace $TARGET_WS silent, $RULE" \
>>"$LOGFILE" 2>&1 || true
done
# ─────────────────────────────────────────────────────────────────────────────
# 4️⃣ APPLICATION LAUNCH
# ─────────────────────────────────────────────────────────────────────────────
# bash -c allows aliases, env vars, wrappers.
# ROOT_PID is the root of process lineage.
bash -c "$CMD" &
ROOT_PID=$!
echo "Root PID: $ROOT_PID" >>"$LOGFILE"
# Resolve canonical process name
APP_NAME=""
for _ in {1..20}; do
if [[ -r "/proc/$ROOT_PID/comm" ]]; then
APP_NAME="$(tr -d '\0' </proc/$ROOT_PID/comm 2>/dev/null || true)"
break
fi
sleep 0.05
done
if [[ -z "$APP_NAME" ]]; then
read -r -a __toks <<<"$CMD"
APP_NAME="$(basename "${__toks[0]}")"
fi
echo "App gate name: $APP_NAME" >>"$LOGFILE"
sleep 1.5
#!TO-DO: Release the nuclear option ASAP
echo "Releasing ultra-early wide capture" >>"$LOGFILE"
hyprctl keyword windowrulev2 "unset, initialClass:.*" >>"$LOGFILE" 2>&1 || true
# ─────────────────────────────────────────────────────────────────────────────
# 5️⃣ SUPERVISION LOOP (AUTHORITATIVE PHASE)
# ─────────────────────────────────────────────────────────────────────────────
# This loop:
# • scans ALL Hyprland clients
# • matches PID lineage
# • matches detached helpers
# • matches class rules
get_descendants() {
local root="$1"
local all=("$root")
local changed=1
while ((changed)); do
changed=0
for p in "${all[@]}"; do
for c in $(pgrep -P "$p" 2>/dev/null || true); do
if [[ ! " ${all[*]} " =~ " $c " ]]; then
all+=("$c")
changed=1
fi
done
done
done
echo "${all[@]}"
}
pid_matches_app() {
local pid="$1"
local comm
comm="$(ps -p "$pid" -o comm= 2>/dev/null)" || return 1
[[ "$comm" == "$APP_NAME" || "$comm" == "$APP_NAME"* ]]
}
END_TIME=$((SECONDS + 20))
declare -A SEEN
while ((SECONDS < END_TIME)); do
PIDS="$(get_descendants "$ROOT_PID")"
while IFS=$'\t' read -r PID ADDR CLASS; do
MATCH=0
for TPID in $PIDS; do
[[ "$PID" == "$TPID" ]] && MATCH=1 && break
done
pid_matches_app "$PID" && MATCH=1
for RULE in "${CAPTURE_RULES[@]}"; do
if [[ "$RULE" =~ class:\^\((.*)\)\$ ]]; then
[[ "$CLASS" =~ ${BASH_REMATCH[1]} ]] && MATCH=1
fi
done
if ((MATCH)) && [[ -z "${SEEN[$ADDR]-}" ]]; then
echo "Placing window $ADDR (pid $PID, class $CLASS) → WS $TARGET_WS" >>"$LOGFILE"
hyprctl dispatch movetoworkspacesilent \
"$TARGET_WS,address:$ADDR" >>"$LOGFILE" 2>&1 || true
SEEN[$ADDR]=1
fi
done < <(hyprctl clients -j | jq -r '.[] | [.pid, .address, .class] | @tsv')
sleep 0.01
done
echo "=== Deploy finished: '$CMD' ===" >>"$LOGFILE"
exit 0
|
