![Logo](images/logo.png)
Run iOS apps and games on Apple Silicon Macs with mouse, keyboard and controller support.
Showcase
·
Contribute
·
Discord
- This fork has been created by the community to support the development of PlayCover, since the original project became non-free and non-open-source.
- This fork is not affiliated with the original project, nor the original author.
- This fork is not affiliated with the website https://playcover.me.
- If you have any questions, please ask the community for help first.
- The original project is under GNU General Public License v3.0, so there is no legal issue to fork it and redistribute.
If anyone feels like this fork somehow violates the copyright (e.g., the logo), please open an issue.
Many things are under construction, so please be patient. Any contribution is welcome.
This fork will always stay open-source and maintained by the community.
Welcome to PlayCover! This software is all about allowing you to run iOS apps and games on Apple Silicon devices running macOS 12.0 or newer.
PlayCover works by putting applications through a wrapper which imitates an iPad. This allows the apps to run natively and perform very well.
PlayCover also allows you to map custom touch controls to keyboard, which is not possible in alternative sideloading methods such as Sideloadly.
These controls include all the essentials, from WASD, camera movement, left and right clicks, and individual keymapping, similar to a popular Android emulator’s keymapping system called Bluestacks.
This software was originally designed to run Genshin Impact on your Apple Silicon device, but it can now run a wide range of applications. Unfortunately, not all games are supported, and some may have bugs.
Follow the instructions below to get Genshin Impact, and many other games, up and running in no time.
At the moment, PlayCover can only run on Apple Silicon Macs. Devices with the following chips are supported:
- M1
- M1 Pro
- M1 Max
- M1 Ultra
- M2
If you have an Intel Mac, you can explore alternatives like Bootcamp or emulators.
You can download stable releases here, or build from source by following the instructions below.
We host a Homebrew tap with the PlayCover cask. To install from it:
- Tap
PlayCover/playcover
withbrew tap PlayCover/playcover
; - Install PlayCover with
brew install --cask playcover-community
.
To uninstall:
- Remove PlayCover using
brew uninstall --cask playcover-community
; - Untap
PlayCover/playcover
withbrew untap PlayCover/playcover
.
You will need:
- Carthage
- Xcode
- An Apple ID
Clone this repo, and open it in Xcode. You have to codesign it with your Apple ID in Xcode. You can do this by going to Navigator > PlayCover > Signing & Capabilities
and setting the Provising Profile
to None, and setting the Team
to your personal Apple ID team.
-
Disable SIP
- First shut down your Mac completely so the screen is black and all other lights are off
- Press and hold the power button on your Mac until
Loading startup options
appears - Select
Options
and continue - If prompted, select the correct storage disk
- Log in with your administrator account
- When
Utilities
appears in the menu bar, click on it and chooseTerminal
- In the terminal window type
csrutil disable
and type your password when prompted - Once
Successfully disabled System Integrity Protection
appears, restart your Mac
-
Modify
nvram boot-args
- When you have SIP disabled, type the following:
Command + Space
, typeTerminal
in the search box
- Type or copy the following command in the terminal window that appears
sudo nvram boot-args="amfi_get_out_of_my_way=1"
- If it appears that nothing has happened, this is correct.
- Restart your Mac
- When you have SIP disabled, type the following:
-
Login to Genshin
- Open Genshin Impact with PlayCover, and you should be greeted with a Login button
- Login to your account, then wait until the door appears and quit the game with
Command + Q
. DO NOT CLICK/ENTER THE DOOR.
-
Enable SIP
- Follow the steps in Step 1 to re-enter startup options
- When
Utilities
appears in the menu bar, click on it and chooseTerminal
- In the terminal window type
csrutil enable
and type your passowrd when prompted - Once
Successfully enabled System Integrity Protection
appears, restart your Mac
-
Open Genshin
- You're done! Enjoy playing Genshin!
The above steps are shown in the following video:
How to play Genshin Impact using Playcover on your M1 Mac (2020 or newer)!
- Opens a menu to add a button element
- Clicking on the screen
- Edit keymapping binding
- Click on a keymap and press the key you want binded
- Bind left mouse button
- Clicking on 'LB'
- Bind right mouse button
- Clicking on 'RB'
- Bind middle mouse button
- Clicking on '🖱️'
- Adds a W/A/S/D joystick
- Clicking on the '➕'
- Adds a mouse area for mouse control
- Clicking on the '🔁'
- Increase the selected buttons size
- Menu Bar >
Keymapping
> Upsize Selected Element ORCmd + '↑'
- Menu Bar >
- Decrease the selected buttons size
- Menu Bar >
Keymapping
> Upsize Selected Element ORCmd + '↓'
- Menu Bar >
- Delete the selected keymapping
- CMD + delete (backspace)
- Toggle between show/hide cursor
- Press option (⌥)
-
Download the
.playmap
file from #📝・keymap-showcase -
Open PlayCover and right click the app you wish to import the keybinds to
-
Click on
Import Keymapping
-
Select the previously downloaded
.playmap
file -
Quit and reopen the app
- This step is required for the newly imported keymapping to work
For additional help, please join the Discord server
If you have a suggestion that would make this better, please fork the repo and create a pull request. Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Distributed under the GPLv3 License. See LICENSE
for more information.
Lucas Lee - [email protected]
Project Link: https://github.com/PlayCover/PlayCover
These open source libraries were used to create this project.
-
Thanks to @iVoider for creating such a great project!