Troubleshooting Guide

for stuttering Playout, Dropped Frames, Glitches, Freezes


QUICK SOLUTIONS

  1. Update all relevant driver, esp. GPU and output hardware (e.g. Decklink)
  2. Use common video format and codecs like H2.64/MP4 and avoid codecs, that cant be decoded via GPU correctly, like DNxHD, ProRes, MXF
  3. Close all other Apps while operating PLAYDECK, esp. Video Software, also Chrome, Discord, NDI Access Manager, Blackmagic Desktop Video, ATEM Control Software
  4. Disable Security Software for Testing Purposes, esp Anti-Virus
  5. If using Desktop Output, set the monitor resolution and FPS to the same as the PLAYDECK playlist
  6. In PLAYDECK (Workflow > GPU), set the GPU Renderer to PRIMARY and GPU Decoder to your NVidia (or CPU, if you dont use NVidia). Also reduce the Quality to LOW for testing Purposes (will not reduce output performance).
  7. Load all Clips and Content locally, not over the network
  8. If it worked before, re-install PLAYDECK and select “Reset all Settings” during installation
  9. If using Nvidia, open Nvidia control panel and “Manage 3D Settings > Global” and set “Power management mode > Prefer maximum performance”.
  10. Start PLAYDECK as administrator (right click “Run as Administrator”)
  11. Configure Windows Power Management for Maximum Performance or disable Energy Saving completly
  12. Go to “Windows > System > Display > Graphics” and add “Playdeck.exe” and “”PlaydeckEngine.exe” as App with the setting “High performance”
  13. If using Nvidia, disable Service “NVidia FrameView SDK” (Startup Apps) and set to “Manual” (mainly Windows 11)
  14. If using RDP (Windows Remote Desktop), switch to another Software, which does not install a Virtual GPU, e.g. RustDesk



DETAILED TROUBLESHOOTING

PLAYDECK does not start / PLAYDECK does not load videos

In this case please refer to this guide:
https://playdeck.tv/troubleshooting/unable-to-start-playdeck/

Check Output and System Load
If you see glitches in the PREVIEW, that doesnt mean that there are glitches in the OUTPUT (device or NDI). Also check, if your system is overloaded by opening the Task Manager (ESC + SHIFT + CTRL).


PLAYDECK starts fine, but no Clip is playing, or playback is superslow

If nothing plays, the GPU is not utilized as it should be. Or GPU and/or output hardware is compromised. Try setting your GPU as primary GPU (see below). Try using CPU rendering (Workflow > GPU) and deactivate all output hardware, restart PLAYDECK. Update all drivers or try different hardware.

Constant Stuttering in Audio Output

If video seems to play fine, but the audio is stuttering alot, this indicates a system overload. Since the GPU % display in PLAYDECK shows only NVidia usage, you should open the task manager and check CPU/GPU for the whole system.

To reduce overall system load:
– Use common video codecs (e.g. H.264 instead of ProRes)
– Avoid transcoding (clips have same resolution as playlist)
– Avoid HTML overlays
– Disable channel name in Previews
– Reduce resolution
– Use a dedicated SDI output card (e.g. Decklink)

You may find urself in a situation, where you have to upgrade your hardware. We recommend going for a decent GPU (e.g. NVidia RTX 3060+), since CPU and RAM are not of much relevance to PLAYDECK.

In other rare cases, the frame rate of the monitor is cause audio stuttering. Set your monitor refresh rate to the same as the Playlist or at least to max 60 Hz.

Frame Drops on start playing a new Clip, otherwise ok

This indicates a bottleneck from HDD or GPU or CPU. Use SDD. Disable any form of HDD/SDD sleep. Set energy settings to maxium performance. Use lates NVIDIA driver. Play files locally instead of network or NAS. Check for possible overheating problem of GPU. Disable CPU sleep/parking (pref. on Notebooks)

Clip as Bottleneck (DNxHD 185x, HAP or ProRes Codec + MXF files)

