Troubleshooting

This article lists the problems that occur most often when working with Livegrade Cinema and their causes. Most of them concern the connection to the server and the quality of the wireless network.

No server is found in the local network#

The Apple Vision Pro must be in the same local network as the machine running Livegrade, and Livegrade must be running on that machine.

Livegrade Cinema needs permission to access the local network. It is requested on first launch and can be changed later in the visionOS settings for the app.

On the server machine, check whether Livegrade is allowed under “Local Network” in the macOS “Privacy & Security” settings.

In some network configurations, automatic discovery does not work. In that case the server can be added manually with the plus button in the Servers tab, using its IP address.

The join code is not accepted#

Join codes are created in Livegrade on the sending machine. A code can be single-use, in which case it is no longer valid after a successful pairing, and codes can expire.

The message “Wrong or expired join code” points to a code that is no longer valid; a new one has to be created on the server. After several failed attempts, further attempts are blocked briefly and the message “Too many attempts — try again in a minute” is shown.

The message “This server does not support code pairing” indicates a server using the legacy protocol. Such servers expect the streaming password instead of a join code.

The server is connected but no streams are offered#

Streams have to be configured in Livegrade as local stream outputs. Only then do they appear in the Streams tab. A connected server without configured outputs shows “No Local Stream Outputs.” in the stream menu.

The image stays gray#

If a server is connected but no image arrives, an active VPN connection may be blocking local streaming. The status shown over the image area names the cause; the messages are listed in Monitor window.

Stuttering or dropped frames#

The quality of a wireless network depends strongly on the position of the device and on the surroundings. If the image stutters or frames are dropped, change position first.

Checking the reception on the device#

The state of the reception is shown in the app itself. Enable Show Buffer Summary in the Settings tab; a badge then appears in the stream info bars and in the panels of the cinema and the immersive view.

The colored dot of the badge shows whether the incoming data arrives early enough: green for a comfortable lead, orange when the lead falls below half a frame, red when the timing was missed. Recurring orange and red states indicate that the network does not deliver the stream reliably.

Raising the buffer time compensates for irregular transport at the cost of a higher delay. The Robust strategy is designed for networks with larger fluctuations; in Manual mode the buffer is set to a fixed time.

Checking the connection in Livegrade#

Independently of the device, the Livegrade operator can check the round-trip statistics of the connection in the output slot in Livegrade, and reduce the bitrate of the stream if the network capacity is not sufficient. As long as the round-trip time stays below 40 ms, the stream should be stable.

Further steps#

If the network quality is good and the image still stutters, the following steps help:

• Disable AirDrop on the server machine and on all connected devices.
• Connect the machine that generates the streams to the router with Ethernet instead of Wi-Fi, disable Wi-Fi on that machine, and create the streams again.
• Remove the server in the app with Forget , set it up again, and restart the app.

No button for the cinema or the immersive view#

The button in the upper right corner of the image area appears only while the controls of the stream are visible, and only once the codec of the stream is known.

If the button is disabled, the sending machine restricts the stream to the standard viewer. The reason is shown on the button; see Immersive view.

The cinema or the immersive view closes by itself#

Both modes close automatically when the stream stops delivering frames for several seconds, and restore the windows. A stream that was stopped on the server, a suspended server, or an interrupted network connection causes this.

Not all windows are visible after leaving the cinema or the immersive view#

Entering the cinema view or the immersive view hides all windows of the app, and leaving it restores them. visionOS restores several windows stacked over one another instead of at their previous positions, so windows can end up hidden behind the frontmost one.

The windows themselves are not lost, and their layout and stream assignment are unchanged. Pinch and drag the window bar of the frontmost window to move it aside; the windows behind it become accessible again and can be placed as needed.

There is no audio#

Local streaming and immersive local streaming currently do not carry audio.