playcover/playbook

User documentation for PlayCover.

‎

PlayCover

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

Documentation · Discord · Website

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.

Localisations handled in Weblate.

⬆️ 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
• M2 Pro
• M2 Max
• M2 Ultra
• M3
• M3 Pro
• M3 Max

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 in the Documentation.

Documentation

To learn how to setup and use PlayCover, visit the documentation here.

Homebrew Cask

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

brew install --cask PlayCover/playcover/playcover-community

To uninstall:

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

⬆️ Back to top️

License

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

Contact

Lucas Lee - [email protected]

Depal - [email protected]

Libraries Used

These open source libraries were used to create this project.

• inject

• PTFakeTouch

• DownloadManager

• DataCache

• SwiftUI CachedAsyncImage

• Thanks to @iVoider for creating such a great project!

⬆️ Back to top️

playbook's Issues

Complete 2.0.0-2.0.3 documentation

This is a list of things that have been identified so far as missing in PlayBook.

page updates:

• download_playcover.md
  • Additional Homebrew cask information (nightlies and prerelease)
• miscellaneous.md
  • Update the screenshot for misc settings PlayCover/PlayCover#663
  • Talk about PlayTools removal and injection, possible consequences, etc
• alt_xcode_cli_install.md
  • Xcode CLT troubleshooting (to be adapted from the server’s faq)
• using_making_keymaps.md
  • Controller keymap support
  • Mention what keys can be mapped or not (option key, F keys, numeric keyboard extra keys, middle button, scroll)

new pages to add:

• account (store,switch,delete)
• clear app data, clear app preferences, uninstall app (and what the uninstall popup checkboxes do)
• PlayCover settings menu (info on app deletion settings [list deleted directories], including prune)
• IPA LIBRARY info (what it looks like, what it does, how to use it)
• IPA Library: how to make a source
• probably a page on explaining what to do when a game (like genshin) updates (and troubleshooting the problems that may occur, other potential issues)
• PlayCover utilities and related projects (IPA Source Tool, PCTT, PlayCover CLI, PlayCover Raycast extension)
• Info on blocked games and malicious apps (explanation and list)

other pending changes:

• Document Sideloadly export
• How to configure entitlements and Jailbreak bypass (to be adapted from @ohaiibuzzle‘s notes) #61
• Mention photos saved through apps are stored in your Photos Library.
• Document screen rotation and the fact that it is only officially intended to fix rotation issues during the execution of the app, and that the rotation status is not saved.
• Mention the case of some apps running with SIP enabled in 'fresh' Xcode builds, due to access to otherwise inaccesible frameworks such as OpenGL ES.
• Mention PlayCover has to be in the Applications folder in order to work correctly.
• Mention that in-app purchases won’t work at all.
• More detailed documentation on configuring Custom Discord Activity
• Mention explicitly the possibility to have multiple accounts in the account manager
• Research behaviour of legitimately signed apps inside PlayCover's container. (@Depal1 )

Commands not visible

https://docs.playcover.io/

cant open jp プリコネR

https://decrypt.day/app/id1134429300

when i open it , it quit by self