Cuando Kodi no funciona, la causa casi siempre está en tres sitios: una instalación dañada, la configuración del reproductor o una biblioteca mal nombrada. Hoy te explicaremos cómo distinguir esos tres casos y qué hacer en cada uno, siempre desde el canal oficial. Los fallos que vienen de addons de terceros no entran aquí, y te contamos por qué.

Qué vamos a arreglar aquí y qué no

Kodi es un reproductor multimedia libre mantenido por la Kodi Foundation, y su web es el sitio desde el que se descarga. Eso es legítimo. Lo que Kodi no trae es contenido: su página de descarga avisa de que la versión oficial no incluye ninguno y de que lo pones tú. Nos centraremos por tanto en el reproductor y en tu biblioteca propia; cuando el fallo viene de un complemento ajeno al repositorio oficial, la respuesta es otra y la damos en el último apartado. Aviso previo: varias de las acciones que veremos borran configuración, así que copia tu carpeta de datos antes de tocarla.

Ficha rápida: síntoma, causa probable y qué hacer

Localiza tu síntoma antes de meterte en ajustes. Te ahorrará probar cosas al azar, que es lo que suele acabar rompiendo una instalación que funcionaba.

Kodi no abre, se cierra solo o se queda en la pantalla de carga

Es el grupo más frecuente y el más fácil de acotar. Te daremos tres opciones, de menos a más agresiva.

Reinstala desde el canal oficial

Una instalación a medias, un corte de luz durante una actualización o un antivirus que borró un fichero dejan a Kodi sin arrancar. Descarga de nuevo el instalador desde kodi.tv y ponlo encima. Verás siempre dos ramas, la estable y la de prelanzamiento: coge la estable, porque la otra contiene fallos conocidos.

En Android hay un matiz. El equipo explicó en la nota de la versión 21.3, del 16 de diciembre de 2025, que no pudieron subirla a Google Play porque Google exige ahora soporte de páginas de memoria de 16 KB en dispositivos de 64 bits. Si tu televisor o tu móvil sigue en 21.2, no es un fallo tuyo: comprueba la página de descarga oficial para Android antes de darte por desactualizado.

Cuando el problema es el perfil

Si el programa se abre y se cierra sin mensaje, o se queda clavado en el logotipo, suele haber una base de datos corrupta en tu carpeta de datos. La prueba definitiva es renombrarla: Kodi crea una nueva y limpia al arrancar, y si con eso funciona, el fallo estaba ahí. Cuidado, porque es la operación que más disgustos da: pierdes fuentes, ajustes y el estado de la biblioteca. Copia la carpeta a otro sitio antes, nunca la borres. Estas son las rutas correctas según la documentación oficial:

• Windows: C:\Users\TuUsuario\AppData\Roaming\Kodi
• Android: Android/data/org.xbmc.kodi/files/.kodi
• macOS: /Users/TuUsuario/Library/Application Support/Kodi
• Linux: ~/.kodi
• iOS y tvOS: /private/var/mobile/Library/Preferences/Kodi
• LibreELEC: /storage/.kodi

Si has visto otras rutas por ahí, desconfía. Circula desde hace años la idea de que en Windows los datos están dentro de Archivos de Programa, y no es cierto: viven en AppData.

Lee el registro antes de seguir

Kodi guarda un registro de cada sesión, kodi.log, y al arrancar de nuevo el anterior pasa a llamarse kodi.old.log. Solo existen esos dos, así que si has reabierto el programa dos veces, el registro del fallo ya se ha perdido. Para que sirva, activa el registro de depuración en los ajustes del sistema con el nivel en modo experto, reproduce el fallo y busca las líneas marcadas como ERROR. Ese texto es lo que puedes llevar al foro oficial: las capturas no valen, allí te pedirán el registro.

El vídeo va a tirones o el audio se desincroniza

Aquí Kodi funciona, pero reproduce mal. Son problemas de negociación entre el programa, el sistema y la pantalla, y se resuelven con ajustes, no reinstalando.

Ajusta la frecuencia de refresco

Es la causa número uno del vídeo entrecortado y la que menos gente revisa. Una película a 24 fotogramas por segundo en una pantalla fija a 60 Hz produce un tirón periódico, muy visible en las panorámicas lentas. En los ajustes del reproductor, sección de vídeo, activa la opción de ajustar la frecuencia de refresco al empezar y al parar la reproducción, y prueba el mismo fichero.

Revisa la aceleración por hardware

