Repository navigation
Releases
WiredDisplay 0.4.2
Downloads
| File | For | Install |
|---|---|---|
WiredDisplay-0.4.2.dmg |
Mac (macOS 14+) | Drag WiredDisplayHost to Applications. It is not notarized, so on first launch go to System Settings › Privacy & Security › Open Anyway. For audio, run Audio Driver/Install Audio Driver.command. |
WiredDisplay-0.4.2.ipa |
iPad (iPadOS 17+) | Unsigned. Sideload it with AltStore or SideStore. |
PANDUAN-INSTALASI.txt |
— | Step-by-step guide (Indonesian). |
Upgrading from 0.4.0: the protocol is unchanged, so either side can be updated first, but update both for all the fixes. The audio driver is unchanged.
New since 0.4.0
This release comes from two full code audits, a 30-minute soak test and on-device measurements.
Sharper picture
- Cleaner coloured edges in Pro and Balanced. The 4:2:0 conversion now runs on the GPU with filtered chroma. VideoToolbox point-sampled it, so a 1-pixel coloured detail on an odd column lost its colour. Flat colours are unchanged, within 1 code. The conversion is also about 1 ms faster: p50 ~4.0 ms instead of ~5.0 ms.
- Balanced sharpens sooner. With the local cursor, moving the mouse no longer holds the screen on the 4:2:0 lane, so text refines to 4:4:4 while you point.
- Metal renderer. 4:4:4 streams stay 4:4:4, 4:2:0 colour is drawn at its real position, and there are three drawables, so no drop to 30 fps.
Lower latency
- The iPad app is now built as Release, so receiving a frame takes about 3.5 ms less.
- Recommended: set the iPad's Display Zoom to Default. The stream is then 1:1 with the panel. Measured: encode 16 → 12 ms, display latency ~40 → ~30 ms.
- Display and input timing:
- The video queue is shorter when the link stalls.
- Taps no longer block the session.
- The cursor is drawn on the iPad at once during drags, not only on hover.
- The brightness keys use one event tap off the main thread, so they no longer slow down typing on the Mac keyboard.
Audio
- The sound returns to the Mac when the iPad stops carrying it: unplugged, app closed, or the host quit. Before, the Mac could be left on a silent "iPad Speaker" or a deaf "iPad Microphone".
- Steadier iPad speaker. Clock-drift correction keeps the delay near 30 ms. Before, it wandered between 19 and 84 ms and dropped out about every 10 minutes.
- The real-time audio threads no longer allocate memory or encrypt.
Reliability
- An iPad plugged in later gets the menu's current input and quality choices. Input you switched off stays off.
- The host log is much quieter and rotates at 5 MB. A cabled iPhone no longer writes 2 lines a second.
- 30-minute soak test, video:
- 0 frames dropped
- 60 fps on the glass
- host memory steady at 42–66 MB
- 30-minute soak test, audio: 1 dropout in 30 minutes.
Known limitations
- Uses private or undocumented macOS APIs (
CGVirtualDisplay, trackpad gesture events). - Two high-resolution iPads exceed the Mac's video encoder, so each one runs at a lower frame rate.
- Not yet tested on a real ProMotion iPad, with two iPads, or next to Sidecar or DisplayLink.
- Tested on one Mac mini with an iPad Air 13″ (M2).
WiredDisplay 0.4.0
Downloads
| File | For | Install |
|---|---|---|
WiredDisplay-0.4.0.dmg |
Mac (macOS 14+) | Drag WiredDisplayHost to Applications. It is not notarized, so on first launch go to System Settings › Privacy & Security › Open Anyway. For audio, run Audio Driver/Install Audio Driver.command. |
WiredDisplay-0.4.0.ipa |
iPad (iPadOS 17+) | Unsigned. Sideload it with AltStore or SideStore. |
PANDUAN-INSTALASI.txt |
— | Step-by-step guide (Indonesian). |
Upgrading: update both the Mac app and the iPad app. 0.4.0 uses protocol 6 and does not connect to 0.3.x. If you are coming from 0.1.0, also reinstall the audio driver.
New since 0.3.3
Lower latency, better picture
- Local cursor. The pointer is drawn on the iPad from a 120 Hz position stream, about 1 ms behind the Mac instead of travelling inside the video. It follows your finger at once on the iPad's trackpad. A switch in the panel's Display tab turns this off.
- Metal renderer (default). The iPad decodes each frame and shows it the moment it is ready, keeping 10-bit streams 10-bit. The system video layer is still available in iPad Controls.
- No periodic keyframes. Every 2 seconds there used to be a large frame and a small hitch. Now a keyframe is sent only when the iPad asks for one.
New features
- Portrait. Rotate the iPad and the Mac display rebuilds as a vertical monitor at native resolution.
- ProMotion. The refresh rate follows the iPad, up to 120 Hz on iPad Pro, or you can fix it at 60 Hz in the panel. The 120 Hz path was verified end to end at about 119 fps.
- Several iPads at once. Each iPad is its own display with its own resolution and input, and settings apply to all of them. Audio goes to the first iPad that turns it on. This has not been tested with two iPads yet.
Works next to Sidecar and DisplayLink
- If another iPad on wired Sidecar or an iPhone is plugged in, WiredDisplay still finds the iPad running the app.
- The brightness keys act on the display under the pointer.
- USB audio from a dock or monitor is not treated as headphones.
Tip: macOS hides notifications while any app captures the screen. To keep them, turn on System Settings › Notifications › Allow notifications when mirroring or sharing the display.
Known limitations
- Uses private or undocumented macOS APIs (
CGVirtualDisplay, trackpad gesture events). - Two high-resolution iPads exceed the Mac's video encoder, so each one runs at a lower frame rate.
- Not yet tested on a real ProMotion iPad, with two iPads, or next to Sidecar or DisplayLink.
- Tested on one Mac mini with an iPad Air 13″ (M2).
WiredDisplay 0.3.3
Downloads
| File | For | Install |
|---|---|---|
WiredDisplay-0.3.3.dmg |
Mac (macOS 14+) | Drag WiredDisplayHost to Applications. It is not notarized, so on first launch go to System Settings › Privacy & Security › Open Anyway. For audio, run Audio Driver/Install Audio Driver.command. |
WiredDisplay-0.3.3.ipa |
iPad (iPadOS 17+) | Unsigned. Sideload it with AltStore or SideStore. |
PANDUAN-INSTALASI.txt |
— | Step-by-step guide (Indonesian). |
Upgrading from 0.3.x: install both apps to get the new icons everywhere. The protocol has not changed, so mixing 0.3.x versions still connects. If you are coming from 0.2.0 or older, update both apps. If you are coming from 0.1.0, also reinstall the audio driver.
New since 0.3.2
One icon everywhere, in the style of Sidecar
- App icon: a white iPad on a blue gradient, with no plug or cable. The Mac app and the iPad home screen now use the same artwork. The Mac app still had the older screen-and-cable icon until now.
- iPad splash screen: the connection wizard shows the app icon itself instead of a generic symbol. So does the header of the Controls panel.
- Menu bar: the icon is an iPad with its home bar. While streaming, the screen is filled.
Known limitations
- Uses private or undocumented macOS APIs (
CGVirtualDisplay, trackpad gesture events). - Three- and four-finger trackpad swipes stay with iPadOS.
- After a Mac reboot, the iPad may need its cable unplugged for about 10 seconds and plugged back in.
- Tested on one Mac mini with an iPad Air 13″ (M2).
WiredDisplay 0.3.2
Downloads
| File | For | Install |
|---|---|---|
WiredDisplay-0.3.2.dmg |
Mac (macOS 14+) | Drag WiredDisplayHost to Applications. It is not notarized, so on first launch go to System Settings › Privacy & Security › Open Anyway. For audio, run Audio Driver/Install Audio Driver.command. |
WiredDisplay-0.3.2.ipa |
iPad (iPadOS 17+) | Unsigned. Sideload it with AltStore or SideStore. |
PANDUAN-INSTALASI.txt |
— | Step-by-step guide (Indonesian). |
Upgrading from 0.3.x: updating the Mac app is enough, because the protocol has not changed. If you are coming from 0.2.0 or older, update both apps. If you are coming from 0.1.0, also reinstall the audio driver.
New since 0.3.1
"Output only" for headphones
- The menu bar panel's Audio tab has a new switch, Use their microphone too. It is on by default.
- When it is off, connecting AirPods or other headphones moves only the sound to them. The microphone stays on iPad Microphone, or on the previous input if the iPad mic is off.
- macOS often moves the input to the AirPods microphone right after they connect. In output-only mode, WiredDisplay moves it back within a moment.
- This keeps AirPods out of the lower-quality Bluetooth headset mode, so music and calls sound full quality while you speak into the iPad.
- Later manual choices are left alone.
Known limitations
- Uses private or undocumented macOS APIs (
CGVirtualDisplay, trackpad gesture events). - Three- and four-finger trackpad swipes stay with iPadOS.
- After a Mac reboot, the iPad may need its cable unplugged for about 10 seconds and plugged back in.
- Tested on one Mac mini with an iPad Air 13″ (M2).
WiredDisplay 0.3.1
Downloads
| File | For | Install |
|---|---|---|
WiredDisplay-0.3.1.dmg |
Mac (macOS 14+) | Drag WiredDisplayHost to Applications. It is not notarized, so on first launch go to System Settings › Privacy & Security › Open Anyway. For audio, run Audio Driver/Install Audio Driver.command. |
WiredDisplay-0.3.1.ipa |
iPad (iPadOS 17+) | Unsigned. Sideload it with AltStore or SideStore. |
PANDUAN-INSTALASI.txt |
— | Step-by-step guide (Indonesian). |
Upgrading from 0.3.0: the Mac app is enough. 0.3.1 uses the same protocol, so a 0.3.0 iPad app still connects. If you are coming from 0.2.0 or older, update both apps. If you are coming from 0.1.0, also reinstall the audio driver.
New since 0.3.0
Automatic headphone switching
- AirPods, other Bluetooth headphones, USB-C earphones and headsets, and the headphone jack become the Mac's output when they connect.
- Their microphone becomes the Mac's input. This includes headsets whose mic macOS lists as a separate device, such as AirPods and USB-C dongles.
- When they disconnect, sound returns to iPad Speaker and the mic to iPad Microphone, if the iPad has those turned on.
- WiredDisplay switches devices only when headphones connect or disconnect, so devices you pick by hand stay as you set them.
- You can turn this off in the menu bar panel, under Audio › Switch to headphones automatically.
- When the AirPods microphone is in use, macOS lowers the AirPods' sound quality (Bluetooth headset mode). This is normal macOS behaviour.
Known limitations
- Uses private or undocumented macOS APIs (
CGVirtualDisplay, trackpad gesture events). - Three- and four-finger trackpad swipes stay with iPadOS.
- After a Mac reboot, the iPad may need its cable unplugged for about 10 seconds and plugged back in.
- Tested on one Mac mini with an iPad Air 13″ (M2).
WiredDisplay 0.3.0
Downloads
| File | For | Install |
|---|---|---|
WiredDisplay-0.3.0.dmg |
Mac (macOS 14+) | Drag WiredDisplayHost to Applications. It is not notarized, so on first launch go to System Settings › Privacy & Security › Open Anyway. For audio, run Audio Driver/Install Audio Driver.command. |
WiredDisplay-0.3.0.ipa |
iPad (iPadOS 17+) | Unsigned. Sideload it with AltStore or SideStore. |
PANDUAN-INSTALASI.txt |
— | Step-by-step guide (Indonesian). |
Upgrading: update both the Mac app and the iPad app. 0.3.0 does not connect to 0.2.0 or older, because the protocol changed. If you are coming from 0.1.0, also reinstall the audio driver.
New since 0.2.0
Real iPad brightness
- The Mac's brightness keys now set the iPad's real backlight. Before, BetterDisplay-style tools could only darken the picture, and the cursor stayed bright. This works with Apple keyboards and with third-party keyboards that send brightness as key codes 144/145 (for example ProtoArc).
- Option-Shift gives fine steps.
- The menu bar panel has a brightness slider.
- Changes made in the iPad's Control Center sync back to the Mac.
- The iPad shows a short indicator when the Mac changes its brightness.
- If you use BetterDisplay, turn off its brightness control for the WiredDisplay screen.
New menu bar panel
- Clicking the menu bar icon opens a tabbed panel with these tabs:
- Display: resolution, codec, the brightness slider, and quality presets as chips with descriptions.
- Input: the input switch and the iPad keyboard shortcuts.
- Audio: speaker and microphone status.
- Security: the connection code and paired iPads.
- General: permissions with Grant buttons, and Open at Login.
Known limitations
- Uses private or undocumented macOS APIs (
CGVirtualDisplay, trackpad gesture events). - Three- and four-finger trackpad swipes stay with iPadOS.
- After a Mac reboot, the iPad may need its cable unplugged for about 10 seconds and plugged back in.
- Brightness can be set only while the WiredDisplay app is open on the iPad.
- Tested on one Mac mini with an iPad Air 13″ (M2).
WiredDisplay 0.2.0
Downloads
| File | For | Install |
|---|---|---|
WiredDisplay-0.2.0.dmg |
Mac (macOS 14+) | Drag WiredDisplayHost to Applications. It is not notarized, so on first launch go to System Settings › Privacy & Security › Open Anyway. For audio, run Audio Driver/Install Audio Driver.command. |
WiredDisplay-0.2.0.ipa |
iPad (iPadOS 17+) | Unsigned. Sideload it with AltStore or SideStore. |
PANDUAN-INSTALASI.txt |
— | Step-by-step guide (Indonesian). |
Upgrading from 0.1.0: install both the new host and the new audio driver, and update the iPad app. Version 0.2.0 does not work with 0.1.0, because the protocol and the audio devices changed.
New since 0.1.0
Calls and audio
- "iPad Speaker" now appears only as a speaker, and "iPad Microphone" only as a microphone. Call apps such as Google Meet and Zoom can no longer pick them the wrong way round, which caused calls with no audio in either direction. The host uses hidden devices of its own.
Magic Keyboard and trackpad
- Your "Allow Input from iPad" choice is remembered across restarts.
- Real pinch-to-zoom and rotate on the Mac, from the touch screen and the trackpad.
⌃ Tab,⌃ ⇧ Tab,⌃ `,⌃ Spaceand⌃ ⇧ 3/4/5reach the Mac as their⌘versions. iPadOS keeps the⌘shortcuts for itself. The iPad app lists these under Controls › Keyboard & trackpad.
Different iPads
- Automatic format fallback. If an iPad can't decode 4:4:4 or 10-bit video, the Mac steps down for that iPad and remembers it.
- Correct sizing on iPad mini. The iPad reports its pixel density, so the display has the right physical size.
- HEVC is used only on iPads that decode it in hardware. Otherwise the stream uses H.264.
- This iPad in Controls shows the model identifier, panel, ppi, refresh rate and HEVC support.
Known limitations
- Uses private or undocumented macOS APIs (
CGVirtualDisplay, trackpad gesture events). - Three- and four-finger trackpad swipes stay with iPadOS.
- After a Mac reboot, the iPad may need its cable unplugged for about 10 seconds and plugged back in.
- Tested on one Mac mini with an iPad Air 13″ (M2).
WiredDisplay 0.1.0
First release: use an iPad as a wired USB‑C display for your Mac.
Downloads
| File | For | Install |
|---|---|---|
WiredDisplay-0.1.0.dmg |
Mac (macOS 14+) | Drag WiredDisplayHost to Applications. It is not notarized, so on first launch go to System Settings › Privacy & Security › Open Anyway. Optional audio driver included. |
WiredDisplay-0.1.0.ipa |
iPad (iPadOS 17+) | Unsigned. Sideload it with AltStore or SideStore, which re-sign it with your Apple ID and renew it every 7 days. |
PANDUAN-INSTALASI.txt |
— | Step-by-step guide (Indonesian). |
What's in it
- Virtual display at the iPad's native resolution with HiDPI "looks like" sizes. It can be the main display of a headless Mac.
- HEVC streaming over the cable only, with Balanced / Pro / Ultra / High Color quality presets.
- Mac audio on the iPad speakers and the iPad microphone on the Mac (optional).
- Sidecar-style touch: tap, scroll, hold-and-drag, two-finger right click, pinch, rotate, three-finger edit gestures.
- Magic Keyboard and trackpad: typing, two-finger scrolling with momentum, real pinch-to-zoom and rotate.
⌃ Tab,⌃ Spaceand⌃ ⇧ 3/4/5reach the Mac as⌘ Tab,⌘ Spaceand⌘ ⇧ 3/4/5.- Encrypted, paired sessions. Input from the iPad stays off until you allow it.
Known limitations
- Uses private or undocumented macOS APIs (
CGVirtualDisplay, trackpad gesture events). A future macOS may break them. - Three- and four-finger trackpad swipes stay with iPadOS.
- After a Mac reboot, the iPad may need its cable unplugged for about 10 seconds and plugged back in.
Tested on one Mac mini with an iPad Air 13″ (M2).