Simturax

Kodi crashes on startup. Kodi loads to a black screen and kicks you back to the home screen. Kodi plays for a few minutes then freezes. If any of this sounds familiar, you’re in the right place. These crashes usually trace back to one of four culprits: an Android 14 compatibility issue, a corrupted cache or database, a broken add-on or skin, or an architecture mismatch (ARM vs. x86). This guide walks you through every fix—from a 45-second cache clear to a full rollback—so you can get back to streaming.

The 45-Second Fix

Quick Fix: Clear Kodi Cache

1. Go to Android TV Settings → Apps → Kodi
2. Select Force Stop
3. Select Storage → Clear Cache (NOT Clear Data)
4. Restart Kodi

If this doesn’t work, proceed to the full guide below.

Why Is Your Kodi Crashing on Android TV?

Something changed right before the crashes started—a Kodi update, a new add-on, or a device OS update. The root cause almost always falls into one of these categories:

• Android 14 Incompatibility – The most widespread issue in 2026. Devices updated to Android 14 (MECOOL KM2+ Deluxe, Chromecast with Google TV, RockTek GX1, Sony Bravia TVs, Homatics devices) often crash when hovering over or clicking the “Add-Ons” menu. Some users report Kodi 21.x won’t launch at all post-update.
• Corrupted Cache or Database – Kodi stores thumbnails, settings, and library data locally. If these files become corrupted—through an interrupted update, forced shutdown, or storage errors—Kodi can fail to load them and crash before the interface appears.
• Broken Add-on or Skin – An add-on that hasn’t been updated to match your current Kodi version is the single most common crash trigger, especially after a Kodi upgrade.
• Architecture Mismatch (ARM vs. x86) – If you’re running Android on an x86 device (like an Android PC or mini PC), installing the ARM version of Kodi will cause it to crash immediately on launch.

Action 1: Quick System-Level Fixes (Try These First)

These fixes take under two minutes and resolve roughly 80% of Kodi crashing issues.

Fix 1: Force Stop & Clear Cache

Clearing the cache removes temporary files that may have become corrupted without deleting your settings or library.

1. From your Android TV home screen, go to Settings (gear icon)
2. Navigate to Apps → See all apps → Kodi
3. Select Force Stop and confirm
4. Select Storage & cache → Clear Cache

CRITICAL WARNING:

DO NOT tap “Clear Storage” or “Clear Data.” That wipes everything—your settings, library, add-ons, and user data. Only use Clear Data as a last resort, and always back up first (see Prevention Tips).

5. Return to the home screen and relaunch Kodi

Fix 2: Reboot Your Android TV Device

A full restart clears system memory and can resolve temporary conflicts.

1. Unplug your Android TV device from power
2. Wait 30 seconds
3. Plug it back in and restart
4. Launch Kodi

Fix 3: Check and Grant Storage Permissions

Kodi requires file access to function properly. On Android 14, permissions may have been reset during the OS update.

1. Go to Settings → Apps → Kodi → Permissions
2. Ensure Files and media is set to Allow
3. If you see “Remove permissions and free up space” under Unused Apps, turn it OFF for Kodi

Action 2: Android 14 Crash Fix (The Add-Ons Button Workaround)

If you’re on Android 14 and Kodi crashes when you hover over or click Add-Ons, this is a known, widespread issue affecting:

• MECOOL KM2+ Deluxe
• Chromecast with Google TV
• RockTek GX1
• Sony Bravia TVs (Android 14 firmware update)
• Homatics devices
• Other Android TV/Google TV devices

Fix 1: Remove the Add-Ons Button from the Home Screen

This workaround stops the crash by preventing Kodi from loading the problematic Add-Ons menu on startup.

1. Open Kodi (if it stays open long enough) or try repeatedly until it loads
2. Navigate to Settings (gear icon) → Interface
3. Select Configure skin → Main menu items
4. Find Add-ons in the list and uncheck it to remove it from the home screen
5. Exit settings and restart Kodi

