dopeIPTV

Ayuda

Todo está en esta página con la respuesta abierta. Escribe para acotar — pulsa «/» en cualquier punto de la página para saltar al buscador.

Instalar y configurar

¿Cómo lo instalo en Linux?

Tres formatos, todos autocontenidos — Python, Qt, libmpv y ffmpeg van dentro de la descarga, así que no hay nada que instalar aparte.

AppImage — el que hay que coger si tienes dudas. Funciona en cualquier distribución:

chmod +x dopeIPTV-*.AppImage
./dopeIPTV-*.AppImage

.deb en Debian o Ubuntu:

sudo apt install ./dopeiptv_*_amd64.deb

Flatpak:

flatpak install --user dopeIPTV-*.flatpak

Hay versiones arm64 de los tres para una Raspberry Pi o un servidor ARM.

¿Cómo lo instalo en macOS?

Abre el .dmg y arrastra dopeIPTV a Aplicaciones. Necesita macOS 15 o posterior y funciona en Apple Silicon — la 1.2.10 fue la última versión con compilación para Intel.

El primer arranque se rechaza porque la aplicación no está notarizada por Apple. Haz clic derecho sobre ella y elige Abrir, y luego Abrir otra vez en el diálogo. Si eso no basta, mira «macOS dice que la aplicación no se puede abrir» más abajo.

¿Cómo lo instalo en Windows?

No hay instalador. Descomprime dopeIPTV-*-windows-x64.zip donde quieras — tu carpeta de usuario vale, no hacen falta permisos de administrador — y ejecuta el dopeiptv.exe que hay dentro.

Hay una compilación arm64 nativa para portátiles Snapdragon; la x64 también funciona ahí, emulada y por tanto más lenta.

Para un acceso directo en el menú Inicio o el escritorio: Ajustes → Interfaz → Mantenimiento → Crear acceso directo. El README.txt del zip enumera todo lo que hay que borrar si quieres que la aplicación desaparezca sin dejar rastro.

¿Cómo conecto a mi proveedor?

En el primer arranque se te piden tres datos de tu cuenta Xtream Codes:

  • Servidor — la dirección con el puerto, del tipo http://example.com:8080. No una URL de lista completa, solo el host.
  • Usuario y Contraseña — los que te dio tu proveedor.

Quedan guardados. Para añadir otra cuenta más adelante, o editar esta: Ajustes → Listas de reproducción. Puedes cambiar de lista con la aplicación abierta, y los favoritos y el historial se guardan por separado para cada una.

¿Puedo usar una lista M3U en su lugar?

Sí. Elige M3U al añadir una lista y pega la dirección que te dio tu proveedor.

Una cuenta Xtream saca más partido de la aplicación — catch-up, caducidad de la cuenta, la guía del propio proveedor — porque eso viene de una API que una lista M3U no tiene. Una lista M3U se reproduce y puede recibir su propia dirección XMLTV para la guía, lo que cubre casi toda la diferencia.

¿Puedo probarlo sin cuenta?

Sí. El asistente inicial ofrece canales de demostración: un puñado de emisiones de prueba libres y públicas de Mux, Apple y Bitmovin, para que veas la aplicación funcionando antes de escribir nada. Son emisiones de prueba oficiales, no el servicio de nadie, y puedes pasar a una lista real cuando quieras.

Ver

¿Cómo reproduzco algo?

Doble clic en la lista central, o pulsa ▶ Reproducir en el panel de la derecha. Elegir otro canal cambia la emisión sobre la marcha en lugar de desmontar el reproductor y volver a construirlo — por eso hacer zapping es rápido.

Los botones Anterior y Siguiente de la barra del reproductor recorren la lista en la que estés — canales, episodios de una serie, grabaciones o historial.

¿Cómo adelanto y retrocedo?

