Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。
Current Status
Last updated: 2026-10-27
This is the compact execution/deployment index. Product modules own behavior, verification status summarizes material evidence limits, and Git/PRs own completed history.
Accepted Release Contract
- The 2.0 release boundary uses Browser/server v24, Native control v10 and capture v7. App and Site must upgrade together; 1.x cannot participate in a 2.0 session. SQLite schema 2 is unchanged. Versioning owns compatibility between published Web/App/Server versions.
- Hosted Server defaults to SQLite schema 2. Room authority has no inactivity expiry by default; replacement/deletion or grant rotation/revocation ends the corresponding authority. Explicit memory mode and App Local end rooms at process exit. Site access retains its separate 24-hour idle lifetime within one service run; service restart requires site-password entry again.
- Camera sharing and room voice are accepted product features. Source audio follows the picture; room voice owns conversation microphones under the same route controller. Optional Host commentary belongs to the share's audio and has separate activation. Device selection and sharing settings keep their owners. The capture assessment owns platform behavior and platform limits.
Accepted Interaction Phase
Text chat, reactions, room voice and attended remote control are accepted product features. They use existing room authority and the shared route controller; picture, voice and input grants retain their separate lifetimes. The room-interaction design records the design; product standards own current behavior. Release artifacts and operator records own delivery completion.
Current Work
The maintenance candidate preserves published protocols, compatibility and route ownership. New release feedback has reopened Windows capture termination and Browser motion-sharing cadence investigations. Device-loss recovery now retains the active media session; the original termination triggers remain under investigation. Isolated 3.0 work proceeds from the accepted semantic model rather than a mechanical translation of the current implementation. TODO is the only unfinished-work ledger; Git and PRs own completed fixes. Verification status owns material acceptance and platform boundaries.
The Android system-browser App shares the desktop Web UI and Go core, including Local/public-link rooms, Site approval, native screen capture and room voice. Its universal APK covers ARM64 and x64 through the shared release pipeline; device evidence and remaining work retain their existing owners. iOS remains separate.
Room voice, shared keyboard/mouse and optional Windows virtual gamepads use the normal App/Web interfaces. App packages contain no optional input SDK or driver. Linux uinput has an isolated kernel check; desktop permission and game-recognition coverage is pending. macOS virtual HID needs an Apple entitlement and physical build/runtime checks. The input assessment owns platform details.
App Local invitations use HTTPS on the selected LAN address, with a loopback entry for the Host. Hosted Server supports direct HTTPS with temporary or operator-supplied certificates. The HTTPS runbook owns setup. Virtual LANs and frp use the existing room and UDP media paths. The website uses the selected bilingual film A, loaded on demand with shared product playback controls and a persistent final card.
Optional coordinated Native UDP preparation augments the existing retry owner. The network laboratory covers all Browser/App pairings, recovery, SFU policies and successful two-App preparation through sequential kernel NAT. These results do not establish a public success rate. Magicsock integration is not planned; its controlled comparison records the technical basis.
The media assessment owns bounded output and live-control evidence. Additional codecs, surround delivery and end-to-end HDR remain outside the published phase.
Deployment
The immutable release descriptor, runtime REVISION and operator deployment
record own exact identity and postflight results.
The private deployment uses one Go process for Web, room authority/signaling, STUN and optional SFU, with nginx for HTTPS. The self-hosting runbook owns listeners and network configuration.
The separate US public demo is deployed with open site
entry, persistent room authority and P2P-only media. Cloudflare fronts HTTP/WSS
and caches static bundles; STUN uses a separate DNS-only hostname. Caddy owns
origin HTTPS, and the standard systemd service runs the published Server package.
Demo expires rooms after one hour without authenticated participants; the private
deployment retains the default of no expiry. The operator record owns exact
identity and postflight evidence. piik.tv runs on GitHub Pages behind
Cloudflare; website delivery includes a bilingual documentation center built
from repository guides.
GitHub owns original Server and App packages; AtomGit mirrors them without rebuilding and verifies anonymous downloads against their checksums. Server packages cover Linux x64/ARM64 and Windows x64; Docker images are Linux-only. App packages cover Windows x64 and macOS/Linux x64/ARM64. Accepted product changes publish through the release workflow; standalone website/documentation changes deploy the site without creating App/Server versions. Versioning owns release identity, notes, compatibility and mirror publication.