Repository navigation
App Settings
The settings of AVP Play on the Mac. The settings of a single game are on the Vision Pro – see On the Vision Pro.
| Setting | What it does | Default |
|---|---|---|
| Language | English, German or same as macOS | Same as macOS |
| Updates | Ask GitHub once a day whether there is a new version of AVP Play. Check Now checks right away. A new version is only installed if it is signed by the same developer and notarised by Apple. | on |
| Controllers | Surreal Touch support – on, newly installed or rebuilt games can be switched to Surreal Touch controllers in their start window (your Mac downloads Surreal's software once, about 50 MB); off, they are made for standard controllers only and offer no controller type. Below it, while it is on: which controllers newly installed games expect first, Standard Controllers or Surreal Touch. You can change that in each game at any time. | on, Standard Controllers |
| Game language | Language games start with. What a newly installed or rebuilt game is told the Vision Pro is set to: As each game has it, your device's language, English or one of 21 others. Games that offer the language use it for text and, if their voice pack is installed, for voices. Each game can pick another one in its own settings, and that choice stays, also when the game is updated. | As each game has it |
| Play area | Measure room in the games that are installed. When on, newly installed games check your room before they start. See Play area. | on |
| Offline | Install without Meta and Steam. When this is on, AVP Play asks Meta and Steam nothing and downloads nothing from them. Their last answer counts, and games are built from what is on this Mac. New versions and new purchases wait until it is off again. A game must have been confirmed once on this Mac with your account. Apple's signing works without internet only as long as the profile on the Mac is valid. | off |
| Renew signatures | Check in the background and sign games again before they run out (important with a free Apple account: 7 days). Check every sets how often. Below, you see for each game how long it still runs; "paid team" or "free team" shows when a game was signed with another kind of team than the one chosen now. | off |
| Menu Bar | Show AVP Play in the menu bar: the icon at the top right (see below). Keep running in the menu bar when the window is closed: then closing the window no longer quits AVP Play. Open at login: AVP Play starts when you sign in to your Mac. | icon on, keep running off, login off |
| Online catalogue | Show more games from the catalogue and allow feedback ("It works"). The catalogue only gets search terms and the IDs of games you open – never your sign-in. | on |
| Usage counting | Tell the project anonymously how many people use AVP Play and which games they install. No identifier of you or your device. | on |
| Share the fingerprints of untested games with the project | When an untested game's page shows its prognosis, a list goes to the project once per version: the game's store number and version and the names of what it uses, such as its engine and graphics. Never any content of the game and nothing about you or your devices. It shows the project what most games are still missing. | off |
| Saved Games | Fetch saved games from the Vision Pro to this Mac by itself. Fetch Now backs up right away. | on |
| Pictures | Load game pictures from the Meta Store and Steam (without signing in). Otherwise the app shows coloured tiles. | on |
| Downloads | Folder for downloaded games, as under Data. | – |
| Toolchains | Remove toolchain data that is no longer needed automatically. Saves many gigabytes. | on |
| Experimental: MetalFX | Newly installed games start with MetalFX upscaling and a lower resolution (75 % by default). This can make games smoother. | off |
| Advanced: App identifier prefix | Only change it if the help tells you to. Afterwards the Vision Pro sees every game as a new app. | empty |
| Software used | Unfolds to show what the built games contain (Klepton, ANGLE, MoltenVK and more) and Beat Saber's mods, each with authors, licence and a link to the original project. | folded |
At the top right of the menu bar, a headset icon shows what AVP Play is doing. While a game is downloaded or copied to the Vision Pro, the progress stands next to it (for example "42 %"). A warning triangle means a job stopped with an error.
Click the icon to open a small window:
- the running job and how many are waiting,
- whether the Vision Pro is reachable,
- whether AVP Play Remote is connected,
- with a free Apple account: when the next game runs out,
- the buttons Open AVP Play, Check Again and Quit.
If you switch on Keep running in the menu bar when the window is closed in Settings, you can simply close the window: running jobs go on, AVP Play Remote stays connected, and the Dock icon goes away. Open AVP Play brings the window back, just as you left it; so does a click on AVP Play's icon in the Dock or Finder (since 1.5.8).
With this switch on, ⌘Q does the same as closing the window (since AVP Play 1.5.6). To quit AVP Play completely, click Quit in the small window under the icon. If Open at login is on as well, AVP Play starts as the icon only when you sign in to your Mac, without its window.
- File › Export Game List … and Fetch Saved Games from the Vision Pro
- AVP Play › Check for Updates …
- Help › Report a Problem … – creates an anonymous report you can copy and paste on GitHub. The app itself sends nothing.