meta data for this page
This section provides some basic video troubleshooting steps.
Ensure the CoreELEC Device is directly connected to the Video Output Device (TV, Monitor, Projector,…) with a defect free High Speed HDMI Cable
Team CoreELEC provides no support for daisy chained or defective hardware
High Speed HDMI Cable
Team CoreELEC recommends troubleshooting video display issues with a High Speed HDMI Cable.
High Speed HDMI Cables are designed and tested to handle video resolutions of 1080p and beyond, including advanced display technologies such as 4K@30Hz, 3D, and Deep Color. When using any of these technologies, or when connecting a 1080p HD display to a 1080p HD content source, such as an OTT TV Box, this is the recommended cable.
Never connect or disconnect HDMI cables and equipment while the devices are powered on (refrain from hot plugging cables).
HDMI cables carry a low DC voltage when connected. Connecting or disconnecting an HDMI Cable while the device is powered on may cause damage to the cable, or worse, the device HDMI socket.
Before posting an error
CoreELEC can be installed & booted from USB Flash Drive or SD Card for troubleshooting purposes.
Follow the CoreELEC troubleshooting steps:
- Make a full backup
- Power the device off, and leave the power unplugged for at least 30 seconds
- Ensure the correct device tree was applied to CoreELEC
- Ensure the correct update file was applied to CoreELEC
- Try a clean install (using the correct img.gz / dtb.img file for the device) and restore addons and settings from backup
- Try a clean install (using the correct img.gz / dtb.img file for the device) and then manually re-install the offending addon
- Try a different (class 10) SD card / USB Flash Drive
- Try a new (class 10) SD / USB Flash Drive
Signs & Symptoms of a bad HDMI Cable
Cables and connectors can wear out or endure damage from:
- heavy use
- carelessly connecting and disconnecting the cable
When video and audio quality begin to suffer, and the cable might be the cause, symptoms might include:
- “shooting stars” or “sparkles” in the picture
- fuzzy or blurry picture
- no picture or intermittent picture
- no sound or intermittent sound
- strange colors in picture
- remotes not working (HDMI-CEC)
- cables and sockets for bent or broken pins
- cable connects firmly into socket (the connector could be a bad fit)
- if the weight of the cable is pulling the connector out of the socket
- cables by running them through your fingers and feeling for any cuts or nicks (especially there are pets around)
Other culprits could be interference from:
- cordless phones / base stations
- smart bulbs
- unshielded power supplies
HDMI 2.0 includes support for BT.2020 colorimetry with 10 or more bits of color depth.
Video Formats defined in BT.2020 and supported by HDMI 2.0 specifications:
- 2160p, 10/12 bits, 24/25/30Hz, RGB 4:2:2/4:4:4
- 2160p, 10/12 bits, 50/60Hz, RGB 4:2:0/4:2:2
|4K@24|| RGB |
| RGB |
| RGB |
|4K@50|| RGB |
| RGB |
| RGB |
Some devices might work incorrectly with 4K 4:4:4 colour subsampling.
Try the Use 4:2:2 colour subsampling setting instead.
Demolandia is an audiovisual library containing 4K Dolby, DTS, THX and IMAX Sound System Demos, 4K Video Samples and UHD Demos Screen Test, 3D Video Trailers (side by side & anaglyph), and RGB Videos and Pattern Images for testing Televisions, Projectors and Monitors.
Player Process Info
By use of a USB or Bluetooth keyboard, Kodi can display information about the system and the media currently being played. The information from the OSD of the Audio and Video stream is usefull for helping in finding a sollution by Team CoreELEC.
Kodi Player Process Info has several modes:
|Player Process Info|| Press
|Display Info|| Press
|Player Debug Info|| Press
|Debug Mode|| Press
The Kodi Keymap Editor is a GUI for configuring mappings for remotes, keyboard and other inputs supported by Kodi.
The tool can be used to map keyboard shortcuts to a remote controller button.
When requesting support for video related issues in the User Support Forums, please gather and include as much information as possible:
- if needed: use a cellphone
- detailed description(s) of the issue(s) including:
- what is happening
- what should happen instead
- hardware setup
- TV Set Top Box / SBC
- memory size
- sound system
- a 30 second sample of the video file or (captured) stream
- steps taken prior to contacting support