ProRes unfortunately is not well suited for playback on Windows-based systems. This is because Apple does not provide Windows-optimized codecs. DNxHD 185x, HAP Codecs or MXF files cant be decoded via GPU and are forced to be decoded on the CPU.

In both cases, we recommend switching to H.264 or H.265 instead. For Alpha we recommend HAP. We also recommend to use clips with the same resolution and framerate as the PLAYDECK playlist setting to avoid transcoding.

Avoid directly encoding clips with “Apple Quicktime” or “Final Cut Pro”. That tend to cause problems.

If you have individual stuttering clips, you can use “TMPGEnc Video Mastering Works” to encode the Clips into a good default format, which would be:

– File Extension: mp4
– Format: MPEG-4
– Video Codec: AVC (Advanced Video Codec), Main 4.1~5.2
– Video Bitrate: Variable 10~50 Mb/s
– Audio Codec: AAC LC (Advanced Audio Codec Low Complexity)
– Audio Bitrate: Variable 300~600 kb/s

Harddisk/Network as Bottleneck

Please make sure, that the data rate of your clips can be transferred flawlessly through your system. if your clips run over the network, test them on your local harddisk.
Edit your Windows Power Options and disable any HDD sleep mechanics.
Place all used media on the same storage source, ideally a local SSD.

GPU as Bottleneck

Update to the latest driver. In case of NVidia, use the STUDIO driver. They are considered to be more stable than the GAME READY driver.

Since all rendering and decoding processes of PLAYDECK are executed on the GPU, a powerful graphics card is indispensable. PLAYDECK has been developed for NVIDIA graphic cards. It is very unlikely, that you get a good performance out of the CPU alone.

Also make sure, your GPU is powerful enough. Older or weak GPUs may show Video, but Timing Problems will occur sooner or later. As a quick orientation, you can use this chart. Use a GPU with at a score of at least 3000. A good recommendation is a NVidia GeForce RTX 3060:
https://www.videocardbenchmark.net/directCompute.html

If you have multiple GPUs in your system, PLAYDECK will try to select your most potent GPU. Please check under “Settings > Workflow > Performance > GPU + Quality”, if PLAYDECK selected your best GPU, otherwise change it manually.

In case your PLAYDECK runs on an older Onboard GPU (Intel), it might be worth testing the CPU mode to check, if you get a better performance out of PLAYDECK.

There is an exception on Notebooks:
Some Notebooks, mostly DELL, come with an Intel and NVidia GPU. It is important to set the GPU Renderer to <PRIMARY> in this case, as the NVidia is only an OFFLOADING GPU, and cant be used directly. The Notebook itself will decide, when to use the NVidia.

Also check GPU power saving on Notebooks:
All Notebooks have a highly power saving factory setting. This can lead to stuttering during playout, as the GPU is NOT utilized to the fullest. Most notebook manufacturers have pre-installed software to manage GPU settings. Asus for example have “Armoury Crate”, where you need to set the GPU to “Ultimate” for it to work 100%.

There is one other phenomenon worth mentioning:
If you observe, that the GPU load displayed on the GUI shoots up significantly, even when PLAYDECK is currently idle and not displaying video: When the demands on the GPU are low, the NVidia driver adjusts the clock frequency down significantly to save energy. However, the percentage utilization at this reduced clock frequency then increases sharply. To deactivate the automatic adjustment, simply go to the NVidia control panel and set the following under “Manage 3D settings” in the “Power Management” section: “Prefer Maximum Performance” (not “Prefer optimum Performance”).

No HTML on Director View (or Overlays):
If no HTML is shown anywhere in PLAYDECK, this most often is an issue of Intel Onboard GPUs. In this case switch to CPU as Renderer in PLAYDECK.

CPU as Bottleneck

Lets assume, you have a powerfull GPU and the CPU usage % in PLAYDECK isnt rising above 70%. This still does not mean, that your CPU isnt clipping. Its still possible, that not all CPU cores are used.

