Giter VIP home page Giter VIP logo

sidecarpatcher's Introduction

SidecarPatcher

Enables Sidecar on old Mac and iPad for macOS 10.15

Sidecar is disabled on these devices by Apple: iMac13,1, iMac13,2, iMac13,3, iMac14,1, iMac14,2, iMac14,3, iMac14,4, iMac15,1, iMac16,1, iMac16,2, MacBook8,1, MacBookAir5,1, MacBookAir5,2, MacBookAir6,1, MacBookAir6,2, MacBookAir7,1, MacBookAir7,2, MacBookPro9,1, MacBookPro9,2, MacBookPro10,1, MacBookPro10,2, MacBookPro11,1, MacBookPro11,2, MacBookPro11,3, MacBookPro11,4, MacBookPro11,5, MacBookPro12,1, Macmini6,1, Macmini6,2, Macmini7,1, MacPro5,1, MacPro6,1

and iPad: iPad4,1, iPad4,2, iPad4,3, iPad4,4, iPad4,5, iPad4,6, iPad4,7, iPad4,8, iPad4,9, iPad5,1, iPad5,2, iPad5,3, iPad5,4, iPad6,11, iPad6,12

You can type this in Terminal to get the model identifier of your Mac: sysctl hw.model.

You can get the model identifier of your iPad by using this app: Mactracker (iOS App Store)

This script disables this blacklist in macOS. This does NOT patch the iPadOS root system, jailbreaking is not required.

This is a command line script. If you want GUI application, try free-sidecar by ben-z.

Tested on macOS 10.15~10.15.2 beta.

How to patch

It is very unstable. There are many known issues. Read Issues. Please use this at your own risk.

  1. Backup /System/Library/PrivateFrameworks/SidecarCore.framework/Versions/A/SidecarCore file. This script doesn't provide original system file.

  2. Install the latest version of Command Line Tools from Apple Developer website.

  • Requires Apple Developer Account, you can use a free-tier developer account.
  1. Disable System Integrity Protection. How to turn off System Integrity Protection on your Mac. After disabling System Integrity Protection, reboot into normal macOS.
  • To check SIP is disabled: csrutil status
  1. Open Terminal application and clone this repository by running this command: git clone https://github.com/pookjw/SidecarPatcher

  2. Give excute permission: chmod +x SidecarPatcher/main.swift

  3. Run main.swift: sudo swift SidecarPatcher/main.swift

  • You will need to enter your macOS password.

  • Ignore warnings. If you encounter error and you don't know how to fix, upload a log to Issue. (I can't reply all issues because I don't know all.)

  • This script will not patch again if you already patched your system until you revert to the original SidecarCore.

  • About xcrun error and crashing many apps after rebooting: #4

How to revert

Simplest Method

Reinstall your macOS using Catalina Installer. Install it without erasing your disk it won't erase your data and it will just reinstall the system.

Using your backup

  1. Disable System Integrity Protection. How to turn off System Integrity Protection on your Mac.

To check SIP is disabled: csrutil status

  1. Run sudo mount -uw / command.

  2. Copy the original SidecarCore: sudo cp /path/to/original/SidecarCore /System/Library/PrivateFrameworks/SidecarCore.framework/Versions/A/SidecarCore

  • Make sure you put the right path for SidecarCore /path/to/original/SidecarCore.
  1. Sign SidecarCore: sudo codesign -f -s - /System/Library/PrivateFrameworks/SidecarCore.framework/Versions/A/SidecarCore

  2. Set permission as 755: sudo chmod 755 /System/Library/PrivateFrameworks/SidecarCore.framework/Versions/A/SidecarCore

  3. Reboot. If you want to enable System Integrity Protection again, you can do so now.

sidecarpatcher's People

Contributors

pookjw avatar

Stargazers

 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.