Para películas, episodios, grabaciones y catch-up — todo lo que tiene duración conocida:

  • Pon el puntero sobre la imagen y sube una barra de progreso, con el tiempo transcurrido y total y botones de −10 s / +30 s.
  • Haz un clic en el vídeo y usa las flechas: una pulsación salta diez segundos, mantenerla pulsada avanza de forma continua.

Los canales en directo no se pueden recorrer y a propósito no muestran barra. Para moverte dentro de un canal en directo necesitas timeshift — véase más abajo.

Pantalla completa y los controles

Doble clic en la imagen, o pulsa F. Esc sale — y también el botón explícito Salir de pantalla completa de la barra flotante, que está ahí precisamente para que nadie tenga que conocer Esc.

Los controles y el puntero se ocultan tras unos segundos de quietud y vuelven al menor movimiento.

¿Puedo mover el vídeo a una segunda pantalla?

Sí — saca el reproductor a su propia ventana y arrástrala donde quieras.

Es sin marco por defecto: arrastra desde cualquier punto de la imagen para moverla. Clic derecho para «siempre encima», barra de título o Salir. Esc también la devuelve. La ventana principal sigue funcionando mientras tanto.

Idioma del audio, subtítulos y ajustes de imagen

El botón de la barra del reproductor — también está en los controles de pantalla completa — contiene todo lo relativo a la emisión que estás viendo:

  • Pista de audio y pista de subtítulos
  • Retardo de audio, cuando el sonido va desfasado
  • Relación de aspecto (16:9, 4:3, estirado, etc.)
  • Tamaño del búfer de red
  • Stats for nerds: códecs, resolución, fotogramas por segundo, decodificación por hardware, sincronía A/V, fotogramas perdidos, caché y velocidad de red, en vivo sobre la imagen

La pista que elijas se recuerda, y en una serie pasa al episodio siguiente. Si prefieres fijar una preferencia para todas las emisiones, mira Ajustes más abajo.

Atajos de teclado

  • Espacio — pausar y continuar
  • F — pantalla completa, Esc para salir
  • ← / → — diez segundos, mantener para seguir
  • M — silencio

Funcionan igual en la ventana principal, en pantalla completa y en la ventana desacoplada.

¿Recuerda dónde lo dejé?

Sí, en películas, episodios de series, grabaciones y tus propios archivos locales. Al volver a empezar, pregunta si quieres continuar en ese punto o empezar desde el principio.

Las posiciones muy cercanas al principio o al final se ignoran a propósito, para no ofrecerte continuar algo que acababas de empezar o que ya habías terminado.

Guía, timeshift y grabación

¿De dónde viene la guía de programación?

De tu proveedor. Cada canal en directo muestra en la lista lo que hay ahora con una barra de progreso, y el panel de detalle muestra lo que viene después.

La guía se guarda en caché en disco para cada lista, así que está en pantalla en cuanto abres la aplicación — la copia nueva se descarga en segundo plano y la sustituye. Si esa descarga falla, se mantiene la guía en caché en lugar de dejarte sin nada.

¿Hay una guía completa?

Sí. El botón Guía de la barra lateral abre una parrilla de programación buscable que cubre todos los canales, con una línea de tiempo por la que desplazarte. La búsqueda encuentra un programa por su nombre en todos los canales.

En un canal con catch-up, hacer doble clic en un programa ya emitido lo reproduce desde el archivo.

La guía está mal, vacía o es de otro país

Dale a esa lista su propia guía en lugar de la del proveedor:

  1. Ajustes → Listas de reproducción
  2. Selecciona la lista y edítala
  3. Pon una dirección XMLTV en el campo de guía personalizada

Sustituye a lo que envía el proveedor. La aplicación empareja tus canales con esa guía primero por el identificador EPG y después por el nombre del canal, así que una guía de otra fuente suele encajar igualmente.

Todo aparece desplazado una o dos horas

