mirror of
https://github.com/DeeJanuz/frametop.git
synced 2026-10-06 00:00:07 +02:00
DeeJanuzandClaude Opus 5.5
0ac2b10cd7
- gaze/tracker/lab/eyes_track.py: nothing used it - Input Settings: the pointer role backend, whose page was removed - ft-screens: no log line for every floating-window resize - hands: ft-hands --help gives the palm-down default (1: off), the uninstall removes ft-handsctl's link, .frame-job is ignored - Display Settings: "Save as profile…", not "Save current arrangement" - two stale comments (ft-pointer's grabprobe, ft-gaze) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
64 lines
3.2 KiB
Bash
Executable File
64 lines
3.2 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# Install, start, stop, or inspect hand tracking on the Frame: ft-camd (the camera broker) and
|
|
# ft-hands (the tracker), user services that stop with SteamVR. They don't start with it:
|
|
# ft-handsctl on|off (on the Frame) or hands/run.sh start|stop.
|
|
# Usage: hands/run.sh install|uninstall
|
|
# hands/run.sh caps # give ft-camd its capabilities again (a rebuild clears them)
|
|
# hands/run.sh start|stop|restart|status|log [lines]
|
|
# install and caps need the password (sudo setcap, once per build of ft-camd). On the Frame,
|
|
# sudo asks in the terminal. From a PC (or with no terminal), the password comes from
|
|
# steamos_root_pwd in the repo's .env and is sent to sudo -S on stdin, never on a command line.
|
|
set -euo pipefail
|
|
root=$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)
|
|
. "$root/scripts/_env.sh"
|
|
frame="$root/scripts/frame.sh"
|
|
units="frametop-camd.service frametop-hands.service"
|
|
# pidfd_getfd on XRService (ptrace_scope=1), system-wide tracepoints, and their root-only
|
|
# format files. ft-camd drops them all once it has set up.
|
|
caps=cap_sys_ptrace,cap_perfmon,cap_dac_read_search+ep
|
|
|
|
sudo_run() {
|
|
if [ "$FRAME_LOCAL" = 1 ] && [ -t 0 ]; then
|
|
sudo bash -c "$1" # asks for the password here
|
|
return
|
|
fi
|
|
local pw
|
|
pw=$(sed -n 's/^steamos_root_pwd=//p' "$root/.env" 2>/dev/null)
|
|
pw=${pw#[\"\']}; pw=${pw%[\"\']} # .env values may be quoted
|
|
[ -n "$pw" ] || { echo "no terminal for sudo, and steamos_root_pwd is missing from $root/.env" >&2; exit 1; }
|
|
printf '%s\n' "$pw" | on_frame "sudo -S -p '' bash -c $(printf %q "$1")"
|
|
}
|
|
|
|
set_caps() { # only when missing: a rebuild clears them, a reinstall doesn't
|
|
local bin
|
|
bin=$(printf %q "$FRAME_REPO/hands/build/ft-camd")
|
|
if on_frame "getcap $bin | grep -q cap_sys_ptrace"; then
|
|
echo "ft-camd has its capabilities"
|
|
return
|
|
fi
|
|
sudo_run "setcap $caps $bin && getcap $bin"
|
|
}
|
|
|
|
states="for u in $units; do echo \"\$u: \$(systemctl --user is-active \$u)\"; done"
|
|
|
|
case ${1:-status} in
|
|
install)
|
|
"$root/hands/build.sh"
|
|
set_caps
|
|
for u in $units; do
|
|
fill_template "$root/hands/$u" | on_frame "mkdir -p ~/.config/systemd/user && cat > ~/.config/systemd/user/$u"
|
|
done
|
|
# Installed but not started with SteamVR: ft-handsctl on|off (linked into ~/.local/bin).
|
|
"$frame" --host "set -e; systemctl --user daemon-reload; systemctl --user disable $units 2>/dev/null || true
|
|
mkdir -p ~/.local/bin && ln -sfn $(printf %q "$FRAME_REPO/hands/ft-handsctl") ~/.local/bin/ft-handsctl
|
|
$states; echo 'start it with: ft-handsctl on'" ;;
|
|
caps) set_caps ;;
|
|
uninstall) "$frame" --host "systemctl --user disable --now $units 2>/dev/null
|
|
for u in $units; do rm -f ~/.config/systemd/user/\$u; done; systemctl --user daemon-reload
|
|
[ -L ~/.local/bin/ft-handsctl ] && rm -f ~/.local/bin/ft-handsctl; echo removed" ;;
|
|
start|stop|restart) "$frame" --host "systemctl --user $1 $units; $states" ;;
|
|
status) "$frame" --host "$states; journalctl --user -u frametop-hands.service --no-pager -o cat -n 4" || true ;;
|
|
log) "$frame" --host "journalctl --user -u frametop-camd.service -u frametop-hands.service --no-pager -o short -n ${2:-30}" ;;
|
|
*) echo "usage: $0 install|uninstall|caps|start|stop|restart|status|log [lines]" >&2; exit 2 ;;
|
|
esac
|