Simturax

A black screen after changing your Kodi skin occurs when the new skin is incompatible with your Kodi version, has corrupted files, or conflicts with your existing GUI settings. This is one of the most common Kodi issues—and you can fix it in minutes without reinstalling anything.

STATUS DISCLAIMER

Current Kodi Versions: Kodi 21 “Omega” (Stable) | Kodi 22 “Piers” (Stable/Pre-release)

Important Note: This fix works on all Kodi versions, including v19 Matrix, v20 Nexus, v21 Omega, and v22 Piers. The guisettings.xml edit method is universal across all Kodi installations regardless of platform or version.

Privacy Note: This guide involves editing system files on your device. No third-party tools or online services are required. All fixes are performed locally on your device.

Quick Fix – Reset Kodi to Default Skin

1. Locate your Kodi userdata folder (paths provided below).
2. Open the guisettings.xml file with a text editor.
3. Find the line containing: <lookandfeel><skin>...</skin></lookandfeel>.
4. Change the skin value to: <skin>skin.estuary</skin>.
5. Save the file and restart Kodi.

Firestick/Android TV Users: You’ll need a file manager app like X-Plore File Manager with “Show Hidden Files” enabled to access the userdata folder.

Why Is Your Kodi Experiencing This Issue?

A black screen after a skin change usually means Kodi’s graphical user interface (GUI) can’t render the new skin properly. Here are the most common triggers:

Action 1: The Reliable File Edit Method (Highest Success Rate)

Editing the guisettings.xml file is the most dependable fix for a black screen after a skin change. This works on all platforms: Windows, macOS, Linux, Android, Firestick, and even CoreELEC/LibreELEC.

Step 1: Locate the userdata Folder

The location of your Kodi userdata folder varies by operating system:

Firestick/Android TV Users: The .kodi folder is hidden by default. You need a file manager app with “Show Hidden Files” enabled.

Recommended App: X-Plore File Manager

• Download X-Plore from the Play Store/Amazon Appstore.
• Open the app and navigate to the root directory (usually the top level)
• Go to Android/data/org.xbmc.kodi/files/.kodi/userdata/
• Enable “Show Hidden Files” in X-Plore’s settings (Menu → Settings → Show Hidden Files)
• You cannot plug your Firestick directly into a computer to edit XML files—use X-Plore’s built-in text editor instead

Alternative file managers: Cx File Explorer (with hidden files enabled), FX File Explorer, or ES File Explorer (older versions).

Step 2: Open guisettings.xml with a Text Editor

• Windows: Right-click → Open with → Notepad
• macOS: Right-click → Open with → TextEdit
• Linux: Use nano, vim, or gedit
• Firestick/Android TV: Use X-Plore’s built-in text editor (tap the file → choose “Text Editor” or “Edit”)

Step 3: Find and Edit the Skin Setting

Search for the line that contains lookandfeel.skin. It will look something like this:

<lookandfeel>
<skin>skin.aeonmq8.matrix.mod</skin>
...
</lookandfeel>

Change it to the default Estuary skin:

<lookandfeel>
<skin>skin.estuary</skin>
...
</lookandfeel>

Step 4: Save and Restart Kodi

Save the file and restart Kodi. Your interface should now be back to normal with the default Estuary skin.

Step 5: If the Skin Still Crashes – Delete the Skin’s Settings File

If Kodi loads but crashes again when you try to switch back to your preferred skin, the skin’s own settings file may be corrupted.

1. Navigate to userdata/addon_data/
2. Find the folder for the problematic skin (e.g., skin.aeonmq8.matrix.mod)
3. Inside, locate a file named settings.xml
4. Move or rename this file as a backup (e.g., settings_old.xml)
5. Restart Kodi and try switching to the skin again. Kodi will generate a fresh settings.xml file automatically.

Action 2: The Nuclear Option – Reset All Kodi Settings

If editing the file doesn’t work, you can force Kodi to create a brand new configuration file. This will reset ALL your Kodi settings to default—but your add-ons and media library will remain intact. For a complete reset, see our guide on how to reset Kodi to default settings.

Fix: Delete or Rename guisettings.xml

1. Navigate to your userdata folder using the paths listed in Action 1.
2. Delete the guisettings.xml file, or rename it to something like guisettings_old.xml.
3. Restart Kodi.

Kodi will automatically generate a new guisettings.xml file with default settings, including the default Estuary skin. Your add-ons and media library remain intact—only your interface settings are reset.

Warning: This will reset all Kodi interface settings—menus, widgets, and other customizations—to factory default.

Action 3: Quick Fixes for Firestick and Android TV

Devices like Firesticks and Android TV boxes have additional quick options that don’t require accessing system files.

Fix 1: Clear the Kodi App Cache

Fire TV / Firestick:

1. From your Firestick home screen, go to Settings (gear icon)
2. Select Applications → Manage Installed Applications
3. Find and select Kodi
4. Choose Clear Cache (not “Clear Data”)
5. Restart Kodi

Android TV / Google TV:

1. Go to Settings → Apps & Notifications → See all apps
2. Find and select Kodi
3. Choose Storage & cache → Clear cache
4. Restart Kodi

Fix 2: Force Stop and Restart

Sometimes a simple force stop resolves the issue by clearing memory states.

Fire TV / Firestick:

1. Go to Settings → Applications → Manage Installed Applications → Kodi
2. Select Force Stop
3. Unplug your Firestick for 10 seconds and plug it back in to perform a full hardware reboot
4. Launch Kodi again.

Android TV / Google TV:

1. Go to Settings → Apps & Notifications → See all apps → Kodi
2. Select Force Stop
3. Press the Home button and relaunch Kodi

Action 4: Advanced Fix – Texture Maker Dependency Issues

Some modern skins rely on a dependency called “Texture Maker” to load images and backgrounds. If this dependency fails, you may see a black background or a “Texture Maker error” notification.

Fix: Check the Kodi Log for Errors

1. Enable debugging: Go to Settings → System Settings → Logging and enable debug logging.
2. Restart Kodi and replicate the black screen issue.
3. Locate your Kodi log file (kodi.log) in the same userdata folder.
4. Open the log and search for “Texture Maker” or “PIL module” errors. The PIL module is a known dependency that Texture Maker needs.
5. If you see these errors:

• Try updating Texture Maker from the Kodi repository (Add-ons → My add-ons → Add-on repository → Update)
• Temporarily switch to a skin that doesn’t require Texture Maker (e.g., default Estuary)
• Install the PIL module manually if available in your repository

Note: Texture Maker errors are documented in GitHub issue trackers and Kodi forums as a known cause of black screen issues on newer Kodi versions.

Best Backup Alternatives to Problematic Skins

If your preferred skin keeps crashing, these lightweight, stable alternatives are excellent fallbacks.

Summary & Prevention Tips

A black screen after changing your Kodi skin is fixable in minutes. The most reliable method is editing the guisettings.xml file to switch back to the default Estuary skin. If that fails, deleting the file forces Kodi to generate a fresh copy.

Quick Reference Summary

Prevention Tips

• Always check skin compatibility with your Kodi version before installing
• Backup your guisettings.xml file before changing skins. Consider using the Kodi Backup addon for full configuration backups.
• Install skins from the official Kodi repository whenever possible. See our list of best Kodi repositories.
• Shut down Kodi cleanly from the main menu rather than force-closing it to avoid file corruption
• Use lightweight skins on older devices to prevent resource-related crashes

What NOT to Do

Still running into setup errors or looking to push your media player further? Explore our complete, unrestricted library of blueprints.