Algunos proveedores publican horarios que no coinciden con lo que emiten realmente. Hay dos correcciones distintas en Ajustes → Reproducción:

  • El desfase de EPG desplaza todas las horas que muestra la guía.
  • El desfase de reproducción diferida desplaza el punto en que empiezan catch-up y timeshift, sin tocar los horarios.

Están separados porque los proveedores se equivocan en uno con independencia del otro.

¿Qué son el timeshift y el catch-up?

Algunos proveedores guardan unos días de grabación de cada canal. Donde el tuyo lo hace, el canal lleva una marca en la lista, y el panel de detalle dice cuántos días de profundidad tiene el archivo.

Si un canal no lleva marca, el proveedor no ofrece archivo para él. Es un ajuste suyo y nada en la aplicación puede activarlo.

¿Cómo veo algo que ya ha empezado?

Pulsa el botón del reproductor — también está en los controles de pantalla completa — o haz clic derecho en el canal y elige Timeshift. Después elige desde el principio.

Lo que se reproduce es un trozo del archivo, así que se recorre como una película: la barra y las flechas funcionan dentro de él.

¿Puedo volver a ayer?

Sí. El menú de timeshift enumera los programas pasados agrupados por día — doble clic en uno para verlo. También puedes retroceder en saltos fijos, y esos saltos se ajustan a la profundidad real del archivo de tu proveedor, de treinta minutos hasta una semana.

Algunos proveedores aceptan una petición al archivo y sirven en silencio la emisión en directo. La aplicación lo comprueba y te avisa, en lugar de dejarte creer que estás viendo ayer.

¿Cómo grabo?

Dos caminos:

  • El botón REC del reproductor, para lo que estás viendo.
  • Clic derecho en cualquier canal → Grabar, para uno que no estás viendo.

Si no eliges duración, graba hasta que lo pares. Una grabación se puede ver mientras se está escribiendo.

¿Puedo fijar una duración o programarla?

Ambas cosas. El menú REC ofrece 30 minutos, 1, 2 o 4 horas, y una grabación programada toma una hora de inicio y una de fin.

Las tareas programadas sobreviven al reinicio de la aplicación, pero esta tiene que estar abierta cuando llegue el momento — es un programa, no un servicio en segundo plano. Grabaciones → Activas y programadas muestra lo que está pendiente.

¿Grabar consume mi segunda conexión?

No si grabas el canal que estás viendo: eso deriva la propia emisión del reproductor, no cuesta nada más y funciona en las cuentas habituales que solo permiten una emisión a la vez.

Grabar un canal distinto, o una tarea programada que empieza más tarde, sí abre su propia conexión con el proveedor.

Una cosa a saber sobre grabar desde el reproductor: se cierra cuando la grabación se detiene, así que parar la reproducción, cambiar de canal o un error de emisión la terminan.

¿Puedo evitar que una grabación llene el disco?

Sí, en dos niveles. Ajustes → Grabación admite un límite de tamaño para todas las grabaciones — un número más MB, GB o TB. Y el menú REC del reproductor tiene un límite rápido solo para la sesión en curso, de 250 MB a 10 GB.

¿Dónde están mis grabaciones?

Donde lo indiques en Ajustes → Grabación. La sección Grabaciones de la barra lateral las recorre, con las subcarpetas como categorías: crear carpetas, renombrar, mover cosas entre ellas y seleccionar varias para borrarlas de una vez.

Multivista, cast y Trakt

¿Qué es la multivista?

Una ventana aparte que muestra 2, 4, 6 o 9 canales en directo a la vez en una cuadrícula, cada uno una emisión independiente. Pueden venir de listas distintas e incluso de cuentas distintas.

Se abre desde la barra lateral; el tamaño de la cuadrícula está en Ajustes → Multivista. Doble clic en una ventana para maximizarla.

¿Cuál ventana oigo y cómo cambio una?

Haz clic en una ventana para darle el audio — un borde rojo marca la que estás oyendo.

