ProxMenux/web/messages/es/guides/kodi-lxc.json

{
  "meta": {
    "title": "Instalar Kodi en un LXC con aceleración por GPU | Guías ProxMenux",
    "description": "Ejecuta Kodi dentro de un contenedor LXC privilegiado en Proxmox VE, expón la iGPU del host y los dispositivos USB de entrada, y convierte el servidor Proxmox en un media center todo en uno conectado directamente a una TV.",
    "ogTitle": "Instalar Kodi en un LXC con aceleración por GPU",
    "ogDescription": "Ejecuta Kodi dentro de un LXC privilegiado en Proxmox VE con passthrough de la iGPU del host y dispositivos USB de entrada — convierte el servidor en un media center todo en uno."
  },
  "header": {
    "title": "Instalar Kodi en un LXC y conectarlo a un monitor / TV con aceleración por GPU",
    "description": "Ejecuta Kodi dentro de un contenedor LXC privilegiado en Proxmox VE, expón la iGPU del host y los dispositivos USB de entrada, y convierte el servidor Proxmox en un media center todo en uno conectado directamente a una TV.",
    "section": "Guías"
  },
  "intro": {
    "calloutTitle": "Aviso",
    "calloutBody": "Esta guía utiliza un script externo de la comunidad para preparar el LXC de Kodi. ProxMenux también puede configurar el acceso a la iGPU del host: <strong>GPUs y Coral-TPU → Añadir GPU a un LXC</strong> configura <code>/dev/dri</code> e instala los controladores dentro del contenedor. El script siguiente instala además Kodi y el arranque automático en <code>tty7</code>. Úsalo para preparar un centro multimedia en LXC; elige el <gpuLink>asistente de ProxMenux</gpuLink> si solo necesitas dar acceso a la GPU a un contenedor que ya has configurado.",
    "credit": "Script original del LXC de Kodi creado por <authorLink>mrrudy</authorLink>.",
    "stepsTitle": "Qué vas a hacer",
    "steps": [
      "Crear un LXC privilegiado ejecutando Kodi (con el script).",
      "Dar acceso al teclado, ratón o mando USB desde el contenedor.",
      "(Opcional) Actualizar Kodi desde los repositorios configurados en el contenedor."
    ]
  },
  "createCt": {
    "heading": "1. Crear el LXC de Kodi",
    "body": "Para este procedimiento, selecciona <strong>Privileged</strong> en los ajustes avanzados del script. Por defecto crea contenedores sin privilegios, que requieren permisos de dispositivos y mapeo de identificadores adecuados. El script configura el acceso a la GPU, Kodi y su arranque en <code>tty7</code>:",
    "code": "bash -c \"$(wget -qLO - https://raw.githubusercontent.com/mrrudy/proxmoxHelper/main/ct/kodi-v1.sh)\"",
    "after": "Ten paciencia — la instalación tarda un rato. Cuando termine y Kodi arranque en <code>tty7</code>, puedes conectar tu monitor o TV directamente a la salida HDMI / DisplayPort del host y deberías ver la UI de Kodi."
  },
  "addInput": {
    "heading": "2. Añadir teclado, ratón o mando USB",
    "body": "Los dispositivos de entrada viven en <code>/dev/input/</code> en el host. Identifica el número major:",
    "listCode": "ls -l /dev/input",
    "imageAlt": "Listado de dispositivos de entrada",
    "afterList": "En los dispositivos de caracteres, toma el número major situado antes de la coma (en el ejemplo, <code>13</code>). En el host, edita la configuración del LXC de Kodi; sustituye <code>'<'CTID'>'</code> por su ID, por ejemplo <code>102</code>:",
    "editCode": "nano /etc/pve/lxc/CTID.conf",
    "addLines": "Añade (ajusta <code>13</code> a lo que viste en <strong>tu</strong> host):",
    "configCode": "lxc.cgroup2.devices.allow: c 13:* rwm\nlxc.mount.entry: /dev/input dev/input none bind,optional,create=dir",
    "imageConfigAlt": "Configuración del LXC",
    "save": "Guarda (<code>Ctrl+X</code>) y reinicia <strong>solo el contenedor</strong> — no hace falta reiniciar el host Proxmox entero:",
    "restartCode": "pct reboot CTID",
    "plug": "Conecta el teclado / ratón / mando y Kodi debería responder."
  },
  "updateKodi": {
    "heading": "3. (Opcional) Actualizar Kodi desde los repositorios configurados",
    "calloutTitle": "Importante",
    "calloutBody": "El PPA team-xbmc es <strong>solo para Ubuntu</strong> y Kodi indica que ya no tiene mantenimiento. Que falte <code>add-apt-repository</code> no identifica la distribución. Compruébala con <code>cat /etc/os-release</code> y busca <code>NAME=\"Ubuntu\"</code>; no añadas PPA de Ubuntu a Debian. Los comandos siguientes actualizan los paquetes desde los repositorios configurados en el contenedor.",
    "body": "Dentro del contenedor (<code>pct enter '<'CTID'>'</code>):",
    "code": "apt update\napt install --only-upgrade kodi kodi-bin",
    "after": "Reinicia el contenedor después de actualizar. Kodi utilizará la versión disponible en los repositorios configurados, que puede diferir de la última versión del proyecto."
  },
  "screenshots": {
    "heading": "Capturas",
    "image1Alt": "Interfaz de Kodi 1",
    "image2Alt": "Interfaz de Kodi 2"
  },
  "troubleshoot": {
    "heading": "Solución de problemas",
    "items": [
      "<strong>El LXC de Kodi arranca pero no se ve nada en la TV:</strong> puede que el contenedor no tenga acceso a la iGPU. Comprueba <code>ls /dev/dri</code> en su interior: deberían aparecer <code>card0</code> y <code>renderD128</code>. Si está vacío, revisa el acceso a la GPU; puedes usar el menú <strong>Añadir GPU a un LXC</strong> de ProxMenux.",
      "<strong>El teclado o ratón no se detecta tras reiniciar:</strong> comprueba que <code>/dev/input</code> esté montado y Kodi tenga permiso para leer los dispositivos. Ejecuta <code>ls -l /dev/input</code> en el host y el contenedor, y revisa la regla <code>lxc.cgroup2.devices.allow</code>.",
      "<strong>La reproducción acelerada por hardware usa la CPU en lugar de la GPU:</strong> instala o actualiza los controladores VA-API en el contenedor: <code>intel-media-va-driver</code> para iGPU Intel modernas, <code>i965-va-driver</code> para las antiguas y <code>mesa-va-drivers</code> para AMD.",
      "<strong><code>add-apt-repository: command not found</code>:</strong> falta el comando; eso no demuestra que el contenedor sea Debian. Comprueba la distribución y los paquetes disponibles. En Debian, utiliza sus paquetes Kodi sin añadir el PPA de Ubuntu."
    ]
  },
  "further": {
    "heading": "Más información",
    "konpatRich": "<konpatLink>Artículo de Konpat</konpatLink> con más contexto sobre el acceso a la iGPU Intel desde LXC."
  }
}