Unlocks Sidecar for older, unsupported iPads and Macs (supports all iPads running iPadOS and Macs running macOS Catalina or newer).
Full list of supported iPads (running iPadOS): iPad Air 2, iPad Air (3rd generation), iPad (5th generation), iPad (6th generation), iPad (7th generation), iPad Mini 4, iPad Mini (5th generation), iPad Pro 9.7-inch, iPad Pro 10.5-inch, iPad Pro 11-inch, iPad Pro 12.9-inch (1st generation), iPad Pro 12.9-inch (2nd generation), iPad Pro 12.9-inch (3rd generation)
List of supported Macs (running macOS Catalina or newer): iMac: Late 2012 or newer, iMac Pro, Mac Pro: Late 2013 or newer, Mac Mini: Late 2012 or newer, MacBook: Early 2015 or newer, MacBook Air: Mid 2012 or newer, MacBook Pro: Mid 2012 or newer
- Apple uses a simple "blacklist" on macOS to disable iPadOS 13/macOS Catalina devices from using Sidecar. To work around this, we simply need to edit the blacklist in
/System/Library/PrivateFrameworks/SidecarCore.framework/Versions/A/SidecarCore
(can be done with any hex editor of your choice). - This app is a UI for editing
SidecarCore
. - This app is sandboxed and does NOT need root access. I've left everything that needs root access for you to execute in the Terminal.
- This app works on all versions of iPadOS and macOS Catalina, including upcoming releases (assuming Apple doesn't change how they blacklist devices—in which case this app will be a no-op).
- The entire process includes 2 restarts into the recovery partition and should take around 5-15 minutes.
- Wireless mode may not work for all older devices.
- Make a backup of SidecarCore (run this in Terminal):
cp /System/Library/PrivateFrameworks/SidecarCore.framework/Versions/A/SidecarCore ~/Downloads/SidecarCore.bak
- Copy SidecarCore from the System folder (run this in Terminal)
cp /System/Library/PrivateFrameworks/SidecarCore.framework/Versions/A/SidecarCore ~/Downloads
- Open Free Sidecar (note that macOS may prevent you from running the app. In that case, open
System Preferences - Security & Privacy - General
and selectOpen Anyway
) and choose the location of the SidecarCore file to be patched (~/Downloads/SidecarCore from step 2).
-
Click
Enable
to enable sidecar for the corresponding device. This will modify theSidecarCore
that you've selected in step 3 (you will be replacing the systemSidecarCore
with this file in step 7):- Run
sysctl hw.model
in Terminal to find out your mac model. For iPad model, go here.
- Run
-
Disable System Integrity Protection. This will allow us to mount
/
as read-write and modifySidecarCore
under the/System
directory.- Reboot into recovery mode (Press cmd-R when booting)
- Execute in Terminal in recovery mode:
csrutil disable
- Reboot into macOS
-
Mount system volume as read-write (in Terminal):
sudo mount -uw /
- Copy the patched SidecarCore back into SidecarCore.framework (in Terminal):
sudo cp ~/Downloads/SidecarCore /System/Library/PrivateFrameworks/SidecarCore.framework/Versions/A/SidecarCore
- Sign the patched SidecarCore (in Terminal):
sudo codesign -f -s - /System/Library/PrivateFrameworks/SidecarCore.framework/Versions/A/SidecarCore
- Reboot Into Recovery, re-enable System Integrity Protection:
csrutil enable
- Reboot Into macOS, the patched devices should now work in wired mode.
-
"The iPad picture quality is sub-optimal!"
Try using wired connection. For older Macs without hardware HEVC encoder/decoders, it may need extra bandwidth to transmit the screen.
-
"Error 32002"
This happens on wireless connection for some models. Try using a wire instead. (Some people have reported that wired isn't working either on some older models e.g. MacbookPro 2012)
-
"None of my apps open anymore, They keep crashing!"
You probably forgot to do step 8. If you can use the Terminal, do steps 5,6 and 8 again. If you can't use the Terminal (it keeps crashing), boot into single user mode and do steps 6 and 8 after doing step 5 in Recovery Mode.
-
"In the code-signing step, I'm getting
the codesign_allocate helper tool cannot be found or used
."Make sure you have the latest Xcode comandline tools! See issues #2 and #3.
-
General questions to consider before opening an issue:
- Did you try wired mode?
- Does your device show up in Finder's sidebar?
- Did you click "trust" in Finder under the device tab?
- Did you try unlocking your iPad before connecting?
- Did you try restarting both devices and connecting again?
- Try these
-
"My question isn't listed"
Search in issues or open a new one! Note that I can only fix things that are specific to Free Sidecar (enable/disable sidecar for certain devices). Most usability issues with Sidecar can only be addressed by Apple.
-
"I want to revert to the original
SidecarCore
"Hope you still have the backup file from step 1! (
~/Downloads/SidecarCore.bak
). Disable System Integrity Protection (step 5), mount the system volume as read-write (step 6) and run the following commands in Terminal:sudo cp ~/Downloads/SidecarCore.bak /System/Library/PrivateFrameworks/SidecarCore.framework/Versions/A/SidecarCore sudo codesign -f -s - /System/Library/PrivateFrameworks/SidecarCore.framework/Versions/A/SidecarCore
Then re-enable System Integrity Protection (step 9). Your system should be in the same state as before you applied the patch!
Submit PRs and open issues!
SidecarPatcher - This replaces a hex string that only exists in beta versions (and apparently some official releases?) (thus does not work for me in the final release). Free Sidecar uses partial device model string matching (details here) and should work for future versions of macOS as well.