Clic derecho en cualquiera para: silenciar, pista de audio y subtítulos, moverla o intercambiarla con otra, o quitarla. Un canal con catch-up tiene su propia línea de tiempo del archivo dentro de su ventana, así que puedes rebobinar un canal mientras los demás siguen en directo.

¿Por qué la multivista avisa de que usará varias conexiones?

Porque las usa — una por ventana. La mayoría de las cuentas de IPTV solo permiten una o dos emisiones simultáneas, así que una cuadrícula de nueve la rechazarán sin más casi todos los proveedores.

La aplicación lo dice una vez, antes de que lo descubras por un muro de emisiones fallando. Si ves «límite de conexiones alcanzado», suele ser por esto.

¿Cómo envío a un Chromecast?

Clic derecho en un canal, película o episodio → Enviar a Chromecast…, y elige el dispositivo. Los canales en directo se mandan como HLS, que es lo que espera un receptor Cast.

Enviar detiene la reproducción local — las dos juntas serían una segunda conexión con tu proveedor. Una franja sobre el reproductor indica el dispositivo y lo que está puesto, con un botón de parada. Reproducir algo en la aplicación también termina el envío y devuelve la reproducción.

El televisor rechaza un canal

Algunos canales son vídeo H.264 normal con audio Dolby Digital Plus. Un Chromecast que no sea Ultra ni Google TV no tiene decodificador para eso y rechaza la emisión sin decir por qué.

La aplicación convierte esos casos en este ordenador y sirve el resultado en tu propia red: el vídeo se copia tal cual — solo se recodifica el audio, que es barato — y solo ocurre después de que el dispositivo haya rechazado realmente la emisión. Un canal que tu dispositivo sí puede reproducir recibe siempre la emisión original del proveedor, sin alterar.

Esto necesita ffmpeg, que va dentro de todas las descargas empaquetadas.

¿Cómo conecto Trakt?

Ajustes → Trakt. Creas una aplicación en trakt.tv, pegas las dos claves que te da y autorizas en el navegador que se abre.

A partir de ahí se hace scrobble de lo que ves, y tu lista de seguimiento y tu historial se pueden consultar dentro de la aplicación. También se hace scrobble de tus archivos locales, siempre que TMDB haya podido identificar el archivo.

Tus propios archivos

¿Puedo ver mis propios archivos?

Sí. Archivos locales en la barra lateral recorre las carpetas que añadas en Ajustes → Archivos locales.

Un recurso de red que tu sistema ya tenga montado aparece solo — un montaje SMB de gvfs en Linux, un recurso bajo /Volumes en macOS, una unidad asignada en Windows. Para la aplicación son rutas normales, así que no lleva dentro ningún cliente SMB que pueda portarse mal.

¿Carpetas o biblioteca?

Las dos, con un conmutador en la columna central.

  • Carpetas muestra el árbol exactamente como está en el disco.
  • Biblioteca lee los nombres de archivo y construye con ellos series con temporadas y episodios, con las películas bajo Películas — la misma forma que las secciones del proveedor.

¿De dónde salen las carátulas?

De TMDB, para todo lo que se pueda emparejar por nombre y año. Lo que no se pueda emparejar recibe un fotograma tomado del propio vídeo, y la música saca su portada de las etiquetas del archivo o de una imagen de portada en la carpeta.

Un archivo sin año y sin etiqueta de release en el nombre nunca se adivina. Es deliberado: una carátula equivocada es peor que una miniatura. Renombra el archivo incluyendo el año si quieres que se empareje.

¿Reproduce música?

Sí. Los álbumes se agrupan, artista, álbum y título salen de las etiquetas, y hay una cola de reproducción: añade una pista, encola una carpeta entera, o pon algo a continuación. Pasa a la siguiente pista por sí sola cuando una termina.

También hay un visualizador y un ecualizador de diez bandas.

Un archivo del historial no se reproduce

Se ha movido, se ha renombrado, o su recurso de red no está montado. El historial dice cuál de las tres, y ofrece quitar la entrada, en lugar de fallar en silencio.

