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
21 changes: 10 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ 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>
**[Download for Mac](https://github.com/raiseCatError/meowdisplay/releases/latest/download/MeowDisplay.dmg)** · <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" align="center"></a>

<br>

Expand All @@ -34,11 +34,10 @@ 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.

**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.
**Get MeowDisplay:** the [Mac app](https://github.com/raiseCatError/meowdisplay/releases/latest/download/MeowDisplay.dmg) (macOS 14 or later; signed and
notarized, from [GitHub Releases](https://github.com/raiseCatError/meowdisplay/releases/tag/v1.20.0)) and
[MeowDisplay for iPhone and iPad on the App Store](https://apps.apple.com/us/app/meowdisplay/id6817552864) (iOS/iPadOS 16.4 or
later). Both are free.

## At a glance

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

## Getting started

1. Build and run MeowDisplay on your Mac ([Build from source](#build-from-source)).
1. [Download MeowDisplay for Mac](https://github.com/raiseCatError/meowdisplay/releases/latest/download/MeowDisplay.dmg), open the DMG, drag MeowDisplay to
Applications and open it.
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
Expand All @@ -368,10 +368,9 @@ echo "DEVELOPMENT_TEAM=YOURTEAMID" > .env
```

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
app, or `OpenSidecariOS` for the iPhone/iPad receiver. The released 1.20.0
apps (Mac download and App Store) were built from
[`release/app-store-rc`](https://github.com/raiseCatError/meowdisplay/tree/release/app-store-rc). Signing, permissions and
troubleshooting are in [SETUP.md](SETUP.md); release process in
[RELEASE.md](RELEASE.md).

Expand Down
42 changes: 37 additions & 5 deletions RELEASE.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,11 +86,14 @@ a higher build number).

## Required secrets

None are currently configured on this fork. Exact inventory (see the
release-audit issue for the full table): `DEVELOPMENT_TEAM`,
`MATCH_GIT_URL`, `MATCH_DEPLOY_KEY`, `MATCH_PASSWORD`,
`APP_STORE_CONNECT_KEY_ID`, `APP_STORE_CONNECT_ISSUER_ID`,
`APP_STORE_CONNECT_KEY_CONTENT`, and optionally `SPARKLE_PRIVATE_KEY`.
Required: `DEVELOPMENT_TEAM`, `MATCH_GIT_URL`, `MATCH_DEPLOY_KEY`,
`MATCH_PASSWORD`, `APP_STORE_CONNECT_KEY_ID`, `APP_STORE_CONNECT_ISSUER_ID`,
`APP_STORE_CONNECT_KEY_CONTENT`, and `SPARKLE_PRIVATE_KEY`.

As of 2026-10-25 the fork has `DEVELOPMENT_TEAM`, `MATCH_GIT_URL`,
`MATCH_DEPLOY_KEY` and `SPARKLE_PRIVATE_KEY`. `MATCH_PASSWORD` and the three
`APP_STORE_CONNECT_*` secrets are missing, and the match repository holds no
Developer ID certificate yet, so `build-mac` cannot sign or notarize in CI.

## Verification

Expand All @@ -106,6 +109,35 @@ Once a release build exists:
does not accept a build that uses a required-reason API no manifest
declares.

## 1.20.0 Mac release (built locally)

The first MeowDisplay Mac release, `v1.20.0`, was not built by CI (see
[Required secrets](#required-secrets)). It was produced on a Mac signed in to
the team's Apple account, from `release/app-store-rc` @ `cbbad7f` (the source
of App Store 1.20.0), with the same pieces CI uses:

1. `DEVELOPMENT_TEAM=<team> xcodegen generate` from the tracked `project.yml`.
2. `xcodebuild archive` (Release) for `OpenSidecarMac` and
`OpenSidecarMacReceiver`, with `MARKETING_VERSION=1.20.0` and
`CURRENT_PROJECT_VERSION=1`.
3. `xcodebuild -exportArchive` with `method` `developer-id`, `destination`
`upload` and automatic signing: Xcode signs with the team's cloud-managed
Developer ID Application certificate and submits to Apple's notary
service; `xcodebuild -exportNotarizedApp` returns the stapled app.
4. The DMG step from the Fastfile (`hdiutil`, UDZO, Applications link). The
DMG container itself is not code-signed or notarized: the cloud-managed
certificate cannot `codesign` arbitrary files and there were no
`notarytool` credentials. Gatekeeper accepts the stapled app inside
(`spctl`: Notarized Developer ID), and a quarantined copy of the DMG
mounts normally.
5. Appcasts from `generate_appcast`/`sign_update` with the Sparkle key in the
login keychain (account `meowdisplay`), uploaded to the release.

To return to the documented CI path, create an App Store Connect API key
and a Developer ID Application certificate whose private key can be
exported into match, then add `MATCH_PASSWORD` and the
`APP_STORE_CONNECT_*` secrets.

## Rollback / recovery

- A GitHub Release is just tagged, uploaded artifacts — a bad release can be
Expand Down
5 changes: 3 additions & 2 deletions SETUP.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,9 @@ current capabilities.
- [`xcodegen`](https://github.com/yonaskolb/XcodeGen) — `brew install xcodegen`.
- 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.
for local sideloading). To just use MeowDisplay, skip building: download the
[Mac app](https://github.com/raiseCatError/meowdisplay/releases/latest/download/MeowDisplay.dmg) and get the iPhone/iPad receiver from the
[App Store](https://apps.apple.com/us/app/meowdisplay/id6817552864).

## Clone

Expand Down
30 changes: 17 additions & 13 deletions launch/APP_STORE_LAUNCH.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,15 @@
# MeowDisplay is now on the App Store
# MeowDisplay is now available

*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 is out: the iPhone and iPad app is free on the App Store, and the
Mac app is a free, signed and notarized download.

- **Mac:** [Download MeowDisplay for Mac](https://github.com/raiseCatError/meowdisplay/releases/latest/download/MeowDisplay.dmg)
([release notes and checksums](https://github.com/raiseCatError/meowdisplay/releases/tag/v1.20.0))
- **iPhone and iPad:** [MeowDisplay 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
Expand All @@ -21,16 +25,16 @@ Free and open source. No MeowDisplay account required.

| | |
|---|---|
| **Mac** | macOS 14 or later, Apple silicon or Intel. [MeowDisplay.dmg](https://github.com/raiseCatError/meowdisplay/releases/latest/download/MeowDisplay.dmg), free |
| **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.
Open the DMG, drag MeowDisplay to Applications, and open it. Then open
MeowDisplay on your iPhone or iPad, connect, and confirm the pairing code.
Setup guide: <https://meowdisplay.app/docs>

Want to use a spare Mac as a display instead? The optional
[MeowDisplay Receiver](https://github.com/raiseCatError/meowdisplay/releases/latest/download/MeowDisplayReceiver.dmg)
(macOS 12 or later) is on the same release.

## Good to know

Expand All @@ -41,7 +45,7 @@ it exists.
- 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.
- The apps are in English for now.

## Thank you, OpenDisplay

Expand All @@ -52,9 +56,9 @@ open source under GPL-3.0.

## Links

- Mac download: <https://github.com/raiseCatError/meowdisplay/releases/latest/download/MeowDisplay.dmg>
- 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>
52 changes: 26 additions & 26 deletions launch/SOCIAL_POSTS.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,36 @@
# Launch posts: drafts, not posted

Ready-to-publish copy for the App Store launch of MeowDisplay for iPhone and
iPad (October 25, 2026). Nothing here has been posted.

Every post must keep the Mac caveat: the iPhone/iPad app is on the App Store,
but the Mac app currently has to be built from source. Once a signed Mac
download exists, update the posts (and swap "build it from source" for the
download link) before reusing them.
Ready-to-publish copy for the MeowDisplay launch (October 25, 2026): the
iPhone/iPad app on the App Store and the Mac app as a signed, notarized
download. Nothing here has been posted.

Verified links:

- Website (download buttons for both apps): https://meowdisplay.app/
- Mac download: https://github.com/raiseCatError/meowdisplay/releases/latest/download/MeowDisplay.dmg
- App Store: https://apps.apple.com/us/app/meowdisplay/id6817552864
- Website: https://meowdisplay.app/
- Setup: https://meowdisplay.app/docs
- Source: https://github.com/raiseCatError/meowdisplay

Prefer linking https://meowdisplay.app/ in posts: it has both downloads, and a
bare DMG link starts a download without context.

---

## X / Twitter

> MeowDisplay is on the App Store 🐈
> MeowDisplay is out 🐈
>
> It turns your iPhone or iPad into a second display for your Mac: mirror or extend, then control it with touch, trackpad gestures and a keyboard. USB or Wi-Fi. Free, open source, no account.
> Turn your iPhone or iPad into a second display for your Mac: mirror or extend, then control it with touch, trackpad gestures and a keyboard. USB or Wi-Fi. Free, open source, no account.
>
> https://apps.apple.com/us/app/meowdisplay/id6817552864
> Mac app + App Store: https://meowdisplay.app

Reply to the first post:

> Heads up: the Mac side isn't a one-click download yet, you build it from source for now (signed build coming). Setup: https://meowdisplay.app/docs
> iPhone/iPad: https://apps.apple.com/us/app/meowdisplay/id6817552864
> Code: https://github.com/raiseCatError/meowdisplay
>
> Built on the great OpenDisplay project. Code: https://github.com/raiseCatError/meowdisplay
> Built on the great OpenDisplay project.

---

Expand All @@ -39,11 +40,11 @@ Check each subreddit's self-promotion rules first (r/macapps, r/iOSProgramming
Saturday showcase, r/opensource). Post to one or two communities, not all at
once, and stay in the thread to answer questions.

**Title:** I made MeowDisplay, a free and open-source app that turns your iPhone or iPad into a display for your Mac. The iPhone/iPad app just landed on the App Store
**Title:** I made MeowDisplay, a free and open-source app that turns your iPhone or iPad into a display for your Mac

**Body:**

> Hi! MeowDisplay turns an iPhone or iPad into a mirrored or extended display for a Mac, and lets you control the Mac from it.
> Hi! MeowDisplay turns an iPhone or iPad into a mirrored or extended display for a Mac, and lets you control the Mac from it. The iPhone/iPad app is on the App Store and the Mac app is a signed, notarized download.
>
> **What it does**
>
Expand All @@ -55,15 +56,14 @@ once, and stay in the thread to answer questions.
>
> **Limitations, honestly**
>
> - The iPhone/iPad app is on the App Store, but **the Mac app has no signed download yet**. Right now you build it from source with Xcode (a free Apple account works). A notarized build is next.
> - Mac-to-iPhone is the most-tested setup; iPad and using another Mac as a receiver need more real-hardware testing.
> - Controlling the Mac needs Accessibility permission, and every session starts with input off until you allow it.
> - English only for now.
> - macOS 14+ for the Mac app, iOS/iPadOS 16.4+ for the receiver. English only for now.
>
> **Credit:** MeowDisplay started as a fork of OpenDisplay by Philip Poloczek (https://github.com/peetzweg/opendisplay), which provided the capture/virtual display/encoding foundation. Most of my work since has been on input, gestures, trays, pairing/security, Remote Access and polish. GPL-3.0.
>
> - Website and Mac download: https://meowdisplay.app/
> - App Store (free): https://apps.apple.com/us/app/meowdisplay/id6817552864
> - Setup: https://meowdisplay.app/docs
> - Source: https://github.com/raiseCatError/meowdisplay
>
> Feedback and bug reports are very welcome, especially from iPad and multi-display setups.
Expand All @@ -72,16 +72,16 @@ once, and stay in the thread to answer questions.

## LinkedIn

> MeowDisplay is now on the App Store.
> MeowDisplay is out.
>
> It's a free, open-source app I've been building that turns an iPhone or iPad into a mirrored or extended display for a Mac, and lets you control the Mac from it with touch, trackpad gestures, a keyboard and Apple Pencil, over USB or Wi-Fi.
>
> A few things I cared about along the way: no account, no server in the middle, devices paired with a matching code and every session encrypted. And keeping it open source, building on the excellent OpenDisplay project by Philip Poloczek.
>
> The iPhone and iPad app is available today. The Mac companion is built from source for now, with a signed download on the way.
> The iPhone and iPad app is on the App Store, and the Mac app is a free download.
>
> App Store: https://apps.apple.com/us/app/meowdisplay/id6817552864
> Website and setup: https://meowdisplay.app/ 🐾
> Website and Mac download: https://meowdisplay.app/
> App Store: https://apps.apple.com/us/app/meowdisplay/id6817552864 🐾

---

Expand All @@ -91,16 +91,16 @@ once, and stay in the thread to answer questions.

> Your Mac. Another screen. Anywhere. 🐈
>
> MeowDisplay is now on the App Store: turn your iPhone or iPad into a display for your Mac, and control it with touch, gestures and a keyboard.
> MeowDisplay is out: turn your iPhone or iPad into a display for your Mac, and control it with touch, gestures and a keyboard.
>
> Free and open source. No account.
> iPhone/iPad app on the App Store; the Mac app is built from source for now. Link in bio → meowdisplay.app
> Get the Mac app and the iPhone/iPad app: link in bio → meowdisplay.app
>
> #MeowDisplay #Mac #iPad #iPhone #OpenSource #IndieDev

**Story text (one frame each):**

1. MeowDisplay is on the App Store 🐾
1. MeowDisplay is out 🐾
2. Your iPhone or iPad → a display for your Mac
3. Free · open source · no account
4. Link: meowdisplay.app (sticker → https://apps.apple.com/us/app/meowdisplay/id6817552864)
4. Link: meowdisplay.app (sticker → https://meowdisplay.app/)
Loading