Ajuda

Três formatos, todos autossuficientes — Python, Qt, libmpv e ffmpeg vêm dentro do download, então não há nada para instalar ao lado.

AppImage — o que você deve pegar em caso de dúvida. Funciona em qualquer distribuição:

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

.deb no Debian ou Ubuntu:

sudo apt install ./dopeiptv_*_amd64.deb

Flatpak:

flatpak install --user dopeIPTV-*.flatpak

Há versões arm64 dos três, para um Raspberry Pi ou um servidor ARM.

Abra o .dmg e arraste o dopeIPTV para Aplicativos. É preciso macOS 15 ou mais recente, e o aplicativo roda em Apple Silicon — a 1.2.10 foi a última versão com build para Intel.

A primeira abertura é recusada porque o aplicativo não é notarizado pela Apple. Clique com o botão direito e escolha Abrir, depois Abrir de novo na caixa de diálogo. Se isso não resolver, veja «o macOS diz que o aplicativo não pode ser aberto» mais abaixo.

Não há instalador. Descompacte dopeIPTV-*-windows-x64.zip onde quiser — sua pasta de usuário serve, sem precisar de direitos de administrador — e execute o dopeiptv.exe que está dentro.

Existe um build arm64 nativo para notebooks Snapdragon; o x64 também roda lá, emulado e portanto mais lento.

Para um atalho no menu Iniciar ou na área de trabalho: Configurações → Interface → Manutenção → Criar atalho. O README.txt do zip lista tudo o que apagar se quiser o aplicativo fora sem deixar rastro.

Na primeira abertura são pedidos três dados da sua conta Xtream Codes:

• Servidor — o endereço com a porta, do tipo http://example.com:8080. Não é uma URL de lista completa, apenas o host.
• Usuário e Senha — os que o provedor lhe deu.

Eles ficam salvos. Para adicionar outra conta depois, ou editar esta: Configurações → Listas. Dá para trocar de lista com o aplicativo aberto, e favoritos e histórico ficam separados para cada uma.

Pode. Escolha M3U ao adicionar uma lista e cole o endereço que o provedor lhe deu.

Uma conta Xtream aproveita mais o aplicativo — catch-up, validade da conta, o guia do próprio provedor — porque isso vem de uma API que uma lista M3U não tem. Uma lista M3U reproduz e pode receber seu próprio endereço XMLTV para o guia, o que cobre quase toda a diferença.

Dá. O assistente inicial oferece canais de demonstração: alguns fluxos de teste livres e públicos da Mux, da Apple e da Bitmovin, para você ver o aplicativo funcionando antes de digitar qualquer coisa. São fluxos de teste oficiais, não o serviço de ninguém, e você pode trocar por uma lista real quando quiser.

Dê um duplo clique na lista central, ou pressione ▶ Reproduzir no painel da direita. Escolher outro canal troca o fluxo no lugar em vez de desmontar e reconstruir o player — é por isso que zapear é rápido.

Os botões Anterior e Próximo na barra do player percorrem a lista em que você está — canais, episódios de uma série, gravações ou histórico.

Para filmes, episódios, gravações e catch-up — tudo o que tem duração conhecida:

• Passe o ponteiro sobre a imagem e sobe uma barra de progresso, com tempo decorrido e total e botões de −10 s / +30 s.
• Clique uma vez no vídeo e use as setas: um toque pula dez segundos, mantendo pressionada avança continuamente.

Canais ao vivo não permitem avanço e, de propósito, não mostram barra. Para se mover dentro de um canal ao vivo é preciso timeshift — veja abaixo.

Duplo clique na imagem, ou pressione F. Esc sai — e o botão explícito Sair da tela cheia na barra flutuante também, e ele existe justamente para que ninguém precise conhecer o Esc.

Os controles e o ponteiro se escondem após alguns segundos parados e voltam ao menor movimento.

