# Video playback troubleshooting

## General stuttering and missed frames

<figure><img src="/files/uxrVd7Cle7mJTVx8kyOc" alt=""><figcaption></figcaption></figure>

The best place to start investigating what's happening with your video playback is the **Performance** window where you will find a **Video playback** section.

{% hint style="info" %}
**Good to know:** if you see **Missed frames** continuously increasing it means Play Video nodes in your layers cannot read, decode and render the frames fast enough.
{% endhint %}

{% hint style="info" %}
**Good to know:** if Missed frames are not increasing yet you still see stuttering on the outputs, the culprit might be something else.
{% endhint %}

If Missed frames are continuously increasing there are usually 2 possible reasons for that:

1. Insufficient disk read speed
2. Insufficient CPU speed.

### Insufficient disk read speed

This can happen especially with codecs that produce large filesizes, such as HAP, NotchLC or image sequences.

{% hint style="info" %}
**Good to know**: if Decode times and Decompress times are pretty much low and you still experience general stuttering and missed frames, it means it is likely that the reason is the insufficient disk read speed.
{% endhint %}

<figure><img src="/files/iAzXgdbzzyliYm1xaDrr" alt=""><figcaption></figcaption></figure>

In **Performance** window you can see the current **Disk read speed**.

{% hint style="warning" %}
Softwares like Google Drive or Desktop every now and then consume a lot of disk read bandwidth, which prevents LightAct to be able to read the frames with high enough speed. It is therefore recommended to disable these software packages on your server.
{% endhint %}

### Insufficient decode speed

LightAct might be able to read the frames fast enough from the drive, but if the CPU is overloaded, LightAct won't be able to decode the frame in time to render it.

{% hint style="info" %}
**Good to know:** every codec requires the CPU to do part of the decoding, even HAP and NotchLC. H.264 requires far more CPU resources than HAP or NotchLC.
{% endhint %}

<div align="left"><figure><img src="/files/JyvOcVdMwNvQZrcQV5fp" alt=""><figcaption></figcaption></figure></div>

If disk read disk speed is low, yet you see Missed frames in the Performance window, check the Decode and Decompress times in the graphs of the Play video node. If they are high, it might mean the bottleneck is the CPU.

### Insufficient framerate

If the framerate of the video file is higher than the current framerate of the application, you will get Missed frames. The only remedy to this situation is to increase the framerate of the application.

## Blinking/flickering videos with alpha channel

<div align="left"><figure><img src="/files/xDOVOp8qC7QT4OxRjJjL" alt=""><figcaption></figcaption></figure></div>

If you have a video file with alpha channel you should disable Frame blending boolean. If it's enabled and the video contains alpha channel (with semi-transparent pixels) you might see some flickering or blinking.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lightact.com/video-playback/video-playback-troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.