AAA
0dde5da859
## Problem and outcome App downloads used tar.gz archives, which are less convenient to open with desktop file managers. Windows, macOS and Linux App packages now ship as ZIP files. Packaging extracts the completed ZIP and runs the existing runtime checks against those extracted files, covering the actual distributed package. The website links directly to the published ZIP for each platform, with an explicitly labeled GitHub primary download and matching Gitee alternative. Server deployment archives retain their existing format. ## Release notes ### 中文 - Windows、macOS 和 Linux 客户端改用 ZIP 压缩包，下载后可直接使用系统解压工具完整解压。 - 官网按系统提供 ZIP 直接下载和 Gitee 备用下载入口。 ### English - Windows, macOS and Linux App downloads now use ZIP archives for easier extraction with desktop file managers. - The website provides direct ZIP downloads for each platform, with Gitee as an alternative download source. ## Verification - `npm run check`: 58 test files / 760 tests, TypeScript and production build passed. - Real ZIP round-trip verification covers nested, hidden and Unicode paths; Unix checks also verify executable modes and launch the extracted fixtures. Windows archive checks passed locally; all three native packaging runners execute the existing runtime checks from the final extracted ZIP. - Website build, release/mirror validation tests, documentation, repository hygiene and diff checks passed. ## Impact Compatible packaging change. Product behavior, protocols and existing published release artifacts remain unchanged. The release pipeline publishes a new patch version and refreshes website links after publication.
Piik
Share the good stuff.
Private screen sharing for you and up to 20 friends.
Website · Download · Gitee mirror · Try the demo · Documentation
English · 简体中文
Piik is a free, open-source screen sharing tool for games, movie nights, drawings and photos. Choose what to share and send an invitation. Your friends watch in their browsers.
A little room · Show / hide animation
Features · Get started · Self-hosting · Contributing
Features
- Watch without installing. Friends join by invitation in a desktop or mobile browser.
- Share from Piik App or an existing Piik site. Capture a screen, window or browser tab; available sources and audio depend on the platform.
- Direct connections first. Media travels between participants where possible (P2P). A self-hosted server can provide automatic media forwarding (SFU) as a fallback.
- Rooms you control. Invitations, room codes and optional room passwords, for one host and up to 20 viewers.
- Flexible viewing. Light and dark themes, playback controls, picture-in-picture and a connection topology view.
- One program to host a site. Web UI, room management and optional media forwarding are packaged together.
Interface preview · Sample room with a generated game scene
Get started
To watch: open the invitation your friend sends you. Select Play if the picture does not start automatically.
To share:
| Start here | What you need to do |
|---|---|
| Try the online demo | Open it in a desktop browser and start sharing. |
| Download Piik App | Extract and open the App, choose Public invite, then Open Piik to create a temporary room. |
| Use an existing Piik site | Open the address your friend or administrator provides. Hosting your own is an advanced option. |
- Select Start sharing, then choose the picture and audio to share.
- Select Copy invite link and send it to your friends. Keep the sharing tab open.
Piik uses icon controls by default; select EN in the header to show labels. The App offers a local room, a temporary public link, or a connection to your own site. Keep the App running while sharing through it.
Download a ZIP beginning with piik-app. The filename also identifies the platform:
| Filename contains | Platform |
|---|---|
windows-amd64 |
Windows x64 |
darwin-arm64 |
Apple silicon; native capture requires macOS 13+ |
linux-amd64 |
Linux x64 |
Full setup guide → · Open the demo →
Browser capture requires HTTPS or localhost. Windows App and desktop browser
sharing are the primary tested paths. The macOS and Linux apps have not yet been
tested on physical devices; test results and feedback are welcome.
P2P-only modes, including the App's temporary public
link and the demo, may not connect on restrictive networks.
Self-hosting
Piik Server is a standalone binary with the web interface built in. Download the Linux x64 Server package, extract it, and run:
./piik-server
Open http://localhost:8787 to try it locally. For a public site, configure your
domain, HTTPS reverse proxy and STUN address. Room data is stored in SQLite.
Deploy your own site → · Configuration · Run from source
Contributing
Bug reports, documentation improvements and pull requests are welcome. Start with CONTRIBUTING.md, or see the repository layout to find your way around.
License
Piik-owned code is MIT licensed. Dependencies retain their own licenses and notices.