La aceleración descarga la decodificación en la tarjeta gráfica y casi siempre conviene tenerla activa. El problema surge cuando el aparato dice soportar un formato que no maneja bien: el vídeo se pixela, se congela o sale en negro con sonido. El nombre del ajuste cambia según el sistema, y eso explica que las guías genéricas confundan tanto: en Windows verás opciones tipo DXVA2, en Linux VAAPI o VDPAU, y en Android la decodificación por MediaCodec. Están en los ajustes del reproductor, en vídeo, con el nivel experto activado. Desactívalas de una en una y prueba tras cada cambio.

Corrige el desfase de audio

Si la voz va por delante o por detrás de la imagen, no toques los ajustes generales. Durante la reproducción, abre el menú de audio y usa el control de desfase, que Kodi puede recordar para después. Si el desfase solo aparece con la barra de sonido conectada, el culpable suele ser el procesado de ese equipo y no Kodi.

Si lo que va lento es la interfaz

En aparatos modestos, un televisor Android de gama baja o una Raspberry Pi antigua, la interfaz puede ir a trompicones aunque el vídeo se vea perfecto. Son cosas distintas. Baja la resolución de la interfaz en los ajustes de pantalla y desactiva, en la configuración de la skin, las animaciones de desplazamiento.

Sobre vaciar la caché conviene ser claros, porque es el consejo más repetido y más inútil de internet. La carpeta se limpia sola: la documentación oficial indica unas 3 horas de retención en la caché de Python y 24 horas o más en la de los scrapers.

La biblioteca propia no se escanea o mezcla los títulos

Aquí Kodi da su mejor versión y también donde más gente se rinde. Tu biblioteca son tus ficheros, y Kodi los identifica leyendo el nombre. Si el nombre está mal, tendrás una carpeta vacía o una película con la carátula equivocada.

El nombre manda

La convención oficial es corta y no admite improvisación:

• Películas: «Título de la película (Año)», tanto en la carpeta como en el fichero. El año diferencia el original del remake.
• Series: una carpeta por serie con el formato «Nombre de la serie (Año)» y, dentro, una carpeta por temporada.
• Episodios: el patrón S01E01 es el más fiable de todos los que Kodi reconoce.
• Series repartidas en dos discos: el nombre de la carpeta debe ser idéntico en ambos sitios, o Kodi las tratará como series distintas.

Desde Kodi 21 «Omega» hay una vía más precisa: incluir el identificador del catálogo en el nombre. Un fichero llamado Blade Runner (2017) {tmdb=335984}.mkv le dice a Kodi qué ficha buscar sin adivinar por título, y lo admiten los scrapers oficiales de TheMovieDB, TMDb TV Shows y TVmaze. Si tu colección está desordenada, empieza por organizar tus series y películas antes de escanear.

Los scrapers de metadatos

Los scrapers descargan carátulas y sinopsis. Vienen con Kodi y no hay que instalar nada externo; el de TheMovieDB es el que trae por defecto. Si una serie sale mal identificada, copia el título y el año tal cual aparecen en la web del scraper que uses. Ese es el nombre que debe tener tu carpeta, no el que a ti te resulte cómodo.

Carpetas de red que no aparecen

Si tu contenido está en un NAS o en otro ordenador, el fallo suele estar en el protocolo. Kodi no admite SMBv1, y la documentación oficial lo desaconseja de forma expresa por sus vulnerabilidades graves de seguridad. En el cliente SMB, dentro de los ajustes de servicios con nivel avanzado, fuerza la versión mínima a SMBv2 o superior. Ahí mismo está el tamaño de bloque, 128 KB por defecto, que puede mejorar la reproducción de ficheros UHD de mucho bitrate en aparatos flojos.

Con NFS el planteamiento es idéntico: comprueba primero que la ruta se monta fuera de Kodi, porque si el aparato no llega, Kodi tampoco. Y si lo que ves es un aviso de conexión rechazada, tenemos aparte el error de conexión con el servidor remoto.

Permisos de almacenamiento en Android

Hay un caso muy típico: Kodi ve la memoria interna pero no la tarjeta microSD, o al revés. No es un fallo de la aplicación. Entra en los ajustes del sistema, abre la ficha de la aplicación Kodi y comprueba que tenga concedido el permiso de acceso a archivos y multimedia. Después vuelve a añadir la fuente.

El mando, el teclado o el móvil no controlan Kodi

Cuando el mando del televisor deja de mover el cursor dentro de Kodi, el sospechoso habitual es el CEC, el protocolo que permite que ese mando gobierne los aparatos conectados por HDMI. Se desactiva solo más a menudo de lo que parece, sobre todo tras un apagón o un cambio de puerto. Revisa que esté activo en el televisor, donde cada marca lo llama de otra forma, y prueba otro HDMI. Si sigue igual, la Kodi Foundation publica dos mandos oficiales y gratuitos, Kore para Android y el Official Kodi Remote para iOS, enlazados desde la página de descarga. Y si usas un adaptador CEC externo, la versión 21.3 corrigió un fallo que impedía activar y desactivar los adaptadores de Pulse-Eight.

