diff --git a/README.md b/README.md index 9a00e6efe..d199df52c 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,8 @@ right from it. [Support](https://meowdisplay.app/support.html) ยท [Privacy](https://meowdisplay.app/privacy.html) +Download on the App Store +
The MeowDisplay Mac app open to Overview, beside the MeowDisplay receiver on iPhone @@ -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. -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). +**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 @@ -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**. @@ -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). diff --git a/SETUP.md b/SETUP.md index 97a374f42..5113fd398 100644 --- a/SETUP.md +++ b/SETUP.md @@ -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 diff --git a/assets/readme/app-store-badge.svg b/assets/readme/app-store-badge.svg new file mode 100644 index 000000000..072b425a1 --- /dev/null +++ b/assets/readme/app-store-badge.svg @@ -0,0 +1,46 @@ + + Download_on_the_App_Store_Badge_US-UK_RGB_blk_4SVG_092917 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/launch/APP_STORE_LAUNCH.md b/launch/APP_STORE_LAUNCH.md new file mode 100644 index 000000000..b603137e9 --- /dev/null +++ b/launch/APP_STORE_LAUNCH.md @@ -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: + + +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: +. 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: +- Website: +- Setup: +- Features: +- Support: +- Source: diff --git a/launch/SOCIAL_POSTS.md b/launch/SOCIAL_POSTS.md new file mode 100644 index 000000000..352d46ff2 --- /dev/null +++ b/launch/SOCIAL_POSTS.md @@ -0,0 +1,106 @@ +# 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. + +Verified links: + +- 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 + +--- + +## X / Twitter + +> MeowDisplay is on the App Store ๐Ÿˆ +> +> 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. +> +> https://apps.apple.com/us/app/meowdisplay/id6817552864 + +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 +> +> Built on the great OpenDisplay project. Code: https://github.com/raiseCatError/meowdisplay + +--- + +## Reddit + +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 + +**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. +> +> **What it does** +> +> - Mirror one of your Mac's displays, or Extend with a virtual display you can drag windows onto (works in clamshell mode without a dummy HDMI plug) +> - Direct Touch or a trackpad-style pointer, multi-finger gestures (Spaces, Mission Control, Spotlight), keyboard, modifier/shortcut trays +> - Apple Pencil on supported iPads, Mac system audio on the receiver, Picture in Picture +> - USB, local Wi-Fi, or Remote Access over a private network you set up yourself (e.g. Tailscale) +> - Devices pair with a matching code; sessions use mutually authenticated TLS 1.3. No account, no MeowDisplay server, no analytics +> +> **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. +> +> **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. +> +> - 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. + +--- + +## LinkedIn + +> MeowDisplay is now on the App Store. +> +> 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. +> +> App Store: https://apps.apple.com/us/app/meowdisplay/id6817552864 +> Website and setup: https://meowdisplay.app/ ๐Ÿพ + +--- + +## Instagram + +**Caption:** + +> 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. +> +> 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 +> +> #MeowDisplay #Mac #iPad #iPhone #OpenSource #IndieDev + +**Story text (one frame each):** + +1. MeowDisplay is on the App Store ๐Ÿพ +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)