Pode — destaque o player em uma janela própria e arraste-a para onde quiser.

Ela é sem moldura por padrão: arraste de qualquer ponto da imagem para movê-la. Clique direito para «sempre no topo», barra de título ou Sair. Esc também a traz de volta. A janela principal continua funcionando enquanto isso.

O botão ⚙ na barra do player — ele também está nos controles de tela cheia — reúne tudo sobre o fluxo que você está assistindo:

• Faixa de áudio e faixa de legendas
• Atraso do áudio, quando o som está fora de sincronia
• Proporção (16:9, 4:3, esticado e assim por diante)
• Tamanho do buffer de rede
• Stats for nerds: codecs, resolução, taxa de quadros, decodificação por hardware, sincronia A/V, quadros perdidos, cache e velocidade de rede, ao vivo sobre a imagem

A faixa escolhida é lembrada, e numa série ela passa para o episódio seguinte. Para definir uma preferência para todos os fluxos, veja Configurações mais abaixo.

• Espaço — pausar e continuar
• F — tela cheia, Esc para sair
• ← / → — dez segundos, segure para continuar
• M — mudo

Funcionam igual na janela principal, em tela cheia e na janela destacada.

Lembra, para filmes, episódios de séries, gravações e seus arquivos locais. Ao começar de novo, ele pergunta se você quer continuar daquele ponto ou começar do início.

Posições muito perto do começo ou do fim são ignoradas de propósito, para não oferecer continuar algo que você tinha acabado de começar ou que já havia terminado.

Do seu provedor. Cada canal ao vivo mostra na lista o que está passando agora, com barra de progresso, e o painel de detalhes mostra o que vem depois.

O guia fica em cache no disco para cada lista, então já está na tela assim que você abre o aplicativo — a cópia nova baixa em segundo plano e a substitui. Se esse download falhar, o guia em cache permanece, em vez de deixar você sem nada.

Existe. O botão Guia na barra lateral abre uma grade de programação pesquisável cobrindo todos os canais, com uma linha do tempo por onde rolar. A busca encontra um programa pelo nome em todos os canais.

Num canal com catch-up, dar um duplo clique num programa já exibido o reproduz a partir do arquivo.

Dê a essa lista um guia próprio em vez do guia do provedor:

1. Configurações → Listas
2. Selecione a lista e edite-a
3. Coloque um endereço XMLTV no campo de guia personalizado

Ele substitui o que o provedor envia. O aplicativo casa seus canais com esse guia primeiro pelo identificador EPG e depois pelo nome do canal, então um guia de outra fonte costuma encaixar mesmo assim.

Alguns provedores publicam horários que não correspondem ao que de fato transmitem. Há duas correções separadas em Configurações → Reprodução:

• O deslocamento do EPG move todos os horários que o guia mostra.
• O deslocamento de replay move o ponto em que catch-up e timeshift começam a reproduzir, sem mexer na programação exibida.

São separados porque os provedores erram um independentemente do outro.

Alguns provedores guardam alguns dias de gravação de cada canal. Onde o seu guarda, o canal ganha uma marca ⏪ na lista, e o painel de detalhes diz quantos dias o arquivo cobre.

Se um canal não tem a marca, o provedor não oferece arquivo para ele. É uma configuração dele e nada no aplicativo consegue ligar isso.

Pressione o botão ⏪ no player — ele também está nos controles de tela cheia — ou clique com o botão direito no canal e escolha Timeshift. Depois escolha desde o início.

O que toca é um trecho do arquivo, então ele se percorre como um filme: a barra e as setas funcionam dentro dele.

Dá. O menu do timeshift lista os programas passados agrupados por dia — duplo clique num deles para assistir. Você também pode voltar em passos fixos, e esses passos se ajustam à profundidade real do arquivo do seu provedor, de trinta minutos até uma semana.

Alguns provedores aceitam um pedido ao arquivo e entregam o ao vivo em silêncio. O aplicativo verifica isso e avisa, em vez de deixar você pensar que está vendo ontem.

