⚠️ STATUS DISCLAIMER
Current App Status: 🟢 WORKING (Verified August 3, 2026)
Last Verified: August 3, 2026
Important Note: Kodi is a completely free and open-source media center application. The official version from Kodi.tv does not contain any content whatsoever—you must provide your own media or install third-party plugins for streaming capabilities.
🔒 Security Note: Kodi is notarized by Apple and is safe to install. However, macOS Gatekeeper may block it on first launch because it is distributed outside the Mac App Store. This is normal behavior—simply follow the override instructions below.
⚠️ Legal Disclaimer: Team Kodi does not endorse or approve the consumption of pirated content through third-party plugins.
What Is Kodi?
Kodi (formerly XBMC) is a free, open-source media center application that transforms your Mac into a powerful entertainment hub. Originally designed for the original Xbox, Kodi has evolved into one of the most versatile media players available today, supporting virtually every media format and running on almost every platform.
Key Features:
- 🎬 Universal Media Playback – Supports almost any video, audio, and image format
- 📁 Library Management – Organize your movies, TV shows, music, and photos
- 🎨 Customizable Interface – Thousands of skins to personalize your experience
- 🔌 Extensive Add-on Support – Thousands of plugins for streaming, utilities, and more
- 🌍 Cross-Platform – Runs on macOS, Windows, Linux, Android, iOS, and more
- 📱 Remote Control – Official Kodi remotes (Kore for Android, Official Kodi Remote for iOS)
- 🆓 100% Free – No subscriptions, no hidden costs
📋 “No-Click” Quick-Reference Cheatsheet
For experienced users—skip the reading and install now.
| Item | Details |
|---|---|
| Official Download URL | https://kodi.tv/download/ |
| Latest Stable Version | v21.3 “Omega” (December 2025) |
| Latest Development Version | v22.0 “Piers” Beta 1 (June 2026) |
| macOS Minimum Requirement | macOS 10.14 (Mojave) or higher |
| Architecture Support | Universal Binary – Intel x86_64 & Apple Silicon ARM64 |
| File Size | ~72 MB (ARM64) / ~84 MB (x86_64) |
| Installation Method | Drag-and-drop .dmg to Applications folder |
| Current Status | 🟢 Working |
| Last Verified | August 3, 2026 |
🟢 Kodi Status Report & Testing Log
| Metric | Status |
|---|---|
| Current Stable Version | v21.3 “Omega” |
| Current Development Version | v22.0 “Piers” Beta 1 |
| Stream Quality | Up to 4K (dependent on hardware and content source) |
| Tested Hardware | MacBook Pro M3 Pro (macOS 15), Mac Mini M2 (macOS 14), iMac Intel (macOS 13) |
| Ad-Free | ✅ Yes – completely ad-free |
| VPN Requirement | ⚠️ Recommended if using third-party streaming plugins |
| Notarization Status | ✅ Notarized by Apple (safe to install) |
| Play Store Availability | ❌ Not applicable – direct download only |
📥 Installation Tutorial: Kodi on macOS
Part 1: System Requirements & Prerequisites
Before installing, ensure your Mac meets these requirements:
| Requirement | Minimum |
|---|---|
| Operating System | macOS 10.14 (Mojave) or higher |
| Processor | Intel x86_64 or Apple Silicon (M1/M2/M3/M4) |
| RAM | 2 GB+ recommended |
| Storage | ~200 MB free space |
| Network | Internet connection for download |
Note: Kodi v20 and above requires an Intel Mac running macOS 10.13 or higher. For the best experience with v21 “Omega” and v22 “Piers,” macOS 10.14+ is recommended.
Part 2: Download Kodi
- Visit the Official Kodi Website
- Open your browser and go to:
https://kodi.tv/download/ - IMPORTANT: Only download from the official Kodi website or verified mirrors to avoid malware.
- Open your browser and go to:
- Select macOS Platform
- On the download page, click the macOS icon.
- The website will typically auto-detect your Mac’s architecture and offer the correct version.
- For Apple Silicon (M1/M2/M3/M4): Download the ARM64 version.
- For Intel Macs: Download the x86_64 version.
- Choose Your Version
- Stable Release (Recommended): Select the latest stable version (currently v21.3 “Omega”).
- Development Build (Advanced Users): If you want to test the latest features, you can download v22.0 “Piers” nightlies or betas.
- Download the .dmg File
- Click the download button. The file will be saved to your Downloads folder.
- File size: ~72 MB (ARM64) or ~84 MB (x86_64).
Part 3: Install Kodi
- Open the .dmg File
- Locate the downloaded
.dmgfile (e.g.,kodi-21.3-Omega-arm64.dmg) in your Downloads folder. - Double-click it to mount the disk image.
- Locate the downloaded
- Drag Kodi to Applications
- A window will appear showing the Kodi.app icon and a shortcut to the Applications folder.
- Drag the Kodi.app icon into the Applications folder shortcut.
- Wait for Copy to Complete
- The file will copy to your Applications folder. This may take a few seconds.
Part 4: Cleanup Phase
- Eject the Disk Image
- After the copy completes, click the eject button next to the mounted Kodi disk image in Finder, or drag it to the Trash.
- Delete the .dmg File (Optional)
- You can delete the downloaded
.dmgfile from your Downloads folder to free up space (~72–84 MB).
- You can delete the downloaded
Part 5: First Launch & Security Override
When you first launch Kodi, macOS Gatekeeper may block it with a warning: “Kodi cannot be opened because the developer cannot be verified.” This is normal behavior for apps distributed outside the Mac App Store.
To bypass this security warning:
- Open Finder and navigate to your Applications folder.
- Right-click (or Ctrl-click) on Kodi.app.
- Select “Open” from the context menu.
- In the dialog box that appears, click “Open”.
- Kodi will launch. After this, you can double-click Kodi normally to open it in the future.
Alternative Method: If you prefer, you can also go to System Settings > Privacy & Security and click “Open Anyway” under the Security section.
Part 6: Verify Native Architecture (Apple Silicon Users)
🔍 Quick Tip: If you’re migrating from an Intel Mac to an Apple Silicon Mac, you may want to verify that Kodi is running as a native ARM64 application rather than under Rosetta 2 emulation.
How to check:
- Launch Kodi and keep it running.
- Open Activity Monitor (found in
/Applications/Utilities/). - In the CPU tab, look for Kodi in the process list.
- Check the “Kind” column:
- “Apple” → Kodi is running natively on Apple Silicon (optimal performance).
- “Intel” → Kodi is running under Rosetta 2 emulation (slightly slower).
- If it shows “Intel,” you likely downloaded the wrong version. Download the ARM64 version from the Kodi website and reinstall.
🎮 Post-Installation UI/UX Walkthrough
Once you launch Kodi for the first time, here’s what to expect:
Home Screen
- Main Menu: The default skin (Estuary) displays a horizontal menu with categories: Movies, TV Shows, Music, Photos, Add-ons, and Settings.
- Recent Items: The home screen shows your recently added or played media.
Key Sections
| Section | What It Does |
|---|---|
| Movies | Add your movie library folders; Kodi will automatically scrape metadata (posters, plots, cast). |
| TV Shows | Add your TV show folders; Kodi organizes by season and episode with artwork. |
| Music | Add your music library; supports playlists, album art, and gapless playback. |
| Photos | Browse your photo collections. |
| Add-ons | Browse and install plugins for streaming, subtitles, weather, and more. |
| Settings | Configure Kodi’s appearance, playback, network, and system settings. |
First-Time Setup Tips
- Set Your Language: Go to Settings > Interface > Regional and select your language.
- Add Media Sources: Go to Settings > Media > Library and add folders containing your movies, TV shows, or music.
- Install Add-ons: Go to the Add-ons section and browse the official Kodi repository for thousands of free plugins.
- Enable Hardware Acceleration: Go to Settings > Player > Videos and ensure hardware decoding is enabled for smoother playback.
🔄 How to Update Kodi
Since Kodi is not available through the Mac App Store, updates must be done manually:
- Check for Updates: Visit the Kodi download page to see if a newer version is available.
- Download the New Version: Download the latest
.dmgfile. - Install Over the Old Version: Open the
.dmgand drag Kodi.app into the Applications folder. When prompted, click “Replace” to overwrite the existing version. - Keep Your Data: Your settings, library, and add-ons will be preserved because they are stored separately in
~/Library/Application Support/Kodi/.
Note: Development of the v20 “Nexus” line has ended. If you discover a bug in v20, test if it’s also present in v21 “Omega” and submit your report for v21.
🧰 Troubleshooting: How to Fix Common Kodi Errors
❌ “Kodi cannot be opened because the developer cannot be verified”
Solution: Right-click Kodi.app in your Applications folder and select “Open”, then click “Open” in the dialog box. Alternatively, go to System Settings > Privacy & Security and click “Open Anyway”.
❌ Kodi crashes on launch
Solution:
- Clear Kodi’s cache: Open Finder, press
Cmd+Shift+G, enter~/Library/Application Support/Kodi/, and delete thecachefolder. - If the issue persists, rename the
Kodifolder in~/Library/Application Support/toKodi_oldand relaunch Kodi to reset your configuration. - Ensure your macOS is updated to the latest version.
❌ No sound or audio issues
Solution:
- Go to Settings > System > Audio inside Kodi.
- Ensure the correct audio output device is selected.
- Try changing the Audio Output Device from “Default” to your specific built-in speakers or connected headphones/DAC.
- Check your Mac’s core system sound settings in macOS System Settings.
❌ Video playback is choppy or stuttering
Solution:
- Go to Settings > Player > Videos.
- Ensure “Allow hardware acceleration” is enabled.
- Try adjusting the “Render method” from “Auto detect” to a specific supported framework.
- Close heavy background applications to free up system memory and GPU resources.
❌ Kodi doesn’t detect my media files
Solution:
- Ensure your media directories are properly added via Settings > Media > Library.
- Click “Scan for new content” in the respective Movies or TV Shows category.
- Verify macOS file permissions allow Kodi read access to external drives or folders.
❌ Add-ons not working or failing to install
Solution:
- Check your active internet connection.
- Go to Settings > Add-ons and make sure “Unknown sources” is enabled if you are sideloading custom community plugins.
- Update Kodi to the latest stable release.
❌ Kodi is slow or laggy
Solution:
- Clear your application cache inside
~/Library/Application Support/Kodi/cache/. - Remove unused, resource-heavy third-party add-ons.
- Switch to a lighter UI skin like the default Estuary or Confluence.
❌ “Kodi is damaged and can’t be opened”
Solution: This usually indicates an incomplete or corrupted download. Re-download the fresh .dmg file directly from the official Kodi download page or their official mirrors.
❓ Frequently Asked Questions
Is Kodi free?
Yes. Kodi is 100% free and open-source software. There are no paid tiers, hidden subscriptions, or locked features.
Does Kodi come with movies or TV shows?
No. The official Kodi software package contains zero media content out of the box. You must supply your own local media files, stream from network attached storage (NAS), or install authorized plugins.
Is Kodi legal?
Yes. Kodi itself is entirely legal and open-source. However, third-party repositories or plugins that source unauthorized or pirated streams are not endorsed by Team Kodi, and users must abide by local copyright laws.
Why does macOS say Kodi can’t be opened?
This is a built-in macOS security feature called Gatekeeper, which flags applications downloaded outside the official Mac App Store. It is standard behavior and does not mean Kodi is unsafe.
Can I install Kodi on an Apple Silicon Mac (M1/M2/M3/M4)?
Yes. Kodi provides a fully native ARM64 build that runs natively with maximum performance and efficiency on all Apple Silicon processors.
What’s the difference between stable and development builds?
Stable releases (e.g., v21.3 “Omega”) are heavily tested and recommended for everyday use. Development builds (e.g., v22.0 “Piers” nightlies) showcase cutting-edge features but may introduce stability bugs.
How do I uninstall Kodi?
Drag Kodi.app from your Applications folder to the Trash. To completely wipe all local library data and settings caches, delete the configuration directory at ~/Library/Application Support/Kodi/.
Does Kodi support 4K playback?
Yes. Kodi fully supports 4K and HDR content playback, provided your Mac’s hardware decoder and connected display support high-resolution output.
Can I use a remote control with Kodi on macOS?
Yes. You can control Kodi using standard keyboard shortcuts, consumer IR remotes, or mobile applications like Kore (Android) and the Official Kodi Remote (iOS) connected via your local network.
✅ Conclusion
Installing Kodi on macOS is a straightforward process that takes just a few minutes. Whether you’re setting up a home media center, organizing your digital library, or exploring the world of Kodi add-ons, the official version from Kodi.tv is the safest and most reliable choice.
Remember these key points:
- ✅ Download only from
https://kodi.tv/download/ - ✅ Choose the correct version for your Mac (ARM64 for Apple Silicon, x86_64 for Intel)
- ✅ Drag Kodi.app to your Applications folder
- ✅ If Gatekeeper blocks it, right-click and select “Open”
- ✅ Verify native architecture in Activity Monitor (Apple Silicon users)
- ✅ Kodi is a media player, not a content provider—you bring your own media
- ✅ Keep Kodi updated by checking the official website regularly
- ✅ The latest stable version is v21.3 “Omega”
Happy streaming!
