Piik

Share the good stuff.
Private screen sharing for you and up to 20 friends.

Website · Download · Gitee mirror · Use online · Documentation

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

A host with a gold crown switches between a gamepad, paintbrush, camera and remote as friends watch games, drawings, photos and a film.

[Features](#features) · [Get started](#get-started) · [Self-hosting](#self-hosting) · [Contributing](#contributing) ## Features - **Watch without installing.** Friends join by invitation in a desktop or mobile browser. - **Share from Piik App or an existing Piik site.** Choose a screen, window, browser tab or camera; 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. - **Chat while watching.** Send messages and reactions to friends, with optional on-screen chat. - **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.

Piik room: a shared game, playback controls, chat and friends on a sofa. The host wears a small gold crown.
_{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:** download **Piik App** to get started. To share without installing, you can also create a room in the online version. | Start here | What you need to do | | --- | --- | | [Use Piik online](https://demo.piik.tv) | Share from a desktop browser, or choose Camera on a phone with browser camera support. | | [Download Piik App](https://piik.tv/#download) | Extract and open the App, choose **Public invite**, then **Open Piik** to create a temporary room. | | [Host your own site](./docs/operations/self-hosting.md) | Advanced: deploy Piik Server on a Linux x64 or ARM64 server with your own domain, then connect through Piik App or a browser. |

Choose a screen, send an invitation, watch together.

1. Select **Start sharing**, then choose the picture and audio to share. 2. Select **Copy invite link** and send it to your friends. Keep the sharing tab open. Turn on the **Microphone** for commentary; its settings let you choose the input device and adjust your voice volume. Piik follows your system language: Chinese or English, with English as the fallback. Use **中 / EN / ✦** in the header to switch language or try the visual mode. 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+ | | `darwin-amd64` | Intel Mac; native capture requires macOS 13+ | | `linux-amd64` | Linux x64 | | `linux-arm64` | Linux ARM64 | [**Full setup guide →**](./docs/guide/getting-started.md) · [**Open online →**](https://demo.piik.tv) Browser capture requires HTTPS or `localhost`. Windows App and desktop browser sharing are the primary tested paths. Physical-device coverage for the macOS and Linux apps is still limited; [test results and feedback are welcome](https://github.com/TNTcraftHIM/Piik/issues). P2P-only modes, including the App's temporary public link and the online version, may not connect on restrictive networks. ## Self-hosting Piik Server is a standalone binary with the web interface built in. Download the Server package for Linux x64 (`piik--runtime.tar.gz`) or ARM64 (`piik--linux-arm64-runtime.tar.gz`), extract it, and run: ```sh ./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. For containers, use the [Docker Compose setup](./docs/operations/self-hosting.md#docker-compose). [**Deploy your own site →**](./docs/operations/self-hosting.md) · [Configuration](./docs/standards/configuration.md) · [Run from source](./docs/README.md#run-from-source) ## Contributing Bug reports, translations, documentation improvements and pull requests are welcome. See [ways to contribute](./CONTRIBUTING.md#ways-to-help) or [help translate Piik](./docs/guide/translating.md). Use the [repository layout](./docs/standards/engineering.md#repository-layout) to find your way around. ## License Piik-owned code is [MIT licensed](./LICENSE). Dependencies retain their own [licenses and notices](./licenses/README.md).