Dois caminhos:

• O botão REC no player, para o que você está assistindo.
• Clique direito em qualquer canal → Gravar, para um que você não está assistindo.

Sem escolher duração, ele grava até você parar. Uma gravação pode ser assistida enquanto ainda está sendo escrita.

Ambos. O menu REC oferece 30 minutos, 1, 2 ou 4 horas, e uma gravação agendada recebe um horário de início e um de fim.

Os agendamentos sobrevivem a reiniciar o aplicativo, mas ele precisa estar aberto na hora marcada — é um programa, não um serviço em segundo plano. Gravações → Ativas e agendadas mostra o que está pendente.

Não, se você gravar o canal que está assistindo: isso deriva o próprio fluxo do player, não custa nada a mais e funciona nas contas comuns que só permitem um fluxo por vez.

Gravar um canal diferente, ou um agendamento que começa depois, aí sim abre uma conexão própria com o provedor.

Uma coisa a saber sobre gravar pelo player: a gravação é finalizada quando para, então parar a reprodução, trocar de canal ou um erro de fluxo a encerram.

Dá, em dois níveis. Configurações → Gravação aceita um limite de tamanho válido para todas as gravações — um número mais MB, GB ou TB. E o menu REC do player tem um limite rápido só para a sessão atual, de 250 MB a 10 GB.

Onde você definir em Configurações → Gravação. A seção Gravações na barra lateral navega por elas, com subpastas como categorias: criar pastas, renomear, mover itens entre elas e selecionar vários para apagar de uma vez.

Uma janela separada mostrando 2, 4, 6 ou 9 canais ao vivo ao mesmo tempo numa grade, cada um um fluxo independente. Eles podem vir de listas diferentes e até de contas diferentes.

Abra pela barra lateral; o tamanho da grade está em Configurações → Multiview. Duplo clique num quadro para maximizá-lo.

Clique num quadro para dar o áudio a ele — uma borda vermelha marca o que você está ouvindo.

Clique direito em qualquer um para: mudo, faixa de áudio e legendas, mover ou trocar de lugar com outro, ou remover. Um canal com catch-up ganha sua própria linha do tempo do arquivo dentro do quadro, então dá para rebobinar um canal enquanto os outros seguem ao vivo.

Porque usa mesmo — uma por quadro. A maioria das contas IPTV só permite um ou dois fluxos simultâneos, então uma grade de nove será simplesmente recusada pela maioria dos provedores.

O aplicativo diz isso uma vez, antes de você descobrir por uma parede de fluxos falhando. Se você vê «limite de conexões atingido», normalmente é por isso.

Clique direito num canal, filme ou episódio → Transmitir para Chromecast… e escolha o dispositivo. Canais ao vivo são enviados como HLS, que é o que um receptor Cast espera.

Transmitir interrompe a reprodução local — as duas juntas seriam uma segunda conexão com o seu provedor. Uma faixa acima do player informa o dispositivo e o que está tocando, com um botão de parar. Reproduzir algo no aplicativo também encerra a transmissão e devolve a reprodução.

Alguns canais são vídeo H.264 comum com áudio Dolby Digital Plus. Um Chromecast que não seja Ultra nem Google TV não tem decodificador para isso e rejeita o fluxo sem dizer por quê.

O aplicativo converte esses casos neste computador e serve o resultado na sua própria rede: o vídeo é copiado intacto — só o áudio é recodificado, o que é barato — e isso só acontece depois de o dispositivo ter de fato recusado o fluxo. Um canal que o seu dispositivo consegue reproduzir recebe sempre o fluxo original do provedor, inalterado.

Isso precisa do ffmpeg, que vem dentro de todos os downloads empacotados.

Configurações → Trakt. Você cria um aplicativo em trakt.tv, cola as duas chaves que ele dá e autoriza no navegador que abre.

