Como adicionar lista IPTV (M3U e Xtream Codes) no Quick Player

Como funciona uma lista IPTV no Quick Player

Uma lista IPTV é o arquivo (ou link) que diz ao Quick Player quais canais existem, onde buscar o stream de cada um e como autenticar no servidor. Sem lista, o app abre vazio. Com lista válida, você tem TV ao vivo, filmes e séries em segundos.

O Quick Player aceita dois formatos: Xtream Codes API (host, porta, usuário e senha separados) e URL M3U (um único link http://...get.php?...). Os dois apontam para o mesmo servidor — muda só o jeito de entregar a informação. Se você ainda não instalou o app, comece pelo guia de instalação do Quick Player e depois volte pra cá.

Xtream Codes vs M3U: qual escolher

Quase todo mundo pergunta isso na primeira configuração. Resposta curta: se o painel te der os dois, use Xtream. Resposta longa, na tabela:

Critério	Xtream Codes API	URL M3U
Categorias separadas (TV / Filmes / Séries)	Sim, nativo	Tudo misturado em grupos
EPG (guia de programação)	Puxa automático	Precisa link XMLTV separado
Capas de filmes e séries	Sim	Raramente
Velocidade pra abrir o app	Mais rápido (paginado)	Lento se a lista for grande
Renovação de credenciais	Automática	Manual, troca o link inteiro
Compatível com qualquer servidor	Só servidores Xtream	Sim, qualquer um

Na prática, 9 em cada 10 painéis IPTV brasileiros rodam Xtream Codes. Use M3U só se o provedor explicitamente disser que não tem API.

Método 1: Xtream Codes API — passo a passo

Tenha em mãos os quatro dados que o provedor mandou: host (sem http:// às vezes vem com), porta, usuário e senha. Se você ainda não tem, o pessoal manda em 5 minutos pelo WhatsApp 11 99958-6826.

1. Abra o Quick Player na TV ou no celular. Na tela inicial você vai ver "Adicionar playlist" ou o ícone de "+". Selecione.
2. Escolha "Xtream Codes" entre as opções (vai aparecer junto com "M3U URL" e "M3U arquivo").
3. Nome da playlist: digite qualquer coisa que te ajude a identificar — "Casa", "Sala", "IPTV Pai". Esse nome só aparece pra você.
4. Host (server URL): cole exatamente como o provedor enviou. Exemplo: http://meuservidor.xyz:8080. Se o campo for separado, coloque meuservidor.xyz em "host" e 8080 em "porta".
5. Usuário e senha: copie e cole, nunca digite. Caractere errado em senha é o erro número um de quem tenta no manual.
6. Salvar e conectar. O Quick Player vai bater no servidor, baixar as categorias e listar canais, filmes e séries em até 30 segundos. Se travar nessa tela por mais de 1 minuto, a credencial tá errada ou o servidor caiu.

Método 2: URL M3U — passo a passo

Mesma ideia, menos campos. Mas perde EPG nativo e capas.

1. Adicionar playlist > M3U URL dentro do app.
2. Cole a URL inteira. Ela vai ser parecida com http://servidor.xyz:8080/get.php?username=SEUUSER&password=SUASENHA&type=m3u_plus&output=ts. Sem cortar nada depois do "ts".
3. Dê um nome e salve.
4. Aguarde a importação. Listas grandes (15 mil+ canais) podem levar 2 minutos no primeiro carregamento. Depois fica cacheado e abre rápido.

Dica: se o provedor te mandou um arquivo .m3u em vez de URL, suba ele num Google Drive, gere o link direto e use como URL. O Quick Player prefere URL — arquivo local complica atualização.

Anatomia da URL Xtream (host:porta, user, pass)

Saber o que cada pedaço significa resolve 80% dos problemas de configuração sozinho.

Pegue uma URL M3U típica:

http://meuiptv.tv:25461/get.php?username=joao123&password=abc789&type=m3u_plus

• http://meuiptv.tv — é o host. Pode ser domínio (meuiptv.tv) ou IP puro (45.67.89.10). Os dois funcionam.
• :25461 — é a porta. Quase sempre é 8080, 25461, 8880 ou 80. Se o provedor não falou, é 80 (padrão HTTP).
• username=joao123 — usuário. Sensível a maiúscula/minúscula. Joao123 ≠ joao123.
• password=abc789 — senha. Mesmo cuidado.

Quando o app pede "Xtream Codes", você quebra essa URL nos pedaços e cola cada um no campo certo. http://meuiptv.tv:25461 vai inteiro no host (com http e porta), ou separado dependendo do app.

EPG / Guia de programação: como configurar XMLTV

EPG é o que mostra "o que está passando agora" e "o que vem depois" em cada canal. No Xtream Codes, o Quick Player puxa sozinho — não precisa fazer nada.

No M3U, você precisa adicionar o link XMLTV manualmente. Vá em Configurações > EPG > Adicionar fonte XMLTV e cole a URL que o provedor mandou. Geralmente é algo tipo http://servidor.xyz:8080/xmltv.php?username=SEUUSER&password=SUASENHA.

Depois disso, vá em Atualizar EPG agora. Primeira atualização demora — é normal. Programe pra atualizar 1x por dia, de madrugada, e esquece.

Se o canal aparece mas o guia fica em branco, o problema é casamento de ID. Cada canal no XMLTV tem um tvg-id que precisa bater com o ID na lista. Quando não bate, o EPG existe mas não cola no canal certo. Solução: trocar de provedor de EPG ou pedir pro suporte enviar o XMLTV correto da sua lista.

Lista inválida / expirada — 5 erros e soluções

Esses são os erros que aparecem 9 em cada 10 vezes:

1. "Invalid credentials" ou "Login failed" — usuário ou senha errados. Copie e cole de novo, atento a espaços no fim. Se persistir, sua linha expirou — fale com o provedor.
2. "Connection timeout" — servidor fora do ar ou porta bloqueada pelo seu provedor de internet (Vivo e Claro às vezes filtram). Teste num 4G do celular. Se funciona no 4G e não no Wi-Fi, é bloqueio da operadora — use DNS 1.1.1.1 ou VPN.
3. "Max connections reached" — sua credencial está logada em outro aparelho. Cada linha aceita 1 conexão simultânea por padrão. Saia do outro app antes de abrir aqui.
4. Lista carrega mas canais não abrem — geralmente codec. Vá em Configurações > Player e troque de "Hardware" pra "Software" (ou vice-versa). Resolve em smart TVs antigas.
5. EPG vazio mesmo no Xtream — cache corrompido. Configurações > Limpar cache EPG > Atualizar. Volta no ar.

Onde conseguir credenciais (teste grátis)

Pra configurar você precisa de credenciais ativas. Se ainda não tem, peça um teste grátis do Quick Player IPTV — manda Xtream e M3U, você decide qual usar. Chega no WhatsApp em até 5 minutos: 11 99958-6826.

Quem já testou e quer destravar definitivo, é só fazer a ativação anual que a mesma credencial continua funcionando — não precisa reconfigurar o app.

Perguntas frequentes

Posso colocar duas listas IPTV no mesmo Quick Player?

Sim. Adicione cada uma como playlist separada. O app mostra um seletor na tela inicial pra trocar entre elas sem reconfigurar.

A lista Xtream funciona em mais de uma TV ao mesmo tempo?

Depende do plano. A maioria das linhas vem com 1 conexão. Se você quer assistir na sala e no quarto juntos, peça uma linha com 2 conexões ou contrate duas linhas.

Quick Player atualiza a lista sozinho?

Xtream sim, em tempo real. M3U precisa de "atualizar playlist" manual ou agendado em Configurações > Atualização automática > A cada 24h.

Preciso de internet rápida pra rodar IPTV no Quick Player?

10 Mbps estáveis pra SD, 25 Mbps pra Full HD, 50 Mbps pra 4K. Wi-Fi ruim mata IPTV antes da velocidade — cabo de rede sempre que possível.

Minha lista parou do nada depois de uma semana. Por quê?

Três causas comuns: teste grátis expirou, servidor mudou de porta, ou seu provedor de internet começou a bloquear. Confirma com o suporte do provedor antes de trocar o app.

Pronto pra ativar? Fala com a gente

Se travou em algum passo, ou se quer pular tudo isso e receber a lista já formatada pra colar, chama no WhatsApp 11 99958-6826. Manda "Quero teste Quick Player" e em 5 minutos você recebe Xtream + M3U + XMLTV. Configurar leva mais 2 minutos seguindo os passos aqui de cima.

Quem prefere já ir direto pra linha definitiva, a ativação anual sai com desconto e mesma credencial vale na TV, no celular e no tablet.