Si es un recurso de red, móntalo y vuelve a intentarlo — la entrada funcionará como antes.

Ajustes

Idioma y aspecto

Ajustes → Interfaz. La interfaz está traducida a 27 idiomas y cambia al instante, sin reiniciar. El árabe, el persa, el hebreo y el urdu reflejan toda la disposición.

La misma pestaña tiene cinco temas de color y siete colores de acento, que se aplican en vivo.

Valores por defecto para todas las emisiones

Ajustes → Reproducción fija lo que debe ocurrir sin que lo pidas cada vez:

  • Idioma de audio preferido
  • Subtítulos activados o no, con un primer y un segundo idioma preferido
  • Relación de aspecto y búfer de red por defecto
  • Con cuánta antelación aparece la tarjeta «Siguiente episodio» — desactivada, o de uno a diez minutos

El menú ⚙ del reproductor sigue pudiendo anular cualquiera de ellos para la emisión en curso.

¿Puedo dejar cosas fuera del alcance de otros?

Sí. Un PIN protege las categorías bloqueadas y los grupos de favoritos bloqueados. Un grupo bloqueado ni siquiera revela qué canales contiene hasta que se introduce el PIN — oculta el contenido, no solo la reproducción.

El PIN se guarda con sal y hash, no en texto claro.

¿Puedo ocultar o renombrar canales?

Clic derecho en cualquier canal, película o serie para renombrarla u ocultarla. El resultado es en la práctica tu propia lista editada, guardada por lista, y Restaurar canales predeterminados… lo devuelve todo exactamente a como lo envía el proveedor.

Categorías enteras se pueden ocultar, renombrar o bloquear desde su menú contextual. Los canales de una categoría oculta también quedan fuera de «Todos».

Varios proveedores a la vez

Añade tantas listas como quieras en Ajustes → Listas de reproducción y cambia entre ellas con la aplicación abierta. Cada una conserva sus favoritos, su historial, sus canales ocultos y sus renombrados.

Cada una puede tener además su propia dirección XMLTV y su propio calendario de actualización — nunca, al arrancar, cada 2, 6 o 12 horas, a diario o semanalmente.

Cuando algo falla

¿Cómo consigo un registro?

El registro es lo que convierte «no funciona» en algo arreglable, y las credenciales se enmascaran de él automáticamente, así que se puede adjuntar a una incidencia sin riesgo.

Lanza la aplicación desde un terminal con DOPEIPTV_LOG_FILE definido y escribirá uno ahí, además de en pantalla.

Linux — AppImage

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log ./dopeIPTV-*.AppImage

Linux — .deb o pipx

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log dopeiptv

macOS

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log \
  /Applications/dopeIPTV.app/Contents/MacOS/dopeiptv

Windows — PowerShell, en la carpeta descomprimida

$env:DOPEIPTV_LOG_FILE="$env:TEMP\dopeiptv.log"
.\dopeiptv.exe

Reproduce el problema, cierra la aplicación y adjunta el archivo. Para muchísimo más detalle, añade DOPEIPTV_LOG=debug delante del mismo comando.

La aplicación no arranca

Lánzala desde un terminal — la respuesta de arriba tiene el comando exacto para tu sistema — y lee lo que imprime. Eso señala la causa más veces que no.

Las compilaciones empaquetadas llevan todo lo que necesitan. Si instalaste desde el código con pipx, necesitas además mpv y ffmpeg de tu distribución:

sudo apt install mpv ffmpeg     # Debian/Ubuntu
sudo dnf install mpv ffmpeg     # Fedora
sudo pacman -S mpv ffmpeg       # Arch

Se oye el sonido pero no hay imagen

