Document daemonizing-command gotcha and exited-state UI in README

This commit is contained in:
2026-09-14 06:45:58 +00:00
parent ed80445283
commit 7c240c6a8f
+15
View File
@@ -48,6 +48,16 @@ file manager (allow "install from unknown sources" if asked).
``` ```
The default, `sleep 180`, is just a harmless placeholder for testing The default, `sleep 180`, is just a harmless placeholder for testing
that the app itself works before wiring up your real command. that the app itself works before wiring up your real command.
**If your command daemonizes/detaches** (`tmux new-session -d`,
`screen -d`, `nohup ... &`, etc.), the app sees the *launching*
command exit successfully the moment the detached thing is created —
not when the real workload actually ends — and will show the
"process exited" screen (see below) even though your daemon is still
running fine. Make the command wait on the real thing instead, e.g.:
```
su -c '... -- sh -c "tmux new-session -d ...; while tmux has-session 2>/dev/null; do sleep 5; done"'
```
3. Tap **Save**. 3. Tap **Save**.
4. (Recommended) In Android's own Settings → Apps → Slocker Launcher → 4. (Recommended) In Android's own Settings → Apps → Slocker Launcher →
Battery, turn off any "put app to sleep" / battery optimization for Battery, turn off any "put app to sleep" / battery optimization for
@@ -66,6 +76,11 @@ file manager (allow "install from unknown sources" if asked).
running in the background. There's no way back to the menu from here running in the background. There's no way back to the menu from here
by design — this mode is meant to run unattended. To change settings by design — this mode is meant to run unattended. To change settings
again, close/reopen the app (or reboot). again, close/reopen the app (or reboot).
- If your command exits (crashes, finishes, or never started), the screen
stays black and on, but a small message + Exit button appear at a
random position, moving to a new random spot every minute — so a device
left unattended in this state for a long time doesn't develop burn-in
from a static message. Tap Exit to close the app.
- Output (and any startup errors) from your command is logged to a file - Output (and any startup errors) from your command is logged to a file
inside the app's own storage, useful if something didn't start the way inside the app's own storage, useful if something didn't start the way
you expected. Pull it with: you expected. Pull it with: