A media player everyone shares.
Run Couch on the computer by the TV. Everyone else joins from their phone or laptop by scanning a QR code: no app to install, no account. Together you choose what plays, which devices play it, and whose screen or sound to share. Couch is free and open source, one of the projects of avoid.quest.
- Movie night: find a film or series, play it on the TV, steer it from your phone, and pick up next time where you stopped.
- A party queue: everyone adds songs and videos from their own phone.
- Music through the house: the kitchen and living room in step, then into the shower on your phone.
- A late film: picture on the TV, sound in your headphones.
- Game night: your screen and its sound on the TV and on friends' laptops.
- A gig in everyone's ears: the sound desk's mix on the audience's phones, close to live.
Each of these is a story with its journey and what works today. Sources: YouTube, Twitch, RaiPlay, Bandcamp, SoundCloud, film and series catalogues, radio, Live TV playlists, and links from other sites yt-dlp supports (what plays where).
Couch is in preview; there's no stable release yet. Download it from couch.avoid.quest/download or Releases. It updates itself. Phones and laptops that only join don't install anything.
| Computer | Download | Needs |
|---|---|---|
| Mac, Apple Silicon | .dmg |
macOS 14 or later |
| Mac, Intel | .dmg |
macOS 13 or later; some TV channels need a compatible mpv on macOS 13–14 |
| Windows | .exe |
Windows 11, x86_64 |
| Linux | .AppImage |
x86_64, FUSE 2, libgbm1, pulseaudio-utils and PulseAudio or pipewire-pulse |
| Linux Mint, Ubuntu, Debian | .deb |
x86_64; sudo apt install ./couch_<version>_amd64.deb installs its sound dependencies |
See the installation notes for macOS's first launch, Windows's SmartScreen prompt and Linux sound, and the download page to make a computer a dedicated TV.
Use the latest stable Bun (1.4.4+) and Node 24+.
bun install --frozen-lockfile
bun run app # build and start the app, with its data in .data
bun run dev # browser UI and Core with hot reload
bun run check # what to run before a PR
The installed Couch also uses port 4100: give a development run its own
COUCH_PORT and COUCH_DATA_DIR. AGENTS.md is the short guide to
working here; architecture and
checks and releases go further.
Fork it, open an issue, or send a pull request. A new feature starts from its story. PR titles are plain sentences: they become the release notes.
Couch is released under the MIT licence. Its patch to UxPlay
(native/airplay/) is GPL-3.0-or-later, like UxPlay itself, and each package
comes with its dependencies' notices.