aboutsummaryrefslogtreecommitdiffstats
path: root/desktop/modules/shells/README.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-11-18 17:04:57 +0100
committerDanilo M. <danix@danix.xyz>2026-11-18 17:04:57 +0100
commite55c1f32b383c53d12dc7c2b3c5e2e6ccb146cdc (patch)
treefee3f3ced727f01c7bc630418a6e0b47d347df40 /desktop/modules/shells/README.md
parent44f947c642fe842fae80c7407399265aa47e9909 (diff)
downloadquickshell-e55c1f32b383c53d12dc7c2b3c5e2e6ccb146cdc.tar.gz
quickshell-e55c1f32b383c53d12dc7c2b3c5e2e6ccb146cdc.zip
feat(services): one drawer page to start, stop and restart services
Running things is a runtime operation, so it belongs in the drawer, not the settings window. The drawer's deck-it tile and keystone's Shells page become one Services tile: every quickshell shell, deck-it, and the desktop's long-running daemons (desktop-assistant, cal-notif, tv-mpris, mail-watcher, mail-notify, hypridle, hyprsunset, the polkit agent, notifyd, playerctld, conky and cliphist's watcher), each with Start, Stop and Restart. A daemon's start command is its enabled autostart.lua line, run through hyprctl dispatch hl.dsp.exec_cmd as Autostart's Try does, so conky keeps its workspace rule and no command is copied out of autostart.lua. Services.js holds only the label, the piece of the line that finds it and the pgrep/pkill arguments. Stop waits up to 5s for the process to exit, which hyprsunset needs to free Hyprland's CTM manager. -f patterns bracket a letter so pgrep and pkill never match the sh that runs them. Checked: test_services.js; the pgrep list reports all twelve daemons running; a playerctld restart through the same command came back under a new pid. QML's JS engine has no Array.flatMap, hence the concat. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'desktop/modules/shells/README.md')
-rw-r--r--desktop/modules/shells/README.md21
1 files changed, 0 insertions, 21 deletions
diff --git a/desktop/modules/shells/README.md b/desktop/modules/shells/README.md
deleted file mode 100644
index 16a93b5..0000000
--- a/desktop/modules/shells/README.md
+++ /dev/null
@@ -1,21 +0,0 @@
-# shells
-
-Every directory in the repo holding a `shell.qml`, with whether `qs list
---all` shows an instance on it, and a Restart (or Start, when it is not
-running) per row plus a Restart all. All three run `reload.sh`, so a button
-does what the script does from a terminal, wrapped by `restart.sh`, which
-then sends one notification naming the shells that came back, or a critical
-one naming those that did not. Back means a `qs` instance on the shell's
-config path under a pid it did not have before, within 5s: the old instance
-can linger in the list for a moment after `qs kill`. It is the process, not
-the config: a shell that starts with a broken component counts as back.
-
-The script is started with `Quickshell.execDetached`, which leaves it outside
-the desktop shell's process: restarting `desktop` from here kills the process
-drawing the page and the script carries on and starts the new one. The
-settings window closes with it and is not reopened. The new shell inherits
-the desktop shell's environment, which is the one Hyprland's autostart gave
-it.
-
-A hung desktop shell cannot be restarted from here, since the page is part of
-it. `./reload.sh` from a terminal remains the way out.