How to Uninstall a Kodi Build and Start Fresh

If you want to remove a Kodi build completely, close Kodi, back up anything you want to keep, and reset Kodi’s data folder. Kodi has no universal “uninstall build” button because builds can change the skin, add-ons, repositories, sources, and profile settings. Moving the data folder aside lets Kodi create a clean one the next time it starts.

Kodi-style home screen with Movies, TV Shows, Music, Add-ons, and Settings in the left navigation.
A Kodi-style home screen with the Settings option in the left navigation.

What a Kodi reset removes

Kodi stores user changes in its data folder, including installed add-ons and skins, library databases, playlists, and settings. A full reset removes the build’s customizations along with your own Kodi preferences and library entries. It does not normally delete video or music files stored elsewhere on your device. If you manually saved media inside Kodi’s data folder, move those files first so they are not caught in the reset.

Back up what you want to keep

For a full rollback, copy the entire Kodi data folder to a different drive or location before changing it. Kodi’s backup guide explains that a full copy preserves the add-ons, skins, library databases, playlists, and settings. Restoring that full backup will also restore the build, so keep it only as a safety copy if your goal is a clean start.

If you mainly want to preserve video-library details, use Kodi’s library export and choose Separate Files. Kodi writes NFO metadata files alongside the media, which can be read again when you scan those folders after the reset. The video library export guide describes the options. Also note where your media folders and network shares are located; you will need to add those sources again.

A file manager copying the Kodi data folder, including addons and userdata, to a separate backup drive.
Copy the Kodi data folder to separate storage to keep a rollback option.

Find the Kodi data folder for your device

Use the path for your installation type. Kodi’s data-folder reference lists additional platforms and notes that Android paths can vary.

PlatformKodi data folder
Windows desktop installer%APPDATA%\Kodi
Windows Microsoft Store or Xbox%LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi
Windows portable<Kodi install folder>\portable_data
macOS~/Library/Application Support/Kodi
Linux~/.kodi
Linux Flatpak~/.var/app/tv.kodi.Kodi/data
Android and many TV devicesAndroid/data/org.xbmc.kodi/files/.kodi
LibreELEC / OSMC/storage/.kodi / /home/osmc/.kodi

Reset Kodi on Windows, macOS, or Linux

  1. Quit Kodi completely. Do not rename or remove its data folder while Kodi is running.
  2. Open the folder listed above. On Windows, press Win + R, enter %APPDATA%, and press Enter to find the desktop-installer folder. For the Store version, open its full path from the table in File Explorer. On macOS, use Finder’s Go > Go to Folder and enter the path. On Linux, show hidden files to see .kodi.
  3. Rename the Kodi data folder. Use a name such as Kodi-backup on Windows and macOS or .kodi-backup on Linux. Renaming is reversible and leaves the backup outside Kodi’s active folder name. For a portable Windows installation, rename portable_data in the Kodi installation location.
  4. Start Kodi again. Kodi will create a fresh data folder and open with its default setup. You do not need to uninstall the Kodi application itself just to remove a build. Kodi documents this clean-start method in its Windows installation guide.
Windows File Explorer at the Kodi AppData roaming folder with the Kodi data folder renamed Kodi-backup.
On Windows, rename the active Kodi folder in AppData to preserve it as a backup.
macOS Finder showing the Kodi folder renamed Kodi-backup under Application Support.
On macOS, the Kodi data folder is under Library/Application Support.
A Linux home folder with hidden files shown and the Kodi data directory renamed .kodi-backup.
On Linux, show hidden files to locate and rename the .kodi folder.

Reset Kodi on Android TV or Fire TV

  1. Stop Kodi from the device’s app settings. Then open Settings > Apps > Kodi > Storage or Storage & cache.
  2. Choose Clear data or Clear storage, then confirm. Menu names vary by device. Android Help says clearing storage permanently deletes an app’s data; Clear cache only deletes temporary data, so it will not reset the build.
  3. Open Kodi again and complete the first-run setup. If your device does not offer a clear-storage option, consult its app-management instructions or use the documented Kodi data-folder path if your file manager can access it. Android may restrict access to Android/data.