Watch your CPU cores carefully in the task manager, while playing the glitching clip. Maybe one CPU core is clipped at 100%, while other cores are barely being used. This phenomenon is called “CPU parking”. Check, if the CPU usage goes UP, if you DONT play any clips. This indicates, that the CPU cores are been parked, because there is less activity. Here is some information on how to proceed:
https://itechviral.com/enable-or-disable-cpu-core-parking-in-windows-10/

Watch out for specific processes in the task manager, which have sudden CPU spikes and disable those processes. One known process is “Antimalware Service Executable”, which is the Windows Defender:
https://blog.emsisoft.com/en/28620/antimalware-service-executable/

Also check the energy settings and make sure, that everything is set to “High performance”.

Decklink (or other) Ouput card as Bottleneck

Since the frame rate control is handed over to the decklink device, once it has been activated, the device itself may cause the glitch and not the system. There are some cases, where customers had installed the decklink to a shared PCI slot, where bandwidth would be reduced. In this case you would see stuttering playout, since the low bandwidth would reduce FPS, which in return will reduce playout speed in PLAYDECK (hardware controle the frame rate). Also remove any other (unused) secondary output cards, which may interfere with your primary output cards, which may be PCIe slot bandwidth sharing or driver conflicts.

We recommend switching the production format to PAL for testing purposes and watch, if the glitches still appear. You could even deactivate the decklink completly and do a testrun.

Please also use the latest driver for your hardware. Some hardware even require you to apply firmware updates.

Too many Frame Rate Conversions

Always use the same FrameRate/FPS for your monitors, as you set for the Playlist in PLAYDECK. Use the same Frame Rate for every Device within the signal route between PLAYDECK and your Output Device. If you for example connect fixed 50Hertz and 60Hertz Monitors to the system and let PLAYDECK do Desktop Output, you may see stuttering or lagging video output, because the GPU is in a Frame Rate Conversion Conflict. Always use the same FrameRate/FPS for your monitors, as you set for the Playlist in PLAYDECK.

Remote Desktop Software / VPN

If you disconnect from the Remote Machine and the Playout Stutters or interrupts completly, please try using RustDesk instead of Windows Remote Desktop. Windows RDP installs a virtual GPU for Remote Sessions. And this virtual GPU is removed by Windows the moment the Remote Session is disconnected. You cannot do anything about this behavior.

In this case, deinstall any and all Virtual GPU Driver (Check Device Manager > Display adaptors). PLAYDECK has been tested and approved with RustDesk for Remote Control.

NDI Access Manager

In some cases the NDI Access Manager is running and causes huge playout lags from several seconds to even a full minute. The Output is NDI in PLAYDECK. In those cases multiple NDI Apps had be opened like OBS Studio or vMIX and the NDI signal got interrupted. Closing those Apps helped. Further more a more detailed configuration of the NDI access manager is needed.

Other Apps as bottleneck

Other applications may use the harddisk, or network, or GPU/CPU. This may not be recognized as GPU/CPU peak, because the app produces only a very short burst/bottleneck. This is harder to detect. Especially if your clips run smooth most of the time and sometimes/rarely glitch or drop only few frames.

Disable any other applications, that might interfere with the clips you are playing. This would most likely to be Anti-Virus/Malware software.

Also try to create a new user within Windows and start PLAYDECK with the user, who has no administration rights. This might block other apps from interfering.

Other Hardware related bottlenecks

Sometimes you might not even realize, that even the power unit of a system can bottleneck the playout. This is especially true, even you use a powerfull graphics card and another playout card (e.g. Decklink), but only provide, lets say only 600W power, which most certainly isnt enough and would cause the graphics card to cause stuttering (especially on the start of the clip, when power is drawn).

If using several video adapters, a good airflow is also very important to prevent overheating of components, which most likely result in glitches happening more later than sooner.

You can use this Bottleneck Tester to see, if any of your components is underperforming:
https://pc-builds.com/calculator/