Depois disso, o que você assiste é registrado (scrobble), e sua watchlist e seu histórico podem ser navegados dentro do aplicativo. Seus arquivos locais também são registrados, sempre que o TMDB conseguir identificar o arquivo.

Pode. Arquivos locais na barra lateral navega pelas pastas que você adiciona em Configurações → Arquivos locais.

Um compartilhamento de rede que o seu sistema já montou aparece sozinho — uma montagem SMB via gvfs no Linux, um compartilhamento em /Volumes no macOS, uma unidade mapeada no Windows. Para o aplicativo são caminhos comuns, então não há nenhum cliente SMB dentro dele que possa se comportar mal.

As duas, com um alternador na coluna central.

• Pastas mostra a árvore exatamente como ela está no disco.
• Biblioteca lê os nomes dos arquivos e monta séries com temporadas e episódios a partir deles, com filmes em Filmes — o mesmo formato das seções do provedor.

Do TMDB, para tudo que puder ser identificado por nome e ano. O que não puder recebe um quadro tirado do próprio vídeo, e a música pega a capa das tags do arquivo ou de uma imagem de capa na pasta.

Um arquivo sem ano e sem tag de release no nome nunca é adivinhado. É proposital: um pôster errado é pior que uma miniatura. Renomeie o arquivo incluindo o ano se quiser que ele seja identificado.

Toca. Os álbuns ficam agrupados, artista, álbum e título vêm das tags, e há uma fila de reprodução: adicionar uma faixa, enfileirar uma pasta inteira, ou tocar algo em seguida. Ele passa para a próxima faixa sozinho quando uma termina.

Há também um visualizador e um equalizador de dez bandas.

Ele foi movido, renomeado, ou o compartilhamento dele não está montado. O histórico diz qual dos três, e oferece remover a entrada, em vez de falhar em silêncio.

Se for um compartilhamento, monte-o e tente de novo — a entrada volta a funcionar como antes.

Configurações → Interface. A interface está traduzida para 27 idiomas e muda na hora, sem reiniciar. Árabe, persa, hebraico e urdu espelham todo o layout.

A mesma aba tem cinco temas de cor e sete cores de destaque, aplicados ao vivo.

Configurações → Reprodução define o que deve acontecer sem você pedir toda vez:

• Idioma de áudio preferido
• Legendas ligadas ou não, com um primeiro e um segundo idioma preferido
• Proporção e buffer de rede padrão
• Com quanta antecedência aparece o cartão «Próximo episódio» — desligado, ou de um a dez minutos

O menu ⚙ do player continua podendo sobrepor qualquer um deles para o fluxo em andamento.

Dá. Um PIN protege categorias bloqueadas e grupos de favoritos bloqueados. Um grupo bloqueado nem revela quais canais estão nele até o PIN ser digitado — ele esconde o conteúdo, não só a reprodução.

O PIN é guardado com sal e hash, não em texto puro.

Clique direito em qualquer canal, filme ou série para renomear ou ocultar. O resultado é, na prática, a sua própria lista editada, salva por lista, e Restaurar canais padrão… devolve tudo exatamente como o provedor envia.

Categorias inteiras podem ser ocultadas, renomeadas ou bloqueadas pelo menu de contexto da categoria. Os canais de uma categoria oculta ficam de fora de «Todos» também.

Adicione quantas listas quiser em Configurações → Listas e alterne entre elas com o aplicativo aberto. Cada uma mantém seus próprios favoritos, histórico, canais ocultos e renomeações.

Cada uma pode ter também seu próprio endereço XMLTV e sua própria periodicidade de atualização — nunca, ao iniciar, a cada 2, 6 ou 12 horas, diariamente ou semanalmente.

O log é o que transforma «não funciona» em algo que dá para consertar, e as credenciais são mascaradas dele automaticamente, então dá para anexá-lo a uma issue com segurança.

