⚠️ STATUS DISCLAIMER
Current Stable Version: 🟢 Kodi 21.3 “Omega” (Released December 14, 2025)
Next Major Release: 🔵 Kodi 22 “Piers” Beta 1 (Released June 28, 2026)
🔄 Maintenance Note: This guide is verified for Kodi 21.3 Omega. Once Kodi 22 “Piers” transitions from Beta to Stable, the Quick-Reference Cheatsheet and Status Disclaimers above will be refreshed. Always check kodi.tv for the latest stable version before proceeding.
Last Verified: July 30, 2026
⚠️ CRITICAL NOTE: Kodi does not have a built-in “one-click update” button inside the app. Updates must be performed manually by downloading the new version and installing it over your existing installation. Always back up your userdata folder before updating to protect your add-ons, settings, and media library.
🔥 What’s New in 2026:
- Kodi 21.3 “Omega” brings HDR support to Xbox One, improved Blu-ray playback on Linux, faster video library rescans, and numerous bug fixes
- Kodi 22 “Piers” (currently in Beta) introduces FFmpeg 8.1.2, full HDR support on Embedded Linux, major rendering rewrite, 12-bit decoding, and advanced hardware decoding
📋 “No-Click” Quick-Reference Cheatsheet
For experienced users—skip the reading and update now.
| Platform | Current Version | Status | Update Method | Download Link |
|---|---|---|---|---|
| Windows | 21.3 Omega | 🟢 Stable | Manual installer / Windows Store / Windows Installer add-on | kodi.tv/download |
| macOS | 21.3 Omega | 🟢 Stable | Download DMG → Replace in Applications | kodi.tv/download |
| Linux (Ubuntu/Debian) | 21.3 Omega | 🟢 Stable | sudo apt update && sudo apt upgrade | Official PPA: ppa:team-xbmc/ppa |
| Android (Play Store) | 21.3 Omega | 🟢 Stable | Google Play → My Apps → Update | Google Play Store |
| Android (APK/Sideload) | 21.3 Omega | 🟢 Stable | Download APK → Install over existing | kodi.tv/download |
| Firestick / Fire TV | 21.3 Omega | 🟢 Stable | Downloader app → Sideload APK | Code: 250931 |
| Xbox One / Series X|S | 21.3 Omega | 🟢 Stable | My Games & Apps → Updates | Microsoft Store |
| Android TV / Google TV | 21.3 Omega | 🟢 Stable | Google Play → Update | Google Play Store |
| NVIDIA Shield TV | 21.3 Omega | 🟢 Stable | Google Play → Update | Google Play Store |
| Raspberry Pi (LibreELEC) | 21.3 Omega | 🟢 Stable | Settings → LibreELEC → Updates | LibreELEC auto-update |
| iOS / tvOS | 21.3 Omega | 🟡 Complex | Sideload IPA via AltStore/Cydia Impactor | kodi.tv/download |
| Kodi 22 “Piers” (Beta) | 22.0 Beta 1 | 🔵 Beta | Manual download (testing only) | kodi.tv/download |
What Is Kodi and Why Update?
Kodi is an award-winning, free, and open-source media player and entertainment hub that can be installed on virtually any device—Windows, macOS, Linux, Android, iOS, tvOS, Fire TV, Xbox, and more. It transforms your device into a powerful home theater system capable of playing local media, streaming online content, and running thousands of add-ons.
Why you should update Kodi:
- 🔒 Security patches – Protect against vulnerabilities
- 🐛 Bug fixes – Smoother playback, fewer crashes
- ✨ New features – HDR support, better codec compatibility, improved performance
- 📦 Add-on compatibility – Latest add-ons require newer Kodi versions
Target Audience: This guide is for all Kodi users—from beginners who installed Kodi once and forgot about it, to power users running complex builds with dozens of add-ons.
🔥 2026 Evolution: What’s New in Kodi
Kodi 21.3 “Omega” (Stable – December 2025)
The latest stable release brings significant improvements:
| Category | Improvements |
|---|---|
| Video | ✅ Added HDR support on Xbox One ✅ Fixed Blu-ray playback on Linux ✅ Fixed audio/subtitle issues when resuming Blu-rays ✅ Fixed handling of HDR10 light metadata changes |
| Library | ✅ Improved speed of video library rescans ✅ Fixed multi-episode files overwriting the first episode |
| Network | ✅ Added support for HTTP Basic Authentication ✅ Updated CA certificates to 2025-07-15 |
| Add-ons | ✅ Fixed updating add-ons after 25 days of inactivity (extended to ~68 years) |
| Audio | ✅ Fixed rare Pipewire crash when connecting/removing audio devices |
Kodi 22 “Piers” (Beta 1 – June 2026)
The next major release is now in Beta and introduces groundbreaking changes:
- FFmpeg 8.1.2 – Improved video processing with real-time bitrate info labels
- Full HDR support on Embedded Linux – From decoding to output, with 12-bit decoding
- Major rendering rewrite – Advanced hardware decoding and new dithering/scaling options for GLES
- Improved chapter controls – Better handling of chapters read by FFmpeg
- AV1 playback fixes – Fixed AV1 playback with keyframe-filtering=2
- Enhanced CEC handling – Improved HDMI-CEC device control
- MySQL/MariaDB compatibility – Fixed incompatibility with MySQL 9.6+ and MariaDB 10.x
⚠️ Beta Warning: Kodi 22 “Piers” is pre-release software. Do not install on your primary media center unless you’re comfortable with bugs and broken add-ons. Test on a secondary device and always back up first.
📝 Before You Update: Backup Your Kodi Data
This is the most important step. Updating Kodi is usually safe, but things can go wrong. Protect your add-ons, settings, skin, and media library by backing up.
How to back up:
- Manual backup: Copy your
userdatafolder to a safe location
- Windows:
%APPDATA%\Kodi\userdata - macOS:
~/Library/Application Support/Kodi/userdata - Linux:
~/.kodi/userdata - Android:
Android/data/org.xbmc.kodi/files/.kodi/userdata
- Using a maintenance add-on: Install EZ Maintenance+ or Open Wizard for one-click backups
💻 How to Update Kodi on Windows
Windows offers three methods to update Kodi.
Method 1: Manual Installation (Recommended)
- Visit the official Kodi website: kodi.tv/download
- Click the Windows platform button
- Choose INSTALLER (64 BIT) for 64-bit Windows, or INSTALLER (32 BIT) for 32-bit Windows
- Run the downloaded installer
- Follow the on-screen instructions – the installer will automatically overwrite your existing Kodi installation while preserving your data
Method 2: Windows Store (Windows 10/11)
- Open the Microsoft Store application
- Click the app menu icon (top-right corner)
- Select Downloads and Updates → Get updates
- If an update is available for Kodi, it will download and install automatically
Method 3: Windows Installer Add-on (In-App)
- Open Kodi and navigate to Add-ons
- Search for “Windows Installer” in the add-on browser
- Install the add-on and run it to download and install the latest version
🍎 How to Update Kodi on macOS
Updating Kodi on macOS requires reinstalling the application.
- Visit the official Kodi website: kodi.tv/download
- Click the macOS platform button
- Download the INSTALLER (64 BIT) in DMG format
- Double-click the downloaded DMG file to mount it
- Drag the Kodi icon to the Applications folder
- When prompted, click “Replace” to update the existing application
For Apple Silicon (M1/M2/M3/M4) Macs: Download the appropriate ARM64 build from the official download page.
🐧 How to Update Kodi on Linux
Ubuntu / Debian (Using Official PPA)
The easiest way is through the official Team Kodi PPA:
- Open a terminal (
Ctrl + Alt + T) - Add the official Kodi PPA (if not already added):
sudo add-apt-repository ppa:team-xbmc/ppa
- Update your package list:
sudo apt update
- Upgrade all packages (including Kodi):
sudo apt upgrade
Or update only Kodi:
sudo apt install --only-upgrade kodi
Using Snap (Alternative)
Kodi is also available as a Snap package:
sudo snap refresh kodi-omega
Note: If you encounter issues, you can also use
sudo apt-get dist-upgradeto ensure all dependencies are updated.
📱 How to Update Kodi on Android
Method 1: Google Play Store (Easiest)
- Open the Google Play Store
- Tap the menu icon (top-left) → My Apps & Games
- Find Kodi in the list
- If an update is available, tap “Update”
- To update all apps at once, tap “Update all”
The Play Store version requires Android 5.0 (Lollipop) or newer.
Method 2: Manual APK Update (Sideload)
If you originally installed Kodi via APK (common on some TV boxes):
- Visit kodi.tv/download on your device’s browser
- Select the Android platform
- Download the appropriate APK (32-bit or 64-bit)
- Open the downloaded APK file
- Tap “Install” – the system will update the existing installation
Architecture tip: Most Android TV boxes are 32-bit. If unsure, install the 32-bit version.
🔥 How to Update Kodi on Firestick / Fire TV
Kodi is not available in the Amazon Appstore, so updates must be done manually via sideloading.
Step 1: Check Your Current Version
- Launch Kodi
- Go to Settings (gear icon)
- Select System Information
- Note your current version number
Step 2: Enable Unknown Sources
- From the Firestick home screen, go to Settings (gear icon)
- Select My Fire TV
- Click About
- Click on Fire TV Stick 7 times to enable Developer Options
- Go back → Developer Options → Install Unknown Apps
- Turn ON for the Downloader app
Step 3: Update Using Downloader
- Install the Downloader app from the Amazon Appstore (if not already installed)
- Launch Downloader
- Enter the URL or code:
- Code:
250931 - Or direct URL:
https://kodi.tv/download
- Navigate to the Android platform and download the latest Kodi APK
- When download completes, tap “Install”
- Tap “Done” → “Delete” to remove the APK and free up space
Step 4: Verify the Update
- Launch Kodi from your home screen or Apps menu
- Wait a few seconds for Kodi to prepare on first run
- Go to Settings → System Information to confirm the new version
Alternative: Use AppStarter for one-click auto-updates when new versions are released.
🎮 How to Update Kodi on Xbox One / Series X|S
Xbox consoles automatically update apps by default. If auto-updates are disabled:
- Press the Xbox button on your controller
- Select My Games & Apps
- Select Updates on the left side of the screen
- If Kodi has a pending update, download and install it
To enable auto-updates: Go to Settings → System → Updates and configure automatic downloads.
New in Kodi 21.3: Added HDR support on Xbox One – enjoy more vibrant picture quality.
📺 How to Update Kodi on Android TV / Google TV
Method 1: Google Play Store (Recommended)
- From the Android TV home screen, open the Google Play Store
- Navigate to My Apps (left side menu)
- Find Kodi in the list
- If an update is available, select Kodi and tap “Update”
The Play Store version for Android TV is the full stable release (21.3 Omega as of July 2026).
Method 2: Manual APK Update
If you installed Kodi via sideloading:
- Use the Downloader app or a browser to visit kodi.tv/download
- Download the Android APK
- Open the APK and tap “Install” to update
🖥️ How to Update Kodi on NVIDIA Shield TV
The NVIDIA Shield TV runs Android TV, so the update process is identical:
- From the Shield home screen, select Apps at the top
- Open the Google Play Store
- Go to My Apps & Games
- Find Kodi and tap “Update” if available
Note: NVIDIA Shield TV receives regular system updates (latest: 9.21.4 as of May 2026) that improve stability and performance.
🥧 How to Update Kodi on Raspberry Pi (LibreELEC)
Raspberry Pi users typically run Kodi through LibreELEC – a lightweight Linux distribution designed specifically for Kodi.
Automatic Update (Recommended)
- Go to Settings → LibreELEC
- Select System → Updates
- Choose Update Channel → Main version
- Select Available Versions and choose the latest version
- Confirm the update
Current LibreELEC version: 12.0.2 (includes Kodi Omega 21.2).
Manual Update (Alternative)
- Download the latest LibreELEC image from the official website
- Write the image to your SD card using Raspberry Pi Imager
- Boot your Pi with the new SD card
For Raspberry Pi 5: LibreELEC is currently the best option.
📱 How to Update Kodi on iOS / tvOS (Apple TV)
Updating Kodi on iOS and tvOS is the most complex process because Kodi is not available on the App Store.
Method 1: Using AltStore (Recommended)
- Download the latest Kodi IPA file from kodi.tv/download
- Install AltStore on your computer
- Connect your iOS/tvOS device to your computer
- Use AltStore to sideload the IPA onto your device
- You’ll need to refresh the certificate periodically to keep Kodi working
Method 2: Using Cydia Impactor
- Download the latest Kodi IPA file
- Download Cydia Impactor on your computer
- Connect your device via USB
- Drag the IPA file into Cydia Impactor
- Enter your Apple ID credentials to sign the app
Method 3: Using Xcode (Advanced)
- Download the Kodi source code or IPA
- Use Xcode to build and sign the app
- Deploy to your Apple TV using Devices and Simulators
Important: Apple frequently revokes certificates. You may need to re-sideload Kodi every 7 days (free Apple ID) or use a paid developer account for longer validity.
🔧 Troubleshooting: Common Kodi Update Errors
| Issue | Solution |
|---|---|
| “App not installed” error | Insufficient storage – free up space and retry. Corrupt APK – re-download from official source. |
| Update not showing in Play Store | Clear Google Play cache: Settings → Apps → Google Play Store → Storage → Clear Cache. Wait 24-48 hours – updates roll out gradually. |
| Add-ons broken after update | Check if add-ons have updates available. Some older add-ons may not be compatible with newer Kodi versions (Python 2 → Python 3 migration). |
| Kodi crashes on launch | Clear Kodi cache: Settings → Applications → Manage Installed Applications → Kodi → Clear Cache. If persists, uninstall and reinstall (back up first!). |
| Firestick “Install Unknown Apps” grayed out | On newer Fire OS devices, you must enable developer options first (click “About” → “Fire TV Stick” 7 times). |
| Downloader code not working | Codes change. Use direct URL: https://kodi.tv/download or search for updated codes. |
| “Parsing Package” error on Android | You downloaded the wrong architecture (32-bit vs 64-bit). Download the correct version. |
| macOS “Kodi can’t be opened” warning | Go to System Settings → Privacy & Security and click “Open Anyway”. |
| Xbox Store only shows older version | Microsoft Store updates roll out gradually. Uninstall and reinstall Kodi from the Store. |
❓ Frequently Asked Questions (FAQ)
Frequently Asked Questions
Does Kodi have a built-in update button?
No. Kodi does not have a “Check for Updates” or “Update Now” button inside the app. All updates must be performed manually by downloading the new version and installing it over your existing installation.
Will updating Kodi delete my add-ons and settings?
Usually not. When you install a new version over an existing one, your userdata folder (containing add-ons, settings, and library) is preserved. However, always back up your userdata folder before updating – especially for major version upgrades (e.g., 21.x → 22.x).
What’s the difference between Kodi 21.3 Omega and Kodi 22 Piers?
Kodi 21.3 “Omega” is the current stable release – recommended for everyday use. Kodi 22 “Piers” is in Beta – it includes major new features (FFmpeg 8.1.2, HDR on Linux, rendering rewrite) but may have bugs and broken add-ons.
How do I check my current Kodi version?
Open Kodi → Settings (gear icon) → System Information. Your version will be displayed under “Version info: Build”.
Can I downgrade Kodi if I don’t like the new version?
Yes, but it requires a clean installation. Uninstall the new version, then install the older version from the official Kodi website. Restoring a backup is highly recommended to recover your settings and add-ons.
Why isn’t Kodi updating automatically on my Firestick?
Kodi is not available in the Amazon Appstore, so it cannot update automatically. You must manually sideload each new version using Downloader or AppStarter.
Is Kodi 22 Piers safe to install?
Kodi 22 “Piers” Beta 1 is pre-release software. It’s safe to test on a secondary device, but not recommended for your primary media center due to potential bugs and add-on compatibility issues. Always back up before installing.
How often does Kodi release new versions?
Kodi releases point releases (e.g., 21.1, 21.2, 21.3) regularly with bug fixes. Major releases (e.g., 21.x → 22.x) typically happen every 1–2 years.
🔒 Safety & VPN Recommendation
Why you should use a VPN with Kodi:
- 🛡️ Privacy: Your ISP can see all your online activity. A VPN encrypts your connection.
- 🔓 Bypass geo-restrictions: Access content that may be blocked in your region.
- 🚫 Prevent throttling: ISPs sometimes slow down streaming traffic. A VPN prevents this.
- ✅ Protection while sideloading: When downloading APKs from third-party sources, a VPN adds an extra layer of security.
Recommended VPN for Kodi users: Surfshark – unlimited device connections, strong encryption, and a 30-day money-back guarantee.
✅ Conclusion
Updating Kodi doesn’t have to be complicated. While Kodi lacks a built-in update button, the process is straightforward on most platforms:
| Platform | Easiest Method |
|---|---|
| Windows / macOS / Linux | Download from kodi.tv and install over existing |
| Android / Android TV / NVIDIA Shield | Google Play Store → Update |
| Firestick / Fire TV | Sideload via Downloader (code: 250931) |
| Xbox | Microsoft Store → Updates |
| Raspberry Pi (LibreELEC) | Settings → LibreELEC → Updates |
| iOS / tvOS | Sideload IPA via AltStore (complex) |
Key takeaways for 2026:
- ✅ Current stable version: Kodi 21.3 “Omega” (December 2025)
- 🔵 Next major release: Kodi 22 “Piers” Beta 1 (June 2026)
- 🔥 Major new features: HDR on Xbox (21.3), FFmpeg 8.1.2 and HDR on Linux (22.0)
- 🛡️ Always back up your userdata before updating
- 🔒 Use a VPN for privacy and security while streaming
Remember: If you’re using a stable setup, stick with Kodi 21.3 Omega. Only install Kodi 22 “Piers” if you’re comfortable with beta software and want to test the latest features.
Stream smart, stay updated, and enjoy your media!