Android Help: clear an app’s cache and data

Android TV app storage settings for Kodi with the Clear data option highlighted above Clear cache.
Use the device’s Clear data or Clear storage option; clearing cache alone is not a reset.

Set Kodi up again without restoring the build

After the reset, the default-style home screen should appear without the old custom skin or add-ons. If the build is still there, Kodi may still be open or you may have renamed a different data folder; check the installation type and repeat with Kodi fully closed.

A fresh Kodi-style home screen with a default navigation menu and an empty movie library.
A fresh setup starts with an empty library until you add your media sources.

Add your local or network media folders again and scan them into the library. If you exported separate NFO files, Kodi can use them during its normal scan. Reinstall only the add-ons you still need from sources you trust; do not copy the entire old data folder back if you want to keep the build removed.

A Kodi-style Add video source dialog with a local Movies folder selected from the file list.
Re-add the folders that contain your media, then scan them into the clean library.

To undo the reset, quit Kodi, move its newly created data folder aside, and restore your saved folder under the original name. Kodi advises keeping a full-data restore on the same operating system and major Kodi version.

Leave a Comment

How to Uninstall Kodi Repositories the Right Way

How to Uninstall Kodi Repositories the Right Way

Learn how to uninstall a Kodi repository safely, remove its saved source URL separately, and check which installed add-ons or dependencies you still need.

Live Tennis on Kodi: Best Add-Ons and Legal Ways to Watch

Live Tennis on Kodi: Best Add-Ons and Legal Ways to Watch

Find the safest way to watch live tennis with Kodi: learn what iPlayer WWW can stream, how to find licensed coverage, and which add-ons to avoid.

How to Watch Movies on Kodi: A Complete Beginner’s Tutorial

How to Watch Movies on Kodi: A Complete Beginner’s Tutorial

Learn how to watch movies on Kodi from your computer, USB drive, or NAS, add online video services, and fix missing titles with clear setup steps.

How to Turn On Kodi Parental Controls and Lock a Kids’ Profile

How to Turn On Kodi Parental Controls and Lock a Kids’ Profile

Set a Kodi Master Lock PIN, protect selected menus, and create a separate kids’ profile with media sources you choose.

How to Watch Boxing PPV Streams on Kodi—Legally and Reliably

How to Watch Boxing PPV Streams on Kodi—Legally and Reliably

Find the authorized stream for your country, check whether its provider supports Kodi, and watch a boxing PPV on your TV without relying on outdated add-ons.

5 Best Kodi Skins and How to Change Kodi’s Look in Minutes

5 Best Kodi Skins and How to Change Kodi’s Look in Minutes

Compare five Kodi skins in the official Omega catalog, then follow the current Settings path to install one, customize it, or switch back.

1Channel Kodi Add-on: Can You Still Install It for Movies and TV Shows?

1Channel Kodi Add-on: Can You Still Install It for Movies and TV Shows?

Looking for the 1Channel Kodi add-on? Learn why old PrimeWire installation guides are unreliable and how to install a supported video add-on safely.

How to Control Kodi With the Web Interface, at Home or Away

How to Control Kodi With the Web Interface, at Home or Away

Enable Kodi’s Chorus2 web interface, control your media from any browser, and learn how to connect remotely without exposing Kodi to the Internet.

Nemesis Kodi Add-on: How to Install It and Check Availability

Nemesis Kodi Add-on: How to Install It and Check Availability

Follow the original Nemesis Kodi installation process, learn what changed with Stream Army, and avoid outdated repository and PIN instructions.

How to Download and Set Up Kodi on Windows

How to Download and Set Up Kodi on Windows

Download Kodi safely on Windows using the official installer or Microsoft Store, then add your media library and set up trusted add-ons.