Documentación

Todo lo que necesitás para instalar, emparejar, actualizar y mantener LinuxRemotePlayer. Si algo no está acá, escribinos a support@linuxremoteplayer.com.

Requisitos

• La PC de la TV: Linux de la familia Debian/Ubuntu con systemd (probado a fondo en KDE Neon con Plasma Bigscreen; ver la matriz de compatibilidad). Firefox se usa para el modo kiosk — si no está, el instalador lo instala solo.
• El control: cualquier teléfono con navegador moderno (Android con Chrome o Firefox; iPhone con Safari). No se descarga nada de ninguna tienda.
• Red: la PC y el teléfono en la misma red WiFi. No hace falta abrir puertos a internet — todo el control es local.

Instalación paso a paso

En una terminal de la PC que va a estar conectada a la TV:

El comando descarga la última versión, verifica su integridad (sha256) e instala el paquete. Después arranca el asistente, que te hace estas preguntas:

1. «¿Qué usuario usará la TV?»

El nombre de usuario de Linux con el que la TV inicia sesión (el de la sesión gráfica). El asistente detecta el usuario actual y te lo propone entre corchetes — si es el correcto, apretá Enter y listo. Nunca uses root: el asistente lo rechaza por seguridad.

2. «¿Esta PC está dedicada a la TV?» [S/n]

• S (modo TV dedicada): para el HTPC del salón que solo hace de TV. El servicio arranca con el sistema, se activa el firewall, y se desactivan el bloqueo de pantalla y el apagado del monitor.
• n (modo escritorio): para tu PC de uso general. El servicio corre solo dentro de tu sesión de usuario y no toca la configuración de energía ni el firewall.

3. «¿Deshabilitar suspensión/apagado de pantalla?»

Si la PC es la TV del salón, conviene que sí (es lo propuesto por defecto en modo dedicado): evita que la pantalla se apague a mitad de una película. En modo escritorio, el valor por defecto es no tocar nada.

4. «Selecciona layout de teclado de esta PC» [US / ES / LATAM]

El idioma del teclado que la app emula cuando escribís desde el teléfono. El asistente detecta el layout del sistema y te lo propone — Enter para aceptarlo. Si escribís con eñes y acentos, asegurate de elegir ES o LATAM según corresponda.

El certificado de seguridad (la advertencia del navegador)

La primera vez que abras la dirección en tu teléfono, el navegador te va a mostrar una advertencia de seguridad. Es normal y esperado. ¿Por qué pasa?

La conexión entre tu teléfono y la PC va cifrada con HTTPS (necesario para que el micrófono funcione). Como todo ocurre dentro de tu casa — sin servidores de por medio — el certificado lo genera tu propia PC, y tu navegador no conoce a tu PC como "autoridad". La advertencia solo dice eso: que el certificado es casero. La conexión sigue siendo cifrada.

Cómo aceptarlo (una sola vez por teléfono):

• Android (Chrome/Firefox): tocá «Avanzado» (o «Advanced») → «Continuar a [dirección]» / «Aceptar el riesgo y continuar».
• iPhone (Safari): tocá «Mostrar detalles» → «Visitar este sitio web» → confirmá.

En la TV no hace falta: el instalador deja el certificado configurado en Firefox automáticamente.

Emparejar el teléfono

1. Abrí en el navegador del teléfono la dirección que te dio el instalador: https://tu-pc.local:8000 (o la IP directa, por ejemplo https://192.168.1.50:8000).
2. Aceptá el certificado (arriba).
3. Escribí el PIN que muestra el panel de estado en la pantalla de la TV.
4. Cuando el control cargue, agregá la app a tu pantalla de inicio: la propia app te muestra cómo según tu teléfono (en Android: menú → «Instalar app» o «Añadir a pantalla de inicio»; en iPhone: botón compartir → «Añadir a pantalla de inicio»). Así se abre a pantalla completa, como una app nativa.

Actualizar la app

Las actualizaciones llegan por la propia app — no hace falta volver a esta página:

