Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run Scan×
Skip to content
VGSources
EmulationStation

How to Install Kodi on RetroPie

Use the current RetroPie-Setup kodi package to add Kodi as a Ports application, then troubleshoot compatibility, missing entries, graphics and controller issues.

By VGSources Team 6 min read

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Install Kodi on a supported RetroPie system through the current RetroPie-Setup package manager. Select the optional kodi package, choose its binary installation, then launch Kodi from EmulationStation → Ports → Kodi. Kodi runs as an application inside RetroPie; it does not replace RetroPie with a dedicated media-center operating system.

Before you begin

This procedure is aimed at a Raspberry Pi running the official RetroPie image or a supported Raspberry Pi OS-based RetroPie installation. The current RetroPie module also handles Ubuntu on x86, but it rejects unsupported operating-system and platform combinations. Mali-based platforms, OSMC and Xbian are among the environments excluded by the module (current Kodi module).

  • A working RetroPie installation and network connection
  • Enough free storage for Kodi, dependencies, thumbnails and media metadata
  • A reliable power supply and display connected to the Pi
  • A USB or wireless keyboard for first-run setup and troubleshooting
  • A backup of important ROM, BIOS and RetroPie configuration files

Update RetroPie-Setup before installing. Menu names vary slightly between releases, so look for the package named kodi rather than relying on an old screenshot. Kodi is optional; it is not included in a standard RetroPie installation. RetroPie’s first-installation requirements are documented in its official guide.

Install Kodi through RetroPie-Setup

  1. From EmulationStation, open RetroPie and select RetroPie Setup.
  2. Allow the setup script to update itself if an update is offered.
  3. Open Manage packages.
  4. Choose the optional packages or ports list.
  5. Select the package identified as kodi.
  6. Choose the binary install option when it is available. Binary installation avoids compiling Kodi on the Pi.
  7. Wait while dependencies, Kodi and available input-stream or joystick components are installed and configured. Do not interrupt the process.
  8. Exit RetroPie-Setup cleanly. If the new entry is not visible, restart EmulationStation or reboot the Pi.

The module chooses repositories according to the environment: older Raspberry Pi OS/Raspbian releases (Debian 10 or earlier) may receive the Pipplware repository, newer Raspberry Pi OS/Raspbian releases use packages pinned to Raspberry Pi Foundation origins, and Ubuntu x86 uses the Kodi team PPA. These are implementation details of the current script, not universal commands to add manually.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Retro Gaming Console 4K HDMI for TV, 20000 Games & 23 Emulators
  • MASSIVE 20,000 CLASSIC GAMES: Built-in 20,000 classic video retro stick with 4k hdmi, games and 23 emulators console for retro gaming, game emulators support arcade, tv game, video gaming nostalgia.
  • ULTRA 4K HD EXPERIENCE: Retro gaming console 4k hdmi video game, hdmi tv game console, retro gaming console for tv in classic white, 4k hd hdmi tv retro stick design for gaming and console nostalgia.
  • DUAL 2.4G WIRELESS CONTROLLERS: Wireless controllers for game console, 2.4g wireless tv game console with low-latency response, play video game console for tv with family, no tangled cables.
  • EASY PLUG & PLAY SETUP: Plug and play video games for tv via hdmi tv gaming console with 4k hdmi game experience, connect the retro game console to hd hdmi tv in seconds, ideal for all ages.
  • WHAT YOU GET: Retro wireless gaming console stick video retro stick built-in, console stick with 23 emulators, dual 2.4g controllers, hdmi cable, user guide, compact white retro stick for travel.

For a functioning existing RetroPie system, do not substitute a generic sudo apt-get install kodi command. The Kodi Wiki documents that command for Raspberry Pi OS installations, but RetroPie-Setup also handles its launcher, configuration layout and platform checks (Kodi Wiki).

Launch and exit Kodi

After configuration, open Ports in EmulationStation and select Kodi. The RetroPie module creates this entry with the kodi-standalone command, which is why Kodi appears as a port rather than a console system (module source).

Complete initial language, display, network and media-library setup with a keyboard if your gamepad is not recognized. To return to EmulationStation, use Kodi’s on-screen power menu and choose its exit option, or use the exit key/button configured for your Kodi installation. RetroArch hotkeys should not be assumed to work: RetroPie documents those shortcuts primarily for RetroArch/Libretro emulators, not every application.

