Difference between revisions of "PlayCover"

Latest revision as of 17:38, 28 September 2023

PlayCover allows M1 Macs to sideload iPhone and iPad apps even after macOS 11.2.3, please see the main Sideloading article for other methods of sideloading.

Features

Apps can be played in fullscreened, with keyboard and mouse (using Touch Assist and mapping), and controller
Compatible with macOS Big Sur and Monterey

Nightly builds

Nightly builds are now available, for free, from PlayCover's Github Actions

Install Instructions

Download the DMG file from PlayCover
Open the DMG file, and then drag and drop PlayCover.app into the applications folder.
Open PlayCover.app
Select the "Install" button under the "You need to install the Xcode command line tools" prompt (if the prompt doesn't appear, run xcode-select --install in a terminal
In the popup that appears, select Install (The time remaining is lying, it'll take around 10 minutes depending on your internet connection)
Drag and drop your decrypted IPA file into the PlayCover window.

Login Fixes

In the latest version, to fix login in some apps (like Genshin Impact) you must check PlayChain in the PlayCover settings.

Otherwise, mainly in older versions, an alternate fix is disabling the System Integrity Protection of your mac, however, it is NOT RECOMMENDED due to the security risks it entails, specially in older PlayCover versions:

Disable SIP (boot into recovery mode by holding power button when boot, login your account, open terminal, type csrutil disable, agree) (Note: doing this lowers system security, e.g. you may not be able to use google chrome or electron based apps, such as discord)
Restart
Open Terminal, type sudo nvram boot-args="amfi_get_out_of_my_way=0x1 ipc_control_port_options=0" (Note: this command lowers system security, e.g. you may not be able to use google chrome or electron based apps, such as discord)
Restart
Now captcha/login will work
after successful login, run the following command in terminal to reset your boot-args: sudo nvram boot-args=""
After successful login, you should enable SIP again: run csrutil enable from recovery mode. (Note: some apps, such as Netflix, will stop working after you enable SIP, so you may have to keep SIP disabled to use specific apps, although this is not recommended)

Note: If you have problems with csrutil command (failed). Go to System preferences, Privacy & Secuirity, disable FileVault, enable it and choose allow unlock disk from iCloud option. If you have multiple macOS installations, you should set the startup disk to the macOS install that you're changing SIP for.

Remapping keys

⌘+K Open/close keymapping editor
⌘+delete Remove element
⌘++ or - Setting size

To add a Keymap, simply click anywhere in the window, and select a type from the radial menu that appears.

@@ Line 2: / Line 2: @@
 ==Features==
-*Apps can be fullscreened and also played with keyboard and mouse (using Touch Assist and mapping)
+*Apps can be played in fullscreened, with keyboard and mouse (using Touch Assist and mapping), and controller
-*macOS Big Sur and Monterey are compatible, with Intel support planned in the future
+*Compatible with macOS Big Sur and Monterey
-*Can also decrypt signed IPA files that have been extracted via iMazing or Apple Configurator
-==Insider Nightly builds==
+==Nightly builds==
-*Please refer to [https://discord.gg/4XuBEUnjeE PlayCover's Discord] for updates, to get the most compatible nightly build you will find instructions on how to donate to developer iVoider and gain access to the latest build
+*Nightly builds are now available, for free, from PlayCover's [https://github.com/PlayCover/PlayCover/actions/workflows/2.nightly_release.yml Github Actions]
-==Instructions==
+==Install Instructions==
-#Download [https://github.com/Letscoder/PlayCover PlayCover] and extract
+#Download the DMG file from [https://github.com/PlayCover/PlayCover/releases/latest PlayCover]
-#Agree to the license
+#Open the DMG file, and then drag and drop PlayCover.app into the applications folder.
-#Drag IPA file to PlayCover window
+#Open PlayCover.app
-#Navigate to \Documents\PlayCover\ to find the decrypted/installed game
+#Select the "Install" button under the "You need to install the Xcode command line tools" prompt (if the prompt doesn't appear, run <code>xcode-select --install</code> in a terminal
+#In the popup that appears, select Install (The time remaining is lying, it'll take around 10 minutes depending on your internet connection)
+#Drag and drop your decrypted IPA file into the PlayCover window.
-==For Genshin==
+==Login Fixes==
-#Download PlayCover and extract
+In the ''latest version'', to fix login in some apps (like Genshin Impact) you must check '''PlayChain''' in the PlayCover settings.
-#Agree to the license
-#Goto discord channel https://discord.gg/4XuBEUnjeE to find decrypted ipa
-#check both `keymapping` and `fix login`
-#Drag IPA file to PlayCover window
-#Navigate to \Documents\PlayCover\ to find the decrypted/installed game
-#follow Fixes section
-==Genshin Fixes==
+Otherwise, mainly in older versions, an alternate fix is disabling the '''System Integrity Protection''' of your mac, however, it is NOT RECOMMENDED due to the security risks it entails, specially in older PlayCover versions:
-In order to get [[Genshin Impact]] to successfully login after sideloading, this fix is required:
+#Disable SIP (boot into recovery mode by holding power button when boot, login your account, open terminal, type <code>csrutil disable</code>, agree) (Note: doing this lowers system security, e.g. you may not be able to use google chrome or electron based apps, such as discord)
-#Install the Genshin Impact app via [[#Instructions]]
-#Disable SIP (boot into recovery by holding power button when boot, login your account, open terminal, type <code>csrutil disable</code>, agree)
 #Restart
-#Open Terminal, type <code>sudo nvram boot-args="-v cs_enforcement_disable=1 amfi_get_out_of_my_way=1 keepsyms=1 intcoproc_unrestricted=1 amfi_unrestrict_task_for_pid=1 amfi_allow_any_signature=1 cs_debug=1"</code> (Note: this command disables some security settings, e.g. does not allow changing camera preferences)
+#Open Terminal, type <code>sudo nvram boot-args="amfi_get_out_of_my_way=0x1 ipc_control_port_options=0"</code> (Note: this command lowers system security, e.g. you may not be able to use google chrome or electron based apps, such as discord)
 #Restart
 #Now captcha/login will work
-#After successful login, SIP can be enabled again: <code>csrutil enable</code>. But the app need to be reinstalled with `fix login` unchecked (reinstall won't delete login data)
+#after successful login, run the following command in terminal to reset your boot-args: <code>sudo nvram boot-args=""</code>
+#After successful login, you should enable SIP again: run <code>csrutil enable</code> from recovery mode. (Note: some apps, such as Netflix, will stop working after you enable SIP, so you may have to keep SIP disabled to use specific apps, although this is not recommended)
-Note: If you have problems with csrutil command (failed). Go to System preferences, Privacy & Secuirity, disable FileVault, enable it and choose allow unlock disk from iCloud option
+Note: If you have problems with csrutil command (failed). Go to System preferences, Privacy & Secuirity, disable FileVault, enable it and choose allow unlock disk from iCloud option. If you have multiple macOS installations, you should set the startup disk to the macOS install that you're changing SIP for.
-Note: if you wish to disable the sudo command, open Terminal and enter <code>sudo nvram boot-args=""</code> to clear this command.
 ==Remapping keys==
-*{{Key|Ctrl|P}} Open/close keymapping editor
+*{{Key|⌘|K}} Open/close keymapping editor
-*{{Key|Ctrl|N}} Add new key
+*{{Key|⌘|delete}} Remove element
-*{{Key|Ctrl|J}} Add new joystick, (for wasd)
+*{{Key|⌘|+ or -}} Setting size
-*{{Key|Ctrl|M}} Add mouse
-To delete a key, toggle keymapping editor ({{Key|Ctrl|P}}) and then click on a zone, and then press {{Key|Ctrl|Backspace}}
+To add a Keymap, simply click anywhere in the window, and select a type from the radial menu that appears.