Pro Tip: You can still access your add-ons by saving them to Favorites and accessing them from there.

Fix 2: Roll Back to Kodi 19.5 “Matrix”

If the workaround above doesn’t work, rolling back to Kodi 19.5 is the most reliable fix for Android 14 devices.

IMPORTANT: Kodi 19.5 is NOT available on Google Play because Google requires apps to target API level 31 (Android 12) as a minimum, while Kodi v19 targets API level 29 (Android 10). You must sideload it.

1. Uninstall Kodi completely (Settings → Apps → Kodi → Uninstall)
2. Open Google Play Store, tap your avatar (top right), and turn OFF “Auto-update apps”
3. Download Kodi 19.5 APK from a trusted source:

• Official Kodi website: kodi.tv/download
• APKMirror (safe mirror): apkmirror.com

1. Sideload the APK using Downloader or a file manager
2. Install the APK and launch Kodi—it should work immediately
3. Critical: Keep auto-updates OFF, or Play Store will update you back to a crashing version

Why This Works: Kodi 19.5 targets an older Android API level that doesn’t trigger the Android 14 permission bugs affecting newer versions.

Fix 3: Try Sideloading Kodi 21.3 or 22 “Piers” Beta

Some users report that sideloaded Kodi 21.3 works on Android 14 where the Play Store version fails. Others have had success with Kodi 22 “Piers” Beta builds.

CAUTION: Kodi 22 “Piers” is still in Alpha/Pre-release stage (not stable Beta). It is experimental and may have other issues. These builds are not available on Google Play and must be sideloaded.

1. Download Kodi 21.3 APK or Kodi 22 “Piers” Alpha/Pre-release APK from the official Kodi website: kodi.tv/download
2. Sideload the APK using Downloader
3. Test if it launches without crashing

Note: Kodi 22 availability varies by device. Check the Kodi forum for device-specific reports before installing.

Action 3: Database & Configuration Fixes

If Kodi launches but crashes during or after loading, the issue is likely in your userdata folder.

Advanced: Android 14 Scoped Storage Workaround

Important Note: Android 14 restricts direct file manager access to /Android/data/ on some OEM builds due to Google’s scoped storage enhancements. If your file manager cannot access the Kodi directory, use one of these workarounds:

Option A: Enable FTP in X-plore File Manager

1. Install X-plore File Manager from the Play Store
2. Open X-plore and go to Settings (gear icon)
3. Scroll to Network → enable FTP server
4. Tap Start to launch the FTP server
5. From a computer on the same network, connect via FTP using the IP address displayed on your TV
6. Navigate to the Kodi userdata folder and perform the fixes below

Option B: Use ADBLink (Advanced)

1. Install ADBLink on your computer (Windows/Mac/Linux)
2. Enable ADB debugging on your Android TV:

• Go to Settings → Device Preferences → About → click Build 7 times
• Return to Settings → Device Preferences → Developer Options → enable USB Debugging

1. Connect ADBLink to your TV’s IP address
2. Use the file browser to access the Kodi userdata folder

Fix 1: Delete guisettings.xml

This file stores your Kodi configuration. A corrupted guisettings.xml can cause launch failures.

1. Using a file manager (like X-plore), navigate to: /storage/emulated/0/Android/data/org.xbmc.kodi/files/.kodi/userdata/ (If you cannot access this path, use the FTP or ADBLink workaround above.)
2. Find guisettings.xml and rename it to guisettings.bak or delete it
3. Restart Kodi—a fresh default guisettings.xml will be created

Fix 2: Delete Textures14.db & Thumbnails Folder

Corrupted thumbnail databases are a common crash trigger.

1. Navigate to the Kodi userdata folder (path above)
2. Go to the Database folder and delete Textures14.db
3. Go back and delete the entire Thumbnails folder (or rename it to Thumbnails.bak)
4. Restart Kodi—thumbnails will rebuild gradually