Rank #2
Sale
Kulivloa Retro Gaming Console, 20k+ Classic Era Games, 23 Emulators
  • 【Core Highlights】80s & 90s Retro Home Console, Arcade & Handheld Games; 20,000+ Classic-Era Games in 1 Console; Plug & Play on TV – No Downloads or Installation; 1080P HDMI Output for Crisp Retro Gaming; Dual 2.4G; Wireless Controllers for Multiplayer Fun
  • 【Vast 20,000+ Preloaded Game Library & 23 Emulators】You can start enjoying nostalgic retro gaming right away. This retro gaming stick covers classic 80s–90s home console, arcade, and handheld titles. The library includes 10,000+ unique games, plus additional US, Japan, World, and Asia regional versions of many titles, bringing the total to 20,000+. It’s plug and play on your TV—no downloads or installation required. Great for retro gaming fans and kid- friendly for younger players
  • 【Impressive HD HDMI Output for Immersive Play】Play vibrant, stutter-free 1080P video games via HDMI cable. Connect effortlessly to any TV and enjoy crisp retro gaming experiences on this game console. Great choice for retro players wanting enhanced modern visuals
  • 【Dual 2.4G Wireless Controllers & Interactive Multiplayer Fun】Enjoy competitive and cooperative gaming sessions! Comes with two 2.4GHz wireless controllers offering responsive gameplay up to 40 feet away. Perfect for gatherings with this built-in game console
  • 【Simple Plug & Play Setup】Power the game stick, plug it into your TV, and switch HD channel to load the game list. Easy 3-step setup: connect HD output to TV, insert TF game card, and connect power adapter. Controllers require 4 AAA batteries. (Note: Charging adapter and batteries are not included.)

What version will install?

The official Kodi Raspberry Pi download page displayed stable Kodi 21.3 “Omega” on August 18, 2026 (Kodi download page). RetroPie does not hard-code that website version; it installs the compatible package supplied by the repositories selected for your operating system and release.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

If Kodi is missing from the package list

  1. Update RetroPie-Setup, then restart EmulationStation.
  2. Return to RetroPie Setup → Manage packages and check optional packages and ports for kodi.
  3. Confirm that the image is based on a supported Raspberry Pi OS/Raspbian release or Ubuntu x86.
  4. Check the setup-script log for the actual platform or repository error.

Third-party or heavily modified images can omit repositories or platform metadata required by the module. Do not copy an old Kodi launcher script as a first response; the current module contains the compatibility and repository logic that historical guides lack.

Fix common installation failures

“Kodi is not installable”

This can be a legitimate compatibility result. The module deliberately stops when the operating system or architecture does not match its supported cases. Do not force a foreign repository or install an old standalone .deb without accepting the risk of broken dependencies. Use a current supported RetroPie image, or choose LibreELEC if Kodi is the primary purpose.

Rank #3
HRYYDS 2026 Retro Gaming Console Pro, 4K HDMI Game Stick, 40,000+ Games
  • Retro game stick Pro – Plug & Play Fun: Enjoy endless gaming with 40,000+ pre-installed games and 23 emulators on a 64GB system—no downloads or setup required. Relive retro gaming nostalgia instantly with a simple plug-and-play experience
  • Stable 2.4GHz Wireless Controllers – Zero Lag, Up to 40ft Range: Experience smooth, uninterrupted gameplay with advanced 2.4GHz wireless technology. The ergonomic controllers provide a comfortable grip, ultra-responsive buttons, and a stable connection up to 40 feet—perfect for solo or multiplayer gaming
  • Stunning 1080P & 4K HDMI Output – Extended Cable Included: Immerse yourself in crystal-clear visuals with 1080P and 4K output support. The HDMI interface ensures seamless connection to TVs, projectors, PCs, and set-top boxes—bringing your favorite classics to the big screen
  • Save & Load Game Progress – Play Without Limits: Never lose your progress! Our retro gaming console supports game saving and loading, allowing you to pick up right where you left off. Say goodbye to frustrating restarts and enjoy a smooth gaming experience
  • The Perfect Gift for All Ages – Fun for Family & Friends: A great holiday or birthday gift for parents, kids, couples, and gaming enthusiasts! Whether for weekend fun, family bonding, or travel, this console delivers endless entertainment. Plus, we offer reliable customer support to ensure a worry-free experience

Dependency or repository errors on an old image

Older RetroPie images may point to retired Debian/Raspberry Pi OS repositories, while current Kodi packages require newer libraries. Updating the underlying OS can affect emulators and configurations, so back up first. For the least disruptive solution, install a current RetroPie image on a separate card or use a separate LibreELEC card rather than mixing unmaintained Kodi 17/18 instructions into the old system.

Kodi installed but no Ports entry appears

  1. Exit RetroPie-Setup and restart EmulationStation.
  2. Verify that installation and configuration completed without errors.
  3. Check the Ports category again.
  4. Re-run package configuration through RetroPie-Setup if offered.

The module’s configuration function creates the Kodi port, so a missing entry usually indicates incomplete configuration or stale EmulationStation state. Manual edits to es_systems.cfg should be an advanced recovery step, not the normal installation method.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Black screen or immediate exit

  • Reboot with the display connected and retry.
  • Check the RetroPie-Setup log for graphics or dependency errors.
  • Confirm that the image uses a supported graphics stack and operating-system release.
  • As an advanced diagnostic, test Kodi from a terminal, but do not replace the module’s kodi-standalone launcher casually.

