Skip to content
SkyCacheSkyCache
Phone path

Phone handoff ops

Software v1.35.0 ships handoff doctor, join-card QR, export, and import. Phones join the local hub SSID, scan a QR, save demos, or carry a USB/SD mule. Not free commercial broadband tethering.

Honest rails

Local hub Wi-Fi, USB, or SD only. No cloud mule, no free Starlink claim, no commercial constellation decryption. Public-domain demos are not medical advice.

Operator commands

# Phone-path readiness (packages + demos + QR engine)
python -m skycache handoff doctor

# Join card: SSID + portal URL + offline SVG QR
python -m skycache handoff join-card \
  --portal-url http://10.42.0.1:8080/ \
  --ssid SkyCache-Village

# One-shot mule: packages + join card + zip under data/handoff
python -m skycache handoff export --limit 10

# Import on a second node (dir or zip)
python -m skycache handoff import data/handoff/skycache-handoff-*/ 

# Hub API (when serve is running)
# GET  /api/handoff/status
# POST /api/handoff/join-card
# POST /api/handoff/export

Phone day outline

  1. Hub: handoff doctor reports go_phone_path true
  2. Print or display join.html (SSID + QR to portal)
  3. Phone: join hub SSID; turn off mobile data if captive portal is flaky
  4. Open portal; Library → Save demos to this phone (no cell plan)
  5. Optional: open /handoff/ for USB mule packs
  6. Second node: handoff import of zip or folder

Mule notes

  • Export writes under data/handoff (join.html, packages, zip)
  • Optional: pip install qrcode for SVG QR (modules only; no PIL required)
  • Legacy: skycache handoff --out DIR still exports
  • Zero-network kit (no Wi-Fi and no cell) remains separate: docs/zero-network-phone.md