Repository navigation
Help and FAQ
Problems that have come up more than once – with fixes you can do yourself. When a job stops, first look at the What Went Wrong box under Jobs: it usually already says what to do.
Contents: Setup and Apple account · Connecting the Vision Pro · Downloads, Meta and Steam · A game won't start or runs badly · In the game · What doesn't work · Reporting a problem
Xcode sometimes lists the account as signed in but cannot use it.
- Open Xcode › Settings › Accounts.
- Sign the account out and back in (just checking it is listed is not enough).
- In AVP Play, click Resume on the job.
As above: sign in again in Xcode under Settings › Accounts, then Resume.
Yes. Limits: a game opens for 7 days, then it has to be signed again. At most 3 apps from your account on the Vision Pro at once (apps you installed yourself with Xcode count too). At most 10 new games per week. A very large game may fail on memory with a free account. More under Setup.
That is the free Apple account's limit. Fix: install the game again in AVP Play (saved games stay). Easier: turn on Settings › Renew signatures – the app then does it by itself while the Vision Pro is on and on the same Wi-Fi.
Remove an app from the Vision Pro (press and hold its icon › Remove App), then Resume. Let the app back up its saved games first (game page › Fetch Now) – removing deletes them on the Vision Pro.
Apple sets this limit for free accounts. Wait until the oldest registration is 7 days old.
On the Vision Pro: Settings › General › VPN & Device Management, choose your Apple account, tap Trust. Needed once per account.
Sign in at developer.apple.com/account, accept the agreement, then Resume.
The game was installed before with a different Apple account. In AVP Play, enter another prefix under Settings › Advanced and install again. The Vision Pro then treats the game as a new app.
Type your Mac password and click Always Allow with the mouse.
Turn on the Vision Pro, put it on or unlock it, on the same Wi-Fi as the Mac. The very first time it has to be paired with Xcode – see Setup. The app notices by itself a few seconds after the Vision Pro is back; Check Again at the bottom of the sidebar does it at once.
Put it on, unlock it, Resume.
- With a USB cable on the Developer Strap it is much faster; the app uses the cable by itself.
- Break-offs usually happen because the Vision Pro went to sleep. Keep it awake, Resume – whatever was copied is skipped.
Quit the game on the Vision Pro (Digital Crown), then Resume. The app waits on purpose so your saved game isn't lost.
Usually the Vision Pro's storage is full. On the Vision Pro, check Settings › General › Storage and remove apps you don't need. Big games need their full size again on the Vision Pro (Asgard's Wrath 2 about 34 GB).
Steam Link needs the Local Network permission. The Vision Pro asks the first time you open it – tap Allow. If you declined: Settings › Privacy & Security › Local Network and turn on Steam Link.
For add-on content you haven't bought, the app skips the file and carries on. For main files it tries once more through Meta's own tool by itself. If both fail, the job says why.
You can still install and update if all the files are on this Mac. AVP Play then uses the last answer, including the list of add-ons you bought. These answers are stored encrypted on the Mac and count only here and only for the account you are signed in with. If Meta or Steam has never confirmed a game on this Mac, it won't work: wait until the service answers again. To skip asking altogether, use Offline.
- Click Check Purchase on the game's page – a new purchase sometimes takes a few minutes.
- Bought with another Meta account? Sign in with that account under Setup.
- Bought on Steam? Sign in to Steam and Check Purchase again.
Sign in again under Setup › Meta Account, then Resume.
System Settings › Privacy & Security, scroll down, click Open Anyway next to ovr-platform-util. In the app, Try Again.
Valve only makes SteamCMD for Intel Macs. Under Setup › Steam Account click Install Rosetta (or run softwareupdate --install-rosetta --agree-to-license in Terminal), then reopen AVP Play.
Steam lets a sign-in run out after a while. Under Setup › Steam Account click Sign In …: from AVP Play 1.5.2 on, the app then forgets the old sign-in by itself and asks for your password. Older versions showed only "Access Denied" instead of asking for the password – updating AVP Play to 1.5.2 fixes that.
After every sign-in SteamCMD fetches the Steam client's data. Sometimes Steam does not send it – that is on Steam's side, not your account. Your sign-in stays saved anyway. Wait a while and try again; you do not need your password for that. (AVP Play 1.5.1 wrongly deleted the sign-in in this case – 1.5.2 no longer does.)
It means the name you sign in to Steam with – not your profile name.
Game page › Sync DLCs. Restart the game afterwards.
- Data: remove old or unneeded downloads.
- Data › Downloads Folder › Change …: move to an external drive.
- Settings › Toolchains: keep automatic tidying on.
Yes: Download Only on the game's page only needs the account the game was bought with.
On the game's page, under Toolchain, keep the game on your toolchain.
Every verified game needed its own adjustments – so untested games often don't work. Since 1.3.0, untested games get somewhat safer default settings; still, trying is an experiment. What you can do:
- Report what happens under How does it run? – it helps everyone.
- Try Fix with AI … (see A game's page).
- Report a problem on GitHub (see below).
Normal. On the first start the game translates its graphics – that can take a few minutes. After that it is quick.
The first time, each new graphic is translated. On the next visit it is smooth. In Batman: Arkham Shadow and Moss this now happens in the background (switchable under Advanced › Test in the settings).
The Vision Pro halves the frame rate when a game can't keep up. Try:
- Keep Frame rate: Up to 100 (default).
- Lower the Resolution and turn on MetalFX (right below Resolution).
- Under Advanced, set Display output to Light.
- Foveated rendering at Strong or Very strong.
- In Half-Life: Alyx, the graphics preset Smooth or Balanced.
The performance panel shows what's behind it.
That was a bug in an older version. Update AVP Play and rebuild the game with Update. The first start afterwards takes a bit longer.
Rare. Quit the game and start it again – it usually goes through. If it happens often: in the game's settings turn on Advanced › Diagnostics › Record what the game waits for and send the log with a report.
With a current toolchain, the "compiling shaders" screen stays until everything is done – several minutes on the first start. Just let it run.
This happened after another window took over, for example Mac Virtual Display or a system window. Since AVP Play 1.10.7 the buttons keep working; update and rebuild the game with Update. If it still happens: look at the game and tap once with your fingers.
Press the Digital Crown. The game ends shortly after. There is no pausing in the background – every start is a fresh start.
Look around briefly so the game sees enough of the room. After 8 seconds a card asks: Measure room or Stationary / seated. In a new room, simply measure again. More under Play area.
In the start window turn off Settings › Play area – or in AVP Play under Settings › Play area for all new games. See Play area.
On the Vision Pro: Settings › Privacy & Security › Surroundings and allow the game.
Turn on Microphone in the game's settings and allow the Vision Pro's prompt.
Demeo can't sign in to its maker's account service and plays with a local player. Set the name in the settings under Player name.
In the game on the Vision Pro: Settings › Steam Cloud. Enter your Steam account name and password and confirm in the Steam app on your phone.
AVP Play fetches saved games to the Mac by itself (after every game and every few hours). When you reinstall, they come back automatically if the Vision Pro has none. Careful: removing an app on the Vision Pro deletes its saved games there – the copies on the Mac stay. Half-Life: Alyx uses Steam Cloud.
- 32-bit games (e.g. République VR): the Vision Pro's chip cannot run 32-bit code. Can't be fixed.
- 2D apps such as Spotify, WhatsApp or YouTube: AVP Play is for VR games only.
- Pausing in the background: every start is a fresh start.
- Mixed reality only in the games set up for it (filter Mixed Reality).
- Games labelled Incompatible: the game's page says why.
- In AVP Play: Help › Report a Problem … – or Report This Problem … in a stopped job.
- Click Copy and Open GitHub and paste the report into a new issue.
The report contains no names, accounts, device identifiers or folder paths. The app itself sends nothing.
For problems in a game, the log from the Vision Pro helps: start window › Settings › Advanced › Diagnostics › Export log.
AVP Play 1.4.7 · Download · Report a problem / Problem melden · 🇩🇪 Deutsch · 🇬🇧 English
🇩🇪 Deutsch
- Erste Schritte
- Einrichtung
- Spiele finden und filtern
- Die Seite eines Spiels
- Spiele von Steam
- Beat Saber mit Mods
- Aufträge
- Datenverwaltung
- Einstellungen der App
- Auf der Vision Pro
- Spielbereich (Raum vermessen)
- Steuerung und Controller
- Fernbedienung (AVP Play Remote)
- Hilfe und FAQ
- Begriffe einfach erklärt
🇬🇧 English