1. En el teléfono: Ajustes → Actualización → Buscar.
2. Si hay versión nueva, tocá el botón y la PC se actualiza sola (descarga, verifica e instala el paquete).
3. Cerrá la app del teléfono por completo y volvé a abrirla para que tome la interfaz nueva.

Alternativa por terminal en la PC: sudo bash /opt/linuxremoteplayer/scripts/update.sh

Reinstalar la app del teléfono

Si la app del teléfono queda en un estado raro (pantalla en blanco, versión vieja que no se actualiza), reinstalarla es rápido y no borra nada del lado de la PC:

1. Mantené apretado el ícono de LinuxRemotePlayer en tu pantalla de inicio → eliminar/desinstalar.
2. Abrí de nuevo https://tu-pc.local:8000 en el navegador del teléfono.
3. Emparejá con el PIN y volvé a agregarla a la pantalla de inicio.
4. Si tenías licencia Pro, no te preocupes: la licencia vive en la PC, no en el teléfono. Se reconoce sola.

Licencia Pro y mudanza de dispositivo

Activar tu licencia

1. Al completar la compra, tu clave (formato LRP-XXXX-XXXX-XXXX) llega al correo que usaste para pagar, en 1-2 minutos.
2. En la app: Ajustes → Licencia → pegá la clave → Activar.

Una PC a la vez, con mudanza autoservicio

Tu licencia funciona en una PC a la vez. Si cambiás de máquina (o formateás), no tenés que pedirle nada a nadie:

1. Instalá LinuxRemotePlayer en la PC nueva y activá tu misma clave.
2. La app te avisa que la licencia está activa en otro dispositivo y te pregunta si querés mudarla. Confirmá y listo: la PC nueva queda con el premium y la anterior lo pierde.

Privacidad y seguridad

• El control es 100% local. Touchpad, teclado, apps, volumen: todo viaja cifrado dentro de tu red WiFi, de tu teléfono a tu PC. Nada de eso pasa por internet.
• Sin cuentas, sin telemetría. No te pedimos registro y la app no envía estadísticas de uso.
• La voz es lo único que sale de tu casa — y solo si tenés Pro y apretás el botón del micrófono. Ese audio va cifrado a nuestro servicio en la nube, se usa únicamente para interpretar el comando, y el servicio solo registra metadatos mínimos (tamaño y resultado) para operar el límite diario.
• Acceso protegido. Nadie controla tu TV sin el PIN o el enlace de emparejamiento; cada conexión se autentica con un token.

Desinstalar

Un comando en la terminal de la PC:

Se retiran el servicio, las reglas de firewall que creó, los permisos de hardware y la configuración de suspensión. Si tenías licencia activa, el desinstalador la libera para que puedas activarla directamente en otra PC.

Solución de problemas

El teléfono no encuentra la PC

• Verificá que ambos estén en la misma red WiFi (ojo con redes de invitados, que suelen aislar los dispositivos entre sí).
• Si tu-pc.local no responde, probá con la IP directa que mostró el instalador (https://192.168.x.x:8000).

El touchpad/teclado no responde recién instalado

Falta el reinicio: los permisos de hardware aplican al reiniciar la PC (o cerrar y reabrir la sesión). Es una sola vez.

El primer comando de voz tarda

Es esperado: si la voz no se usó por un rato, el servicio de IA «se duerme» y el primer comando puede tardar unos segundos en despertarlo. Los siguientes responden al instante.

Apreté el micrófono sin hablar y pasó algo raro

Si el audio es puro silencio, el reconocedor a veces «escucha» palabras que no existen. Soltá el botón solo después de decir el comando, y hablá directo al teléfono.

Dice «Licencia en uso en otro dispositivo»

Tu clave está activa en otra PC. La app te ofrece mudarla — si no fuiste vos quien la activó en otro lado, escribinos.

La app del teléfono quedó rara tras una actualización

Cerrala por completo y volvé a abrirla. Si persiste, reinstalá la app del teléfono (2 minutos, no se pierde nada).