El reproductor integrado no está consiguiendo una superficie de vídeo.

  1. Abre ⚙ → Stats for nerds y mira si llegan fotogramas — eso separa un problema de emisión de uno de pantalla.
  2. En Wayland, prueba Ajustes → Reproducción → Ejecutar con el backend X11 y reinicia la aplicación.
  3. Lánzala desde un terminal y busca líneas que mencionen GL o mpv.

macOS dice que la aplicación no se puede abrir

Todavía no está notarizada por Apple. Haz clic derecho sobre ella y elige Abrir, luego Abrir en el diálogo — o permítela en Ajustes del Sistema → Privacidad y seguridad → Abrir de todos modos.

Si macOS dice en cambio que la aplicación está «dañada», eso es el atributo de cuarentena que puso la descarga. Quítalo:

xattr -dr com.apple.quarantine /Applications/dopeIPTV.app

Ninguno de los dos avisos significa que le pase algo a la aplicación — solo que la compilación no está firmada, para lo que hace falta un certificado de Apple de pago.

Windows dice «Windows protegió su PC»

SmartScreen no reconoce al editor porque la compilación no está firmada — eso requiere un certificado de pago. Pulsa Más información y después Ejecutar de todas formas.

Defender borró dopeiptv.exe

Un falso positivo. Dos de sus causas se corrigieron en la 1.2.10: el lanzador ahora se compila desde el código en lugar de ser el binario prefabricado del que los antivirus tienen firmas, y el ejecutable lleva un recurso de versión en condiciones.

Si tu motor lo sigue marcando, permite la carpeta en tu antivirus y notifica el falso positivo a Microsoft — es lo que acaba resolviéndolo para todos, no solo para ti.

Un canal no se reproduce

La aplicación consulta al proveedor y te dice por qué en lenguaje claro en lugar de mostrar un error pelado: cuenta caducada, límite de conexiones alcanzado, emisión inexistente, servidor inaccesible, etcétera.

Si otros canales funcionan, es ese canal. Si no funciona ninguno, mira Ajustes → Listas de reproducción — el panel de la cuenta muestra la fecha de caducidad y cuántas conexiones permite.

«Límite de conexiones alcanzado»

Tu cuenta permite cierto número de emisiones simultáneas y están todas ocupadas. Por orden de probabilidad:

  1. La multivista está abierta — cada ventana es una conexión.
  2. Hay en marcha una grabación de un canal distinto.
  3. Otro dispositivo u otra persona está usando la cuenta.
  4. Una sesión anterior aún no ha caducado en el proveedor; esperar un minuto suele bastar.

Grabar el canal que estás viendo no cuenta como segunda conexión.

Linux: la barra de tareas muestra un icono en blanco

En Wayland, GNOME y KDE toman el icono de una ventana de una entrada de escritorio que le corresponda e ignoran lo que la propia aplicación establece. Un AppImage no tiene esa entrada hasta que algo la instala.

  1. La aplicación se ofrece a añadir una en el primer arranque. Dile que sí — y luego reiníciala, porque la ventana que tienes abierta conserva el icono con el que se abrió.
  2. El mismo interruptor está en Ajustes → Reproducción si dijiste que no.
  3. Si el icono sigue sin salir, lo está tapando una caché de iconos caducada. GTK lee ese archivo en lugar de la carpeta:
rm ~/.local/share/icons/hicolor/icon-theme.cache

Instalado desde el .deb, la entrada ya está y nada de esto aplica.

«Abrir en aplicación externa» no hace nada

Esa opción lanza un mpv o un vlc independiente de tu sistema, así que uno de los dos tiene que estar instalado — el reproductor integrado no necesita nada más y no se ve afectado.

sudo apt install mpv vlc        # Debian/Ubuntu
sudo dnf install mpv vlc        # Fedora
sudo pacman -S mpv vlc          # Arch

¿No está aquí? Abre una incidencia en GitHub. Incluye la versión que aparece en Ajustes → Acerca de y el registro — la respuesta «¿Cómo consigo un registro?» de más arriba tiene el comando exacto para tu sistema.