LumeRecorder

Graba TV en directo con tu propio servidor

LumeRecorder es un pequeño servidor DVR gratuito y de código abierto que ejecutas en casa. Lume le dice qué grabar y él graba por su cuenta, incluso mientras todos tus dispositivos Apple están en reposo. Las grabaciones se reproducen en Lume en todos tus dispositivos, también las que aún se están grabando.

La grabación forma parte de Lume Pro. El servidor es gratuito.

Qué necesitas

  1. Paso 1

    Inicia el servidor

    Elige cómo ejecutas contenedores. Cada opción guarda grabaciones y ajustes en una carpeta de datos al lado, así que sobreviven a las actualizaciones.

    Guarda esto como docker-compose.yml en una carpeta nueva y arráncalo desde esa carpeta. La red del host permite que Lume encuentre el servidor automáticamente.

    docker-compose.yml
    services:
      lume-recorder:
        image: ghcr.io/bilipp/lumerecorder:latest
        container_name: lume-recorder
        restart: unless-stopped
        network_mode: host
        volumes:
          - ./data:/data
    docker compose up -d

    En Synology, QNAP, Unraid o TrueNAS puedes pegar el mismo archivo como proyecto nuevo en el gestor de Docker o Container Manager del sistema.

    ¿Prefieres ejecutarlo sin contenedores? Necesita Swift 6 y ffmpeg; consulta compilar desde el código fuente.

  2. Paso 2

    Obtén el código de vinculación

    Al arrancar, el servidor muestra en su registro un código de vinculación de 6 dígitos y uno nuevo cada 10 minutos. Consulta el código actual en cualquier momento con:

    docker exec lume-recorder lume-recorder pair

    Con la herramienta de Apple, ejecuta container exec lume-recorder lume-recorder pair en su lugar. En un NAS, el código también aparece en la vista del registro del contenedor.

  3. Paso 3

    Vincula Lume

    1. En Lume, abre Ajustes › TV en directo › Servidor de grabación.
    2. Lee Antes de vincular y toca Entendido.
    3. Elige tu servidor en Servidores en esta red. Si no aparece, toca Introducir dirección manualmente, escribe la dirección IP del servidor (por ejemplo 192.168.1.20) y toca Conectar. Si no indicas otro puerto, Lume usa el 8090.
    4. Introduce el Código de vinculación del servidor y toca Vincular.

    Vincula una sola vez: la vinculación se sincroniza con tus otros dispositivos Apple a través de iCloud.

  4. Paso 4

    Graba

    • Grabar ahora: elige Grabar en el menú de un canal o en el reproductor.
    • Grabar más tarde: abre un programa en la Guía y elige Programar grabación.
    • Ver: abre Grabaciones desde la barra de herramientas de TV en directo o en Ajustes › TV en directo. En el Apple TV también puedes mostrarlo en la barra lateral de TV en directo.

Ajustes

Cámbialos como entradas environment en docker-compose.yml (o con -e NAME=value en la herramienta de Apple).

VariablePor defectoQué hace
SERVER_NAMENombre de hostEl nombre que Lume muestra para el servidor.
PORT8090El puerto en el que escucha el servidor.
MAX_CONCURRENT4Cuántas grabaciones pueden ejecutarse a la vez. Cada una usa una conexión con tu proveedor.
MIN_FREE_GB2Las grabaciones no empiezan si quedan libres menos gigabytes que este valor.
BONJOUR10 desactiva la detección automática, para configuraciones en las que no puede funcionar.
TZUTCZona horaria de las marcas de tiempo del registro, p. ej. Europe/Berlin.

Vuelve a ejecutar docker compose up -d después de cambiarlos.

Solución de problemas

Lume no encuentra el servidor

Comprueba que Lume puede usar tu red local (en iPhone y iPad: Ajustes › Privacidad y seguridad › Red local). La detección automática solo funciona con la red del host en Linux. Con Docker Desktop, la herramienta de Apple, red bridge o VLAN separadas, toca Introducir dirección manualmente y escribe la dirección IP del equipo.

Mi NAS ya tiene su propio servicio Bonjour

Dos servicios de detección en un mismo equipo se estorban. Pon BONJOUR a 0 y añade el servidor por su dirección. El README de LumeRecorder explica cómo anunciarlo a través del servicio del propio NAS.

El código de vinculación no se acepta

Los códigos cambian cada 10 minutos, así que consulta el actual. Tras cinco códigos incorrectos, la vinculación se bloquea durante un minuto.

Una grabación falla mientras veo la TV

El servidor abre su propia conexión con tu proveedor. Si tu plan solo permite una conexión a la vez, ver y grabar al mismo tiempo puede fallar. Amplía tu límite de conexiones con el proveedor o evita que coincidan.

Una grabación falló por falta de espacio o por demasiadas grabaciones

Libera espacio en disco o reduce MIN_FREE_GB, y aumenta MAX_CONCURRENT si tu proveedor permite más conexiones.

¿Qué pasa si el servidor se reinicia?

Las grabaciones en curso se reanudan cuando vuelve, con un breve corte. Las programadas cuya hora pasó mientras estaba apagado se marcan como fallidas.

Actualizar

Desde la carpeta con docker-compose.yml, descarga la imagen nueva y reinicia. Las grabaciones y vinculaciones se conservan en la carpeta de datos.

docker compose pull && docker compose up -d

Todas las opciones, la API HTTP y el código fuente están en el repositorio de LumeRecorder en GitHub.

← Volver a Lume