Kodi Videos Not Playing? Fix Common Playback Problems

If Kodi videos are not playing, first check whether the problem affects one file, one add-on, or every source; that distinction usually points to the cause. Check your internet connection and Kodi’s playback settings, then test a known-good local video before changing add-ons or reinstalling the app.

How to narrow down the problem

Kodi is a media-center application that plays files and can connect to sources through add-ons. Playback can fail at several points: Kodi may not find the source, may be unable to read the file, or may struggle to decode or display the video. A blank screen, endless loading, an immediate return to the menu, and audio without video can therefore have different causes.

Start with a simple comparison. Try another video from the same source, then a file stored locally on the device. If the local file works but a stream does not, focus on the network, source, or add-on. If no videos work, investigate Kodi’s settings, the device, or the file formats it can handle.

One file fails: The file may be damaged, incomplete, or encoded in a format the device cannot decode.
One add-on or source fails: Its service may be unavailable, its configuration may need attention, or the source may no longer provide the item.
Everything fails: Check network access, available storage, audio/video settings, and whether Kodi or the device needs an update.

Check the source and connection

For network streams, confirm that the device running Kodi can reach the internet. Open another app or website on that same device; a connection that works on a phone does not prove that a television box or computer is online. Restarting the router and the Kodi device can clear a temporary connection problem, but it will not fix a broken source or an incorrect add-on configuration.

For a shared folder or network-attached storage, verify that the host is switched on and that the share is still available. A changed password, device name, address, or folder permission can prevent access. Recheck the location and credentials in Kodi’s source settings rather than assuming the video itself is broken.

When only a particular stream fails, try another item from the same source and check whether the provider reports an outage. Avoid repeatedly changing unrelated settings: it makes the cause harder to identify. Add-ons are maintained by their respective developers, and a playback failure may be outside Kodi’s control.

Check the file and supported formats

A video’s filename extension, such as MP4 or MKV, describes its container, not necessarily the codecs inside it. Two files with the same extension may use different video, audio, subtitle, or color formats. Whether a file plays depends on the Kodi version, operating system, device hardware, and available decoders.

If a local file fails, try a different known-good file. Check that the file’s size is plausible and that a copy or download completed; a partial file may appear in a library but stop or fail at playback. If you can, test the troublesome file in another player on the same device. If it fails there too, the file or device’s format support is a more likely cause than Kodi’s library.

Some devices rely on hardware decoding, while others can decode formats in software. A video that exceeds the device’s decoding capability may stutter, show a black screen, or play audio without a usable picture. Testing a lower-resolution or more widely supported version can help identify a capability issue. Do not delete an original file just because one device cannot play it.

Adjust playback settings carefully

Settings that control video output, refresh rate, audio passthrough, and hardware acceleration can affect playback. Menu labels and available options vary across Kodi releases and devices, so look under Kodi’s video or system settings and consult the documentation for your installed version. Change one setting at a time, then test the same file again.

If a picture is black but audio plays, check that the display is on the correct input and that the device’s resolution and refresh-rate output are supported by the television or monitor. If audio is missing, check the selected audio output and whether passthrough is enabled for formats the connected receiver supports. Reverting a recent setting change is often safer than enabling several advanced options at once.

Subtitles can also cause confusion: a subtitle track may be unavailable, delayed, or displayed in an unexpected format even though the video is playing. Turn subtitles off temporarily to see whether they are the issue. This test does not repair the video itself, but it separates a subtitle problem from a playback failure.

Update, restart, and clear space

Restart Kodi and the device before taking more disruptive steps. Then check for updates through the normal update method for the operating system or installation you use. Kodi’s official downloads and documentation explain supported installation routes; third-party builds may behave differently and can make troubleshooting more complicated.

Make sure the device has enough free storage. Very low storage can interfere with downloads, temporary files, and general operation. Remove only files you recognize and no longer need. Kodi’s cache is not a universal fix: clearing data or resetting the application can remove settings, library information, or add-on configuration. Back up important configuration before resetting, and do not erase application data as a first step.

Restart Kodi, then restart the device if the issue remains.
Test a local file and a second source to isolate the failure.
Check connectivity, source access, storage, and available updates.
Change one relevant playback setting at a time and retest.
Back up configuration before removing add-ons or resetting Kodi.

Keep add-ons and sources in perspective

Kodi itself is a media player; an add-on is a separate component that can provide access to content or services. An add-on may stop working because its service changed, its developer discontinued support, or the connection or account required by that service is unavailable. Updating Kodi does not guarantee that every add-on will work, and reinstalling Kodi may not repair a source-side failure.

Use add-ons from sources you trust and check what permissions or access they request. Avoid unknown “fix” packages that promise to restore every stream, and do not provide account details to unofficial services. For a service you use legitimately, consult that service’s own help information and use its supported access method.

Frequently Asked Questions

Why does Kodi play audio but show a black screen?
Possible causes include an unsupported video format, a decoding problem, or a display-output setting the screen cannot handle. Test another file, check the display connection, and review relevant video settings one at a time.

Why does Kodi keep buffering?
Buffering may come from a slow or unstable connection, a busy network, or a source that is not delivering data reliably. Test another stream and another device on the same network; if local videos play normally, the stream or connection is the likely focus.

Why does Kodi return to the menu when I start a video?
The source may be unavailable, the file incomplete, or Kodi unable to decode it. Compare a local file with another item from the same source to determine which part of playback is failing.

Will reinstalling Kodi fix videos that will not play?
Not necessarily. Reinstallation may help with a damaged installation, but it will not fix a failed source, unsupported file format, network outage, or device limitation. Back up settings before reinstalling because application data may be removed.

Does an MP4 file always work in Kodi?
No. MP4 is a container, and the codecs and other formats inside the file determine whether the device can play it. Support also depends on the device and software environment.

Should I clear Kodi’s cache?
Only if you have identified a cache-related problem and understand what the chosen cleanup method removes. Clearing application data or using an unfamiliar cleaning tool can erase settings or other information and is not a reliable fix for every playback issue.

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.

More cards in this drawer

The whole Numbers and Powers drawer →