saphidandClaude Opus 5.5
1f6115b789
README with the minimum-typing checklist (Developer Mode toggle + Set User Password; the rest runs from the Mac), docs for SSH, streaming, file transfer, and open questions with sourced confidence levels, plus Mac-side zsh helpers and a fallback headset bootstrap. Scripts are UNTESTED against hardware: checked with zsh -n / bash -n / shellcheck only. Two SWE-2 Max read-only review passes (devin -p --model swe-2-max); verified findings fixed. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2.9 KiB
File transfer and clipboard
The confidence labels are the same as in ssh.md. Everything here
depends on SSH working through the frame alias from scripts/connect.sh.
Options
| Option | Command | Confidence | Notes |
|---|---|---|---|
| scp / rsync over SSH | ./scripts/push.sh file-or-dir [dest], or rsync -a --progress x frame:Downloads/ |
Inferred. SSH is confirmed. Valve recommends WinSCP (SFTP) for Windows (debugging), which means SFTP is enabled. | Recommended. The Mac ships rsync (newer macOS uses openrsync, which supports the flags used here). rsync must also exist on the Frame. It's in SteamOS on Deck; if it's missing on the Frame, push.sh falls back to scp. |
| SFTP GUI | Finder can't do SFTP. Use Cyberduck / Transmit / ForkLift with sftp://steamos@frame.local |
Inferred | Good for browsing. |
adb push |
adb push x /sdcard/Download/ (Lepton) |
Confirmed that ADB exists (adb_lepton) | Only reaches the Android container's storage. |
| SteamOS Devkit Client | "Title Upload" | Confirmed (Frame) (loadgames) | For deploying apps and games, not general files. macOS support for the Devkit Client wasn't confirmed. |
| Syncthing | A Syncthing Flatpak on the Frame (./scripts/install-apps.sh <flathub-app-id>), app on the Mac |
Guess (which Syncthing Flatpak, and whether it has an aarch64 build, not checked) | Good for an ongoing shared folder. |
| KDE Connect | KDE Connect on both | Guess | There's a macOS build of KDE Connect, but whether it's present or installable on the Frame wasn't confirmed. It would give you clipboard sync, file send, and remote input. Worth checking on-device. |
| microSD | Physical card | Confirmed that the slot exists (Wikipedia) | Offline fallback. |
Clipboard
scripts/paste-to-frame.sh sends the Mac clipboard (or stdin) to the
headset's desktop clipboard. You can then paste in the headset with the
virtual keyboard's paste key or a right-click → Paste.
./scripts/paste-to-frame.sh # sends pbpaste
echo "https://example.com" | ./scripts/paste-to-frame.sh -
How it works (untested). Over SSH, the script finds the logged-in Plasma
session's XDG_RUNTIME_DIR and wayland-* socket, then runs wl-copy. If
there's no Wayland socket or no wl-copy, it tries xclip with DISPLAY=:0.
It assumes the in-headset desktop is a normal Plasma session owned by
steamos. That isn't known yet: the headset desktop may be a KWin session
nested inside SteamVR. If both methods fail, the script prints what it found so
the approach can be adjusted.
A simpler fallback: ssh frame 'cat > ~/clip.txt' < file, then open it in the
headset.