Rode o aplicativo a partir de um terminal com DOPEIPTV_LOG_FILE definido e ele escreve um lá, além da tela.

Linux — AppImage

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

Linux — .deb ou pipx

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log dopeiptv

macOS

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

Windows — PowerShell, na pasta descompactada

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

Reproduza o problema, feche o aplicativo e anexe o arquivo. Para muito mais detalhe, acrescente DOPEIPTV_LOG=debug antes do mesmo comando.

Abra-o a partir de um terminal — a resposta acima traz o comando exato para o seu sistema — e leia o que ele imprime. Isso aponta a causa na maioria das vezes.

Os builds empacotados trazem tudo de que precisam. Se você instalou do código com pipx, precisa também de mpv e ffmpeg da sua distribuição:

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

O player embutido não está conseguindo uma superfície de vídeo.

1. Abra ⚙ → Stats for nerds e veja se chegam quadros — isso separa um problema de fluxo de um problema de exibição.
2. No Wayland, tente Configurações → Reprodução → Executar pelo backend X11 e reinicie o aplicativo.
3. Rode a partir de um terminal e procure linhas que citem GL ou mpv.

Ele ainda não é notarizado pela Apple. Clique com o botão direito e escolha Abrir, depois Abrir na caixa de diálogo — ou permita em Ajustes do Sistema → Privacidade e Segurança → Abrir mesmo assim.

Se o macOS disser que o aplicativo está «danificado», isso é o atributo de quarentena posto pelo download. Remova-o:

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

Nenhum dos dois avisos significa que há algo errado com o aplicativo — só que o build não é assinado, o que exige um certificado pago da Apple.

O SmartScreen não reconhece o editor porque o build não é assinado — isso exige um certificado pago. Clique em Mais informações e depois em Executar assim mesmo.

Um falso positivo. Duas das causas foram corrigidas na 1.2.10: o iniciador agora é compilado a partir do código em vez de ser o binário pronto para o qual os antivírus têm assinaturas, e o executável carrega um recurso de versão de verdade.

Se o seu antivírus ainda marcar, libere a pasta nele e relate o falso positivo à Microsoft — é isso que acaba resolvendo para todo mundo, não só para você.

O aplicativo consulta o provedor e diz o motivo em bom português em vez de mostrar um erro seco: conta expirada, limite de conexões atingido, fluxo inexistente, servidor inacessível, e assim por diante.

Se outros canais tocam, é aquele canal. Se nada toca, veja Configurações → Listas — o painel da conta mostra a data de validade e quantas conexões ela permite.

Sua conta permite um certo número de fluxos ao mesmo tempo e todos estão ocupados. Em ordem de probabilidade:

1. O multiview está aberto — cada quadro é uma conexão.
2. Há uma gravação de um canal diferente em andamento.
3. Outro aparelho ou outra pessoa está usando a conta.
4. Uma sessão anterior ainda não expirou no provedor; esperar um minuto costuma resolver.

Gravar o canal que você está assistindo não conta como uma segunda conexão.

No Wayland, GNOME e KDE tiram o ícone de uma janela de uma entrada de desktop correspondente e ignoram o que o próprio programa define. Um AppImage não tem essa entrada até algo instalá-la.

1. O aplicativo se oferece para criar uma na primeira execução. Aceite — e depois reinicie o aplicativo, porque a janela aberta mantém o ícone com que foi aberta.
2. A mesma opção está em Configurações → Reprodução se você tiver recusado.
3. Se o ícone ainda não aparecer, um cache de ícones velho está escondendo-o. O GTK lê esse arquivo em vez da pasta:

rm ~/.local/share/icons/hicolor/icon-theme.cache

Instalado pelo .deb, a entrada já existe e nada disso se aplica.

Essa opção inicia um mpv ou vlc independente do seu sistema, então um dos dois precisa estar instalado — o player embutido não precisa de nada a mais e não é afetado.

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