Giter VIP home page Giter VIP logo

playcover's Introduction

Contributors Forks Stargazers Issues GPLv3 License


Logo

PlayCover

Run iOS apps and games on Apple Silicon Macs with mouse, keyboard and controller support.

Showcase · Contribute · Discord

Disclaimer

  • 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.

⬆️ Back to top️

About The Project

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.

Fancy logo Fancy logo

⬆️ Back to top️

Getting Started

Follow the instructions below to get Genshin Impact, and many other games, up and running in no time.

Prerequisites

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.

Download

You can download stable releases here, or build from source by following the instructions below.

Homebrew Cask

We host a Homebrew tap with the PlayCover cask. To install from it:

  1. Tap PlayCover/playcover with brew tap PlayCover/playcover;
  2. Install PlayCover with brew install --cask playcover-community.

To uninstall:

  1. Remove PlayCover using brew uninstall --cask playcover-community;
  2. Untap PlayCover/playcover with brew untap PlayCover/playcover.

Build from Source

You will need:

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.

Extra Installation Steps For Genshin Impact

  1. 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 choose Terminal
    • In the terminal window type csrutil disable and type your password when prompted
    • Once Successfully disabled System Integrity Protection appears, restart your Mac
  2. Modify nvram boot-args

    • When you have SIP disabled, type the following:
      • Command + Space, type Terminal 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
  3. 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.
  4. Enable SIP

    • Follow the steps in Step 1 to re-enter startup options
    • When Utilities appears in the menu bar, click on it and choose Terminal
    • In the terminal window type csrutil enable and type your passowrd when prompted
    • Once Successfully enabled System Integrity Protection appears, restart your Mac
  5. Open Genshin

    • You're done! Enjoy playing Genshin!

Video Instructions

The above steps are shown in the following video:

How to play Genshin Impact using Playcover on your M1 Mac (2020 or newer)!

⬆️ Back to top️

Keymapping

Button Events

  • 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 '🔁'

Flow Control

  • Increase the selected buttons size
    • Menu Bar > Keymapping > Upsize Selected Element OR Cmd + '↑'
  • Decrease the selected buttons size
    • Menu Bar > Keymapping > Upsize Selected Element OR Cmd + '↓'
  • Delete the selected keymapping
    • CMD + delete (backspace)
  • Toggle between show/hide cursor
    • Press option (⌥)

Importing Keybinds

  1. Download the .playmap file from #📝・keymap-showcase

  2. Open PlayCover and right click the app you wish to import the keybinds to

  3. Click on Import Keymapping

  4. Select the previously downloaded .playmap file

  5. Quit and reopen the app

    • This step is required for the newly imported keymapping to work

For additional help, please join the Discord server

⬆️ Back to top️

Contributing

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!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

⬆️ Back to top️

License

Distributed under the GPLv3 License. See LICENSE for more information.

⬆️ Back to top️

Contact

Lucas Lee - [email protected]

Project Link: https://github.com/PlayCover/PlayCover

⬆️ Back to top️

Libraries Used

These open source libraries were used to create this project.

⬆️ Back to top️

playcover's People

Contributors

lixin9311 avatar candygoblen123 avatar depal1 avatar josemoreville avatar ivoider avatar wind-explorer avatar isaacmarovitz avatar ohaiibuzzle avatar zanderp25 avatar zhichgaming avatar wenqingl avatar cryptoalgorithm avatar animenosekai avatar dippyskoodlez avatar hayatofujii avatar hongyus avatar dpulavarthy avatar tlc-10 avatar williamli0707 avatar r8bhavneet 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.