Fix 3: Disable Hardware Acceleration

If crashes happen during video playback, hardware decoding may be the issue.

1. Open Kodi → Settings → Player → Videos
2. Scroll down to Processing
3. Disable “Allow hardware acceleration – MediaCodec (Surface)”
4. Test playback again

Action 4: Add-On & Skin Troubleshooting

Fix 1: Boot into Safe Mode

Safe Mode disables all add-ons and skins, letting you identify the culprit.

1. Force stop Kodi (Settings → Apps → Kodi → Force Stop)
2. Method varies by device — common methods:

• Hold the Shift key while launching Kodi (if using a keyboard)
• Hold the Back button during startup (on some remotes)
• On Android TV, repeatedly press the Back button while Kodi is loading

1. If Kodi launches successfully, disable your most recently installed add-ons one by one
2. Switch back to the default Estuary skin if you’re using a custom one. For more skin options, check out our guides on best lightweight Kodi skins for low-spec devices and Kodi skins with Netflix-style interfaces.

Pro Tip: If Safe Mode doesn’t work on your device, use the renaming method below instead.

Fix 2: Rename the Add-Ons Folder (Last Resort)

If Kodi won’t launch at all, you can disable all add-ons from outside the app.

1. Using a file manager (or FTP/ADBLink workaround), navigate to the Kodi userdata folder
2. Rename the addons folder to addons.bak
3. Rename the userdata folder to userdata.bak (optional, creates a fresh profile)
4. Restart Kodi—it will launch with no add-ons
5. Re-enable add-ons one at a time to find the broken one

Best Backup Alternatives to Kodi

If Kodi continues to crash despite all fixes, consider these alternatives:

Summary & Prevention Tips

Kodi crashing on Android TV is frustrating, but in most cases, it’s fixable. Here’s your game plan:

1. Start simple – Clear cache, force stop, reboot
2. If on Android 14 – Remove the Add-Ons button from the home screen or roll back to Kodi 19.5 (must be sideloaded)
3. If crashes persist – Delete guisettings.xml and Textures14.db (use FTP/ADBLink if file manager is blocked)
4. If add-ons are the issue – Boot into Safe Mode or rename the addons folder

Callout: Backup Your Kodi Setup (Do This NOW!)

After successfully fixing your Kodi installation, immediately back up your configuration to prevent future data loss.

Use OpenWizard (Recommended):

1. Install the OpenWizard add-on from a trusted repository (e.g., GitHub: openwizard/openwizard)
2. Go to Add-ons → OpenWizard
3. Select Backup → Create Full Backup
4. Choose a location (USB drive or network share)
5. Your entire setup is now backed up and can be restored in minutes if crashes recur.

Why This Matters: After going through this entire guide, the last thing you want is to lose your working configuration. A backup ensures you can restore everything—settings, library, add-ons—without repeating the troubleshooting process.

Prevention Tips

• Turn off auto-updates in the Google Play Store after finding a working Kodi version
• Only install add-ons from trusted sources
• Back up your Kodi setup regularly using OpenWizard or EZ Maintenance+
• Check Kodi forums before updating to a new version
• Enable FTP in X-plore or set up ADBLink in advance—so you’re ready if Android 14 blocks file access

Still running into setup errors or looking to push your media player further? Explore our complete, unrestricted library of blueprints over at Fix Common Kodi Problems guide. You can also learn how to reset Kodi to default settings if you need a fresh start, or explore best Kodi repositories for finding trusted add-ons.

Frequently Asked Questions

This guide was written by Simturax – a technology and streaming media specialist with over 10 years of experience covering Kodi, Firestick, Android TV, and IPTV. All instructions were physically tested on actual hardware (Fire TV Stick 4K Max, NVIDIA Shield, Chromecast with Google TV) and verified. We prioritize accuracy, transparency, and user safety above all else.