If the Pi is intended mainly for media playback, a dedicated Kodi distribution is often the more reliable architecture.

Rank #4
Retro Gaming Console Stick Video Games, Stick Built-in 23 Emulators Console Projector, 40000+ Game System with 4K HDMI, Plug and Play TV Video Game Stick with Controllers - White
  • The YEBGMS Retro Gaming Console Stick isn't just a device — it's a time machine. Designed for gamers who remember the thrill of inserting a cartridge and for newcomers eager to discover where it all began, this sleek little stick packs decades of gaming history into one seamless experience
  • With over 43,000 games and 28 emulators built right in, you'll never run out of adventures. From pixel-perfect platformers to button-mashing fighting games, every classic you loved is waiting for you — all at your fingertips
  • Old games deserve new glory. Our 4K HDMI upscaling transforms vintage visuals into sharp, vibrant masterpieces on your big-screen TV. The pixels you remember have never looked this good
  • Two wireless controllers mean you're always ready for company. Challenge a friend, team up with family, or enjoy a solo journey — the choice is yours. And when you're done, the compact design tucks away effortlessly until your next session
  • Zero setup. Zero downloads. Zero subscriptions. Plug in, power on, and let the good times roll. Whether you're 8 or 80, the magic of retro gaming is just an HDMI connection awa

Controller input does not work

Use a USB keyboard to finish setup, reconnect or pair the controller after Kodi starts, and configure input in Kodi separately from RetroArch. A small keyboard or media remote is often more practical than a gamepad for text entry and library management.

Add-ons or streaming services fail

Installing Kodi does not provide paid subscriptions, DRM licenses or guaranteed support for any streaming provider. Use official Kodi repository add-ons where available, and check each service’s own legal and hardware requirements. Avoid unofficial piracy add-ons.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

RetroPie Kodi or LibreELEC?

These options solve different problems. RetroPie remains a gaming-focused operating environment and launches Kodi as one optional port. LibreELEC is a complete, Kodi-focused appliance distribution; its Raspberry Pi page currently lists LibreELEC 12.2 with Kodi 21.3 images for Raspberry Pi 5, Raspberry Pi 4/400/CM4 and older models (LibreELEC downloads).

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Best Value
Retro Gaming Console with 50,000 Video Games, 48 Emulators,128GB Storage
  • 【50,000+ RETRO GAMES】Enjoy 50,000+ classic games with 48 built-in emulators and a 128GB TF card. This retro gaming console brings a wide variety of nostalgic games to your TV for hours of entertainment.
  • 【4K HDMI OUTPUT】Connect the retro gaming stick to your TV via HDMI and enjoy clear 4K output with smooth gameplay and low latency. Its compact design makes it easy to set up and use at home.
  • 【DUAL 2.4GHz WIRELESS CONTROLLERS】Includes two 2.4GHz wireless controllers for multiplayer gaming. Play classic games with family and friends and enjoy a fun, nostalgic gaming experience together.
  • 【PLUG & PLAY SETUP】Simply connect the console to your TV via HDMI, insert the TF card, connect the included power adapter, and switch your TV to the corresponding HDMI input. The two controllers require 4 AAA batteries, not included.
  • 【GREAT GIFT】A fun gift for adults and retro game lovers, perfect for family gatherings, parties, or relaxing at home. Enjoy classic gaming with family and friends or take the compact console with you while traveling.
Your priority Better fit
Mostly retro games with occasional movies or music Kodi inside RetroPie
Mostly movies, television and music LibreELEC
General-purpose Linux plus Kodi Raspberry Pi OS plus Kodi
Maximum separation and reliability Separate RetroPie and LibreELEC microSD cards

Use Raspberry Pi OS’s direct sudo apt-get update and sudo apt-get install kodi route when RetroPie is not part of the system. On an existing RetroPie installation, the RetroPie-Setup module is preferable because it integrates the port and applies platform-specific repository handling.

Does installing Kodi affect your games?

A normal optional-package installation adds Kodi and its launcher; it does not intentionally delete ROMs or emulator settings. Nevertheless, package and operating-system changes can expose problems on damaged or very old images, which is why a backup is prudent before installation.

Frequently Asked Questions

Can Kodi run on every Raspberry Pi RetroPie image?

No. Availability depends on the operating system, architecture, repositories and graphics stack recognized by the current RetroPie-Setup module. Unsupported images can correctly report that Kodi is not installable.

Can I use a Raspberry Pi 5?

Official Kodi and LibreELEC provide Raspberry Pi 5 support, but successful installation still depends on the RetroPie image and its package repositories. Raspberry Pi 5 support is not a guarantee for every third-party image.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Can RetroPie and LibreELEC be dual-booted?

Yes, with a supported multiboot arrangement, or more simply by keeping each operating system on its own microSD card.

Is Kodi free?

Kodi, RetroPie, RetroPie-Setup and LibreELEC are free and open-source software. Hardware, subscriptions and some streaming services are separate costs.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from Patch Notes

Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.