Qué versión deberías tener y en qué sistemas funciona

Muchos problemas se aclaran sabiendo en qué punto está el proyecto. Este es el estado según la propia web de Kodi:

Kodi se distribuye de forma nativa para Windows, Linux, Android, macOS, iOS, tvOS, webOS y Raspberry Pi. Al saltar de una rama mayor a otra, por ejemplo de la 20 a la 21, haz copia de tu carpeta de datos antes; entre versiones de mantenimiento de la misma rama la actualización se instala encima sin problema.

Si el fallo viene de un addon de terceros, no lo vamos a arreglar

Llegamos al motivo real por el que mucha gente busca que Kodi no funciona: el programa arranca, la interfaz responde, pero un complemento instalado desde un repositorio externo ha dejado de cargar, da un error de dependencias o devuelve listas vacías. Desde tuapppara no acompañamos complementos de fuera del repositorio oficial, y no es por comodidad. Hay tres razones concretas:

• Se rompen por diseño. Un repositorio externo depende de un dominio que su autor mantiene o abandona. Cuando cae, todo lo que colgaba de él deja de funcionar a la vez, y ningún ajuste dentro de Kodi arregla un servidor que ya no existe.
• Suelen dar acceso a contenido sin licencia. El propio equipo lo deja escrito en su página de descarga: el consumo de contenido pirateado que de otro modo habría que pagar no está respaldado ni aprobado por Team Kodi.
• Instalar un paquete de origen desconocido es ejecutar código ajeno. Un complemento de Kodi corre con los permisos de la aplicación y accede a la red. No es una lista de enlaces inofensiva.

Por eso tampoco recomendamos vaciar la caché ni tocar ficheros de configuración avanzada para que «vuelvan los enlaces». Ese consejo circula mucho, no arregla nada y deja tu instalación en un estado que después nadie sabe deshacer.

La alternativa que sí sostiene es doble. Si quieres un centro multimedia con tu propio contenido bien presentado, Kodi lo hace de sobra y Plex cubre ese terreno con servidor y clientes. Si lo que buscas es catálogo, mira dónde descargar películas y series de forma legal. Y si concluyes que Kodi no es lo tuyo, repasamos las alternativas a Kodi, con menos mantenimiento.

Preguntas frecuentes

¿Por qué Kodi se cierra solo nada más abrirlo?

Casi siempre es una instalación incompleta o un perfil de usuario dañado. Reinstala la versión estable desde kodi.tv por encima de la que tienes. Si sigue cerrándose, copia tu carpeta de datos a otro sitio y renómbrala: Kodi creará un perfil limpio. Si así arranca, el fallo estaba en la base de datos y tendrás que volver a añadir tus fuentes.

¿Sirve de algo vaciar la caché de Kodi?

Muy poco. La documentación oficial explica que la carpeta de caché se limpia sola: unas 3 horas de retención en la caché de Python y 24 horas o más en la de los scrapers. Vaciarla a mano no acelera el programa de forma duradera ni recupera contenido que ha dejado de estar disponible en su origen.

¿Cuál es la última versión estable de Kodi?

La rama estable es Kodi 21.x «Omega», y su última entrega, la 21.3, se publicó el 16 de diciembre de 2025. Kodi 22 «Piers» existe, pero sigue en beta desde el 28 de junio de 2026 y el propio equipo avisa de que puede dar comportamientos inesperados. Mira siempre la sección estable de la web de descargas.

Kodi no encuentra mis películas aunque están en la carpeta, ¿qué falla?

Casi siempre el nombre del fichero. Kodi identifica el contenido leyendo ese nombre: usa «Título (Año)» para películas y «Nombre de la serie (Año)» con episodios en formato S01E01 para series. Si está en un disco de red, comprueba además que la conexión no intente negociar SMBv1, que Kodi no admite.

¿Por qué no explicáis cómo reparar un addon de terceros?

Porque no es un fallo que se pueda arreglar desde Kodi. Esos complementos dependen de repositorios externos que caen o cambian de dominio, y suelen dar acceso a contenido sin licencia, algo que el propio equipo de Kodi declara que no respalda. Preferimos señalarte las opciones legales, que seguirán ahí dentro de un año.

¿Dónde está el registro de errores de Kodi?

En la carpeta de datos de Kodi, con los nombres kodi.log y kodi.old.log. Solo se guardan las dos últimas sesiones: al arrancar, el anterior se renombra y se crea uno nuevo. Para que sirva en el foro oficial hay que activar antes el registro de depuración, en los ajustes del sistema en modo experto.