Use an iPhone or iPad as an additional display on a Linux Wayland desktop.
Install the iOS/iPadOS receiver · Linux guide · Upstream project
Warning
This is a highly experimental, vibe-coded personal fork. It is not expected to merge back into the upstream project, compatibility may break without notice, and maintenance will be limited. Use it only if you are comfortable diagnosing Linux, Wayland, PipeWire, portal, and hardware-encoding issues.
This fork adds a Linux sender while retaining the original OpenDisplay iOS/iPadOS receiver and wire protocol. The Linux application supports:
- KDE Plasma Wayland through
xdg-desktop-portal-kdeand KScreen. - Hyprland through
xdg-desktop-portal-hyprlandand headless outputs. - Wi-Fi discovery with Avahi and USB connectivity through
usbmuxd. - PipeWire capture and FFmpeg H.264 encoding, including supported hardware encoders.
- A command-line client and an experimental Qt Quick/Kirigami GUI.
Other compositors and non-Wayland sessions are currently unsupported. Portal behavior also depends on compositor and desktop versions, so successful setup on one system does not guarantee identical behavior elsewhere.
No modified mobile application is required. Install and run the same upstream OpenDisplay receiver on an iPhone or iPad from the OpenDisplay installation page. The receiver currently requires iOS/iPadOS 16 or newer. The public TestFlight beta remains available when offered by the upstream project.
An Arch Linux PKGBUILD is provided under
Linux/packaging/arch/. Source builds and the
package include both opendisplay-linux and opendisplay-gui.
For dependencies, package-building commands, Wi-Fi and USB setup, monitor placement and scaling options, KDE/Hyprland notes, and troubleshooting, use the dedicated Linux README.
The original macOS sender, iOS/iPadOS receiver, website, and shared protocol remain in this repository for compatibility and reference. Upstream development belongs at peetzweg/opendisplay. This fork remains available under the repository's GPL-3.0 license.