PearPlayYour desktop stays on your desktop.
No screen mirroring, re-encoding, or extra computer relaying the video. PearPlay passes the source URL; it does not promise a particular resolution or site compatibility.
Browser to Apple TV · Linux only
Your browser’s video.
Your Apple TV.
Send a compatible stream to the TV. Not your desktop. Not a re-encoded copy.
Choose the video. Choose the receiver.
Keep the handoff in your hands.
Experimental, manually installed. Playback has been verified in Linux Chrome, Brave and Chromium. Mac support is coming soon. Broader stream compatibility remains unverified. Not every website works.
The stream takes
the direct route.
PearPlay sends a compatible media URL to the receiver. The Apple TV fetches it from the site. The browser extension and local helper carry the controls—not the video.
Media sourceThe site’s streamReceiver-fetchable HTTP(S)
ReceiverYour Apple TVNo PearPlay media relay
Local by design.
No PearPlay account or cloud service required. Pairing credentials stay on your machine. You choose what to send and where it goes.
A deliberate handoff.
Three choices.
One-time setup comes first: load the extension and install the local helper. The first-run setup tab checks the connection; reopen it with Setup in the popup.
- 01 / Access
Allow, then find.
Grant website access on a click, start the video, then choose Find videos. This version requires all-sites access for discovery.
- 02 / Destination
Choose the video and TV.
Connect the helper and find Apple TVs on your network. Select the stream and receiver; pair if asked.
- 03 / Send
Send. Watch. Confirm.
Press Send to TV. Check for video and sound on the TV. If the browser is also playing, stop it with the website’s controls.
What works.
What is still open.
A successful request is not proof of playback. The verified results below come from recorded human observations—not a spinner, timer or HTTP response.
Linux Chrome, Brave and Chromium + Apple TV
- Playback was verified through the extension and Linux helper in Chrome, Brave and Chromium. Chrome video and audible sound were separately confirmed on a tested stream.
- A pre-roll-to-program transition on that tested stream. PearPlay does not block ads.
- Helper-session end stopped that tested session, and recasting worked. This is not a general stop guarantee.
- Public HLS video and audio through the earlier command adapter.
Broader compatibility
- Mac support is coming soon. Compatibility work is paused, with no release date promised.
- Audio and broader stream compatibility in Brave and Chromium have not been separately documented.
- Invalid/expired-stream handling and broader receiver lifecycle trials remain open.
- End helper session closes the helper connection; it does not confirm the TV stopped.
See the latest result at the top of STATUS.md. Older checkpoints remain as history. Claim-by-claim evidence.
Bring your own browser.
Install locally.
Flatpak-installed versions of Google Chrome and Chromium are not supported. Use your distribution’s native browser package instead.
Linux helper 0.2.5 preview downloads are available for x86_64 computers. Python is bundled. Install PearPlay from the Chrome Web Store (currently 0.2.6). The pending 0.2.7 update adds a compact popup and clearer errors. Fedora downloads are already available. The Store extension and unpacked source share the same identity, so no manual extension-ID command is needed.
Ubuntu 24.04 baseline / glibc 2.39+ for the .deb; glibc 2.44+ for Arch; Fedora 44 / glibc 2.43+ for the RPM. No ARM packages. Fedora installation instructions. Release notes and checksums. Packages are unsigned: use the trusted release and normal package-manager authentication, without disabling security checks.
Ubuntu / Debian
Open the .deb with your software installer. Open With → App Center was verified on a supported Linux desktop. Terminal fallback after downloading:
cd ~/Downloads sudo apt install ./pearplay-helper-0.2.5-linux-x86_64.deb
Arch / Omarchy
Save the Arch / Omarchy download in Downloads without renaming or extracting it. Open the Terminal app, copy and paste the command below, then press Enter:
sudo pacman -U "$HOME/Downloads/pearplay-helper-0.2.5-linux-x86_64.pkg.tar.zst"
If asked, type your computer password and press Enter. Nothing appears while you type—that is normal. Review the installation prompt, then type Y and press Enter. Wait until installation finishes.
Open PearPlay Setup from your app launcher, select your browser, then fully quit and reopen it. Closing only a tab or reloading the extension is not enough. In PearPlay’s Helper setup, click Check connection.
File not found? Check that it is in Downloads with the exact filename above. For other installation errors, stop and use the installation guide; do not disable package-signature checks.
Open PearPlay Setup, select Chrome, then fully quit and reopen it. In the extension’s Helper setup, choose Check connection. If testing the unpacked extension, keep its source folder in place; Store installs do not need that folder. A receiver-scoped timing firewall rule may be needed; never disable your firewall. See the complete installation guide for extension loading, updates, older registration conflicts and removal.
Mac support is coming soon.
Before you send.
Useful limits, not small print.
Will it work with every player?
No. The receiver needs a directly fetchable HTTP(S) media URL. A blob: URL cannot be handed off. PearPlay does not transfer browser cookies, bypass DRM or geography, or defeat access controls. Signed and expired URLs may fail. Use only media you are authorized to access.
Can I allow just one website?
The popup offers a per-site grant, but Find videos currently stays disabled without all-sites access. That limitation is disclosed rather than presented as working site-only discovery. Access is requested on a click, not silently at install.
Does it block ads?
No. PearPlay respects normal ad delivery and does not bypass DRM, geography or access controls. A pre-roll-to-program transition was observed on one tested stream; that does not establish compatibility with every service.
Private control.
No extra account.
The extension communicates with a helper on your machine. Pairing credentials are stored locally in a 0700 directory with a 0600 file. The media origin and Apple TV still communicate over the network; “local” does not make the stream anonymous. No telemetry endpoint is present in the audited extension/helper sources.