Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 15 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@ right from it.
[Support](https://meowdisplay.app/support.html) ·
[Privacy](https://meowdisplay.app/privacy.html)

<a href="https://apps.apple.com/us/app/meowdisplay/id6817552864"><img src="assets/readme/app-store-badge.svg" alt="Download on the App Store" height="44"></a>

<br>

<img src="assets/readme/hero.webp" alt="The MeowDisplay Mac app open to Overview, beside the MeowDisplay receiver on iPhone" width="760">
Expand All @@ -32,9 +34,11 @@ you control, with devices paired and every session encrypted.
No MeowDisplay account is required, and there is no MeowDisplay-hosted relay
or server in the middle.

<sub>Public release builds are being prepared. There is no public download or
App Store release yet. The source is available here and can be
[built from source](#build-from-source).</sub>
**MeowDisplay for iPhone and iPad is free on the [App Store](https://apps.apple.com/us/app/meowdisplay/id6817552864)**
(iOS/iPadOS 16.4 or later). It works with the MeowDisplay Mac app (macOS 14
or later), which is currently available only by
[building it from source](#build-from-source): there is no signed, notarized
Mac download yet.

## At a glance

Expand Down Expand Up @@ -341,8 +345,9 @@ More in [SECURITY.md](SECURITY.md) and the

## Getting started

1. Run MeowDisplay on your Mac.
2. Open the MeowDisplay receiver on your iPhone or iPad.
1. Build and run MeowDisplay on your Mac ([Build from source](#build-from-source)).
2. Install [MeowDisplay from the App Store](https://apps.apple.com/us/app/meowdisplay/id6817552864) on your iPhone or iPad
and open it.
3. Connect over USB or Wi-Fi, and pair the devices by confirming the matching
code.
4. Choose **Mirror** or **Extend**.
Expand All @@ -362,8 +367,11 @@ echo "DEVELOPMENT_TEAM=YOURTEAMID" > .env
./generate.sh
```

Open `MeowDisplay.xcodeproj` and run the `OpenSidecarMac` (Mac) and
`OpenSidecariOS` (iPhone/iPad receiver) schemes. Signing, permissions and
Open `MeowDisplay.xcodeproj` and run the `OpenSidecarMac` scheme for the Mac
app. The [`release/app-store-rc`](https://github.com/raiseCatError/meowdisplay/tree/release/app-store-rc) branch matches the App Store
version (1.20.0). The iPhone/iPad receiver is on the
[App Store](https://apps.apple.com/us/app/meowdisplay/id6817552864); to build it yourself instead, run the `OpenSidecariOS`
scheme. Signing, permissions and
troubleshooting are in [SETUP.md](SETUP.md); release process in
[RELEASE.md](RELEASE.md).

Expand Down
6 changes: 4 additions & 2 deletions SETUP.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,10 @@ current capabilities.
`macos-26` runner). The Mac sender target's deployment target is macOS 14;
the Mac Receiver target is macOS 12; the iOS target is iOS/iPadOS 16.4.
- [`xcodegen`](https://github.com/yonaskolb/XcodeGen) — `brew install xcodegen`.
- A free or paid Apple Developer account, to sign the iOS build for your
device (a free account is enough for local sideloading).
- A free or paid Apple Developer account, to sign the Mac build and, if you
build it yourself, the iOS build for your device (a free account is enough
for local sideloading). The iPhone/iPad receiver is also available from the
[App Store](https://apps.apple.com/us/app/meowdisplay/id6817552864), which needs no signing.

## Clone

Expand Down
46 changes: 46 additions & 0 deletions assets/readme/app-store-badge.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
60 changes: 60 additions & 0 deletions launch/APP_STORE_LAUNCH.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
# MeowDisplay is now on the App Store

*October 25, 2026*

**Your Mac. Another screen. Anywhere.**

MeowDisplay for iPhone and iPad is now available, free, on the App Store:
<https://apps.apple.com/us/app/meowdisplay/id6817552864>

MeowDisplay turns your iPhone or iPad into a mirrored or extended display for
your Mac, and lets you control the Mac from it: Direct Touch, a trackpad-style
pointer, Mac gestures, a keyboard, control trays and shortcuts, Apple Pencil on
supported iPads, and Mac system audio on the receiver.

Connect over USB or Wi-Fi, pair your devices once by confirming a matching
code, and make a little more room for your Mac.

Free and open source. No MeowDisplay account required.

## What you need

| | |
|---|---|
| **iPhone or iPad** | iOS or iPadOS 16.4 or later. [MeowDisplay on the App Store](https://apps.apple.com/us/app/meowdisplay/id6817552864), free |
| **Mac** | macOS 14 or later, running the MeowDisplay Mac app |

**The Mac app is not on the App Store and has no signed download yet.** For now
you build it from source with Xcode (a free Apple account is enough to sign
it). The [`release/app-store-rc`](https://github.com/raiseCatError/meowdisplay/tree/release/app-store-rc)
branch matches App Store version 1.20.0. Setup:
<https://meowdisplay.app/docs#status>. A signed, notarized Mac download will
follow through the project's release workflow; this note will be updated when
it exists.

## Good to know

- Mac-to-iPhone is the primary tested setup. iPad and the standalone Mac
Receiver work but need broader hardware validation.
- Remote Access works over a private network you set up yourself, such as
Tailscale. MeowDisplay runs no relay or server of its own.
- Controlling the Mac needs Accessibility permission, **Allow Input** turned on,
and a control request from the device each session. Connecting alone never
grants control.
- The app is in English for now.

## Thank you, OpenDisplay

MeowDisplay started as a fork of [OpenDisplay](https://github.com/peetzweg/opendisplay)
by Philip Poloczek, which provided the working foundation: Mac screen capture,
virtual displays, video encoding and the original receiver. MeowDisplay remains
open source under GPL-3.0.

## Links

- App Store: <https://apps.apple.com/us/app/meowdisplay/id6817552864>
- Website: <https://meowdisplay.app/>
- Setup: <https://meowdisplay.app/docs>
- Features: <https://meowdisplay.app/features>
- Support: <https://meowdisplay.app/support>
- Source: <https://github.com/raiseCatError/meowdisplay>
Loading
Loading