Como adicionar sua lista IPTV no iPhone e iPad

Você contratou um serviço IPTV, recebeu um punhado de dados — uma URL, um usuário, uma senha, ou talvez só um link terminado em .m3u — e agora precisa transformar isso em canais, filmes e séries na tela do iPhone. Essa é a parte que costuma travar quem está começando: não porque seja difícil, mas porque cada player chama as mesmas coisas por nomes diferentes.

Este guia mostra o processo completo no Nebula Player, com as telas reais do app. São três caminhos possíveis — Xtream Codes, URL M3U e arquivo M3U — e a diferença entre eles muda o que você precisa ter em mãos e como a lista se comporta depois. No fim, um atalho que resolve tudo em um toque e o que checar quando algo não carrega.

Antes de começar: o que você precisa ter em mãos

Tudo depende do formato que seu provedor autorizado entregou. Vale conferir antes de abrir o app, porque os dois formatos pedem informações diferentes e não são intercambiáveis — uma URL de lista M3U não funciona no campo de Xtream Codes, e vice-versa.

• Xtream Codes: a URL do servidor (algo como http://servidor.com:8080), o usuário e a senha da sua conta.
• Lista M3U por URL: o endereço completo da lista, geralmente terminado em .m3u ou .m3u8.
• Lista M3U por arquivo: o arquivo .m3u ou .m3u8 salvo no iPhone, no iCloud Drive ou em outro app de arquivos.

Passo 1: abrir a tela de novo perfil

Ao abrir o app pela primeira vez, você cai na tela “Quem vai assistir?”. É a mesma lógica dos serviços de streaming que você já conhece: cada perfil guarda uma lista, com seus próprios favoritos e histórico. Toque no botão “+” para criar o primeiro.

A tela “Novo perfil” reúne tudo em um lugar só: o avatar (que você troca no ícone de lápis), o nome do perfil e, logo abaixo, a configuração da lista. Não existe um menu escondido em Ajustes — é tudo aqui.

Passo 2: escolher o tipo de lista

Em “Tipo de lista” você escolhe entre “Xtream Codes” e “Lista M3U”. Essa escolha define quais campos aparecem em seguida, então vale entender a diferença antes de tocar.

Xtream Codes é uma API: o app conversa com o servidor e recebe as categorias, os metadados, a divisão entre canais, filmes e séries, e o guia de programação já organizados. Uma lista M3U é um arquivo de texto com os canais em sequência — funciona bem, mas carrega menos informação estruturada. Quando o provedor oferece os dois, o Xtream Codes costuma render uma navegação mais rica.

Passo 3: conectar por Xtream Codes

Com “Xtream Codes” selecionado, aparecem três campos: URL, Usuário e Senha. Preencha exatamente como o provedor enviou, sem adaptar nada.

O erro mais comum aqui é no campo URL. Ele espera apenas o endereço do servidor com a porta — por exemplo, http://servidor.com:8080. Se você colar a URL completa que alguns provedores mandam, com /player_api.php ou /get.php e os parâmetros de usuário e senha no final, a conexão falha. Nesse caso, apague tudo depois da porta e distribua o usuário e a senha nos campos próprios.

Passo 3, alternativa: adicionar uma lista M3U

Se você escolher “Lista M3U”, aparece um segundo seletor: “URL” ou “Arquivo”. As duas opções chegam ao mesmo lugar, mas se comportam de formas bem diferentes no dia a dia.

Por URL

É a opção recomendada. Cole o endereço completo no campo “URL da lista” — o próprio app mostra o formato esperado como exemplo, algo como http://exemplo.com/lista.m3u. Como o app consulta esse endereço, quando o provedor adicionar ou remover canais, a atualização chega até você sem precisar refazer nada.

Por arquivo

Escolha “Arquivo” quando você tem o .m3u salvo no aparelho e não uma URL. Toque em “Selecionar arquivo M3U”, escolha o arquivo pelo seletor do iOS — ele enxerga o que está no iPhone, no iCloud Drive e em outros serviços conectados ao app Arquivos — e o nome aparece confirmado na tela.

O próprio app avisa da limitação: o arquivo é copiado para dentro dele. Isso significa que a lista fica congelada no estado em que estava no momento da importação. Se o provedor mudar o catálogo depois, você precisa importar o arquivo novo manualmente. Por isso, sempre que existir a opção por URL, ela é a melhor escolha.

Passo 4: criar o perfil

Dê um nome ao perfil, confira os dados e toque em “Criar perfil”. O app valida o acesso e começa a carregar o catálogo. Listas grandes levam alguns segundos nessa primeira carga — é o momento em que o app organiza os canais, separa filmes e séries e busca os dados complementares de cada título.

O atalho: adicionar a lista por link

Existe um caminho mais curto para acessos Xtream Codes. O Nebula Player aceita um link que já chega com os dados preenchidos, no formato https://link.nebulaplayer.com.br/create-profile?url=SERVIDOR&username=USUARIO&password=SENHA, substituindo cada parte pelos seus próprios dados.

Ao abrir esse link no iPhone com o app instalado, a tela de novo perfil aparece com os campos já preenchidos — você só confirma. É especialmente útil para quem tem mais de um aparelho e não quer digitar credenciais longas em cada um: monte o link uma vez e abra-o nos outros dispositivos.

Só quer conhecer o app antes?

Na mesma tela de novo perfil existe a chave “Conta Demo”. Ela cria um perfil com conteúdo fictício, feito apenas para demonstrar as funcionalidades do app — navegação, busca, favoritos, player. É a forma de ver como o Nebula Player funciona antes de colocar seus dados reais, e não substitui uma lista.

A lista não carregou? o que verificar

Se o perfil não é criado ou o catálogo vem vazio, a causa quase sempre está em um destes pontos:

• Espaço invisível no começo ou no fim dos campos — comum ao copiar e colar de mensagens; apague e digite novamente se desconfiar.
• A URL do Xtream com /player_api.php, /get.php ou uma barra sobrando no final; deixe só o endereço com a porta.
• http:// no lugar de https:// (ou o contrário) — confira o que o provedor informou.
• Credenciais expiradas ou limite de conexões simultâneas atingido; nesse caso, o problema está no provedor, não no app.
• URL de lista M3U que exige login em navegador antes de baixar o arquivo — o app não consegue passar por essa etapa.

Se a lista carrega mas a imagem trava durante a reprodução, aí o assunto é outro: a origem costuma estar na conexão ou no servidor, não na configuração do perfil.

Mais de uma lista no mesmo aparelho

Como cada perfil guarda uma lista, você pode repetir o processo quantas vezes quiser: um perfil por lista, ou um perfil para cada pessoa da casa a partir da mesma lista. Favoritos, histórico e continuar assistindo ficam separados por perfil, o que evita que a recomendação de um interfira na do outro.