tg-mpv-bot
Bot de Telegram que convierte el dispositivo en control remoto para mpv en TV. Sin nube ni puertos abiertos. Usa socket IPC JSON de mpv directamente desde Python. Soporta streaming YouTube, IPTV y archivos locales.
Ficha actualizada 26 sept 2026, 14:20 · upstream 26 sept 2026, 14:14 · release v1.3.2
Qué es tg-mpv-bot
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
tg-mpv-bot transforma Telegram en un control remoto completo para reproductores multimedia mpv en tu TV o HTPC. El bot se ejecuta en el servidor local conectado a la TV vía HDMI, mientras que tu teléfono o cualquier dispositivo con Telegram actúa como mando a distancia sin necesidad de aplicaciones nativas de smart-TV ni configuración de puertos.
El sistema funciona mediante conexión directa al socket IPC JSON de mpv desde Python, permitiendo control total sobre reproducción, búsqueda en biblioteca local, streaming de enlaces externos (YouTube, SoundCloud y más de 1000 sitios vía yt-dlp), y reproducción de archivos enviados por Telegram. Incluye panel de reproducción actual con controles de transporte, navegación por episodios, capturas de pantalla y historial de visualización paginado.
La arquitectura soporta hooks personalizados para entornos de escritorio (i3-msg, swaymsg, notify-send) y ofrece despliegue nativo en Linux con X11/Wayland, Docker o AUR. El acceso se limita mediante ALLOWED_USERS para mantener el control sobre quién puede operar el sistema.
- Controlar reproducción multimedia desde cualquier dispositivo con Telegram sin instalar apps en la TV
- Streaming de enlaces YouTube y sitios externos directamente al reproductor mpv local
- Gestión de biblioteca local con navegación por categorías, búsqueda y recuperación de episodios
- Transmisión IPTV en vivo con acceso a 50.000+ canales del catálogo iptv-org público
- Grabación de contenido en tiempo real para compartir en chat o guardar como archivo
- Sin puertos abiertos ni exposición al internet: solo conexiones salientes desde el servidor local
- Compatibilidad con más de 1000 sitios de streaming vía yt-dlp integrado
- Soporte nativo para hooks de entorno de escritorio (i3, sway, notify-send)
- Despliegue multiplataforma: Docker, AUR, systemd o instalación desde fuente
- Historial de reproducción paginado con recuperación de posición exacta
- Requiere servidor Linux con sesión gráfica (X11 o Wayland) conectado a la TV
- Solo un instancia por token de bot: Telegram permite un solo poller global
- Archivos >20 MB requieren configuración adicional de API_SERVER_URL local
- Docker necesita bind-mount del socket mpv y X11 con precauciones específicas
- yt-dlp estable puede fallar en YouTube; requiere actualización periódica a nightly
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar en servidor Linux siempre encendido. Configurar ALLOWED_USERS para control de acceso. Usar network_mode: host en Docker y bind-mount directorio del socket mpv (no el archivo). Para systemd user service, crear unidad con WorkingDirectory apuntando al repo y .venv/ dentro. Actualizar yt-dlp periódicamente con /mpv_update_ytdlp o YTDL_UPDATE_DAYS=7.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.