Ao migrar sua conta do Mastodon de uma instância para outra, seus seguidores e configurações acompanham o processo. As listas, porém, não são transferidas automaticamente. Isso deixa o painel de Listas vazio na nova instância, mesmo com as contas seguidas já presentes. Neste artigo, você aprenderá os passos exatos para exportar suas listas existentes da instância antiga e importá-las na nova usando as ferramentas nativas do Mastodon.
O Mastodon armazena listas localmente no banco de dados de cada instância. O procedimento de mover conta transfere apenas seu perfil, seguidores e contas seguidas. As listas são tratadas como dados organizacionais privados que a plataforma não carrega. Recriá-las manualmente para dezenas de contas é tedioso e sujeito a erros. O método descrito aqui usa exportação e importação CSV para reconstruir suas listas em menos de dez minutos.
Este guia se aplica ao Mastodon versão 4.0 ou superior. Os recursos de exportação e importação estão disponíveis tanto na interface web quanto na maioria dos aplicativos móveis. Você precisa ter acesso tanto à conta antiga quanto à nova durante o processo. Nenhuma ferramenta de terceiros ou acesso à API é necessário.
Principais Conclusões: Reconstruindo Listas do Mastodon Após Migração de Instância
- Preferências > Importar e exportar > Exportar: Baixa um arquivo CSV contendo todas as contas seguidas agrupadas por nome de lista da sua instância antiga.
- Edição do arquivo CSV: Remova o cabeçalho da coluna Lista e linhas duplicadas para produzir um arquivo de importação limpo para a nova instância.
- Preferências > Importar e exportar > Importar: Envia o arquivo CSV editado para recriar suas listas na nova instância com as associações corretas.
Como as Listas do Mastodon Funcionam e Por Que Não Migram
As listas do Mastodon são agrupamentos privados de contas que você segue. Elas permitem filtrar a linha do tempo inicial para mostrar apenas postagens de grupos específicos, como “Equipe” ou “Notícias”. Cada lista é armazenada como um registro no banco de dados da instância vinculado ao seu ID de usuário. Quando você inicia uma Mudança de conta diferente em Preferências > Conta, a instância antiga e a nova trocam dados através do protocolo ActivityPub. Esse handshake transfere seu perfil, nome de exibição, biografia, avatar, imagem de cabeçalho e todas as contas que você segue. As listas são excluídas do protocolo porque não fazem parte do perfil público. Elas são consideradas preferências locais que cada instância gerencia de forma independente.
O recurso de exportação no Mastodon produz um arquivo CSV que contém suas listas e as contas em cada lista. O arquivo usa três colunas: Nome da lista, Endereço da conta e URL da conta. Este arquivo é a chave para recriar suas listas na nova instância. O recurso de importação na nova instância lê o mesmo formato CSV e cria as listas automaticamente.
Guia Passo a Passo para Exportar, Editar e Importar Listas
Você precisa realizar três etapas: exportar o CSV da instância antiga, editar o CSV para remover cabeçalhos incompatíveis e importar o CSV editado na nova instância. Conclua todas as etapas antes de sair permanentemente da conta antiga.
Etapa 1: Exportar Listas e Seguidos da Instância Antiga
- Faça login na sua conta antiga do Mastodon
Abra a URL da instância onde sua conta está atualmente. Insira seu e-mail e senha para acessar a linha do tempo inicial. - Abra o menu Preferências
Clique no ícone de engrenagem na coluna direita da interface web ou navegue até o link Preferências no menu suspenso do seu perfil. - Selecione Importar e exportar
No painel de navegação esquerdo, clique na opção Importar e exportar. Esta página contém as seções de exportação e importação. - Clique no botão Exportar para Listas
Localize a seção chamada Exportar. Clique no botão Listas. Seu navegador baixa um arquivo chamado lists.csv. - Verifique o conteúdo do arquivo CSV
Abra o arquivo lists.csv baixado com um editor de texto ou planilha. Confirme que a primeira linha mostra List name,Account address,Account URL. Cada linha subsequente contém um nome de lista e o endereço da conta seguida correspondente.
Etapa 2: Editar o Arquivo CSV para Compatibilidade de Importação
- Remova a linha de cabeçalho do CSV
Exclua a primeira linha que contém List name,Account address,Account URL. O recurso de importação na nova instância espera apenas linhas de dados, sem cabeçalho. - Remova entradas de conta duplicadas
Se a mesma conta aparecer em várias listas, o processo de importação criará várias linhas para essa conta. Isso é aceitável porque a importação do Mastodon lida com duplicatas sem erros. No entanto, se preferir evitar processamento redundante, exclua as linhas duplicadas agora. - Salve o arquivo editado como um novo CSV
Use o comando Salvar como no seu editor. Nomeie o arquivo como lists-import.csv. Certifique-se de que a extensão do arquivo seja .csv e a codificação seja UTF-8.
Etapa 3: Importar o CSV Editado na Nova Instância
- Faça login na sua nova conta do Mastodon
Abra a URL da instância onde você criou sua nova conta. Insira suas credenciais para acessar a linha do tempo inicial. - Abra o menu Preferências na nova instância
Clique no ícone de engrenagem na coluna direita e depois clique em Importar e exportar no painel de navegação esquerdo. - Escolha o tipo de importação Listas
Na seção Importar, localize o menu suspenso chamado Tipo de importação. Selecione Listas no menu. - Selecione o arquivo CSV editado
Clique no botão Procurar ou Escolher arquivo. Navegue até o arquivo lists-import.csv que você salvou anteriormente. Selecione-o e confirme. - Clique no botão Enviar
Pressione o botão Enviar para iniciar a importação. O Mastodon processa o arquivo e cria as listas na sua nova conta. Uma mensagem de confirmação aparece quando a importação é concluída. - Verifique as listas na sua nova conta
Navegue até o painel de Listas a partir da linha do tempo inicial. Clique no ícone de Listas na barra lateral esquerda. Você deve ver todas as suas listas originais com as associações de conta corretas.
Erros Comuns e Limitações ao Recriar Listas
Arquivo CSV contém linha de cabeçalho que causa falha na importação
A função de importação de listas do Mastodon espera apenas linhas de dados. Se a primeira linha contiver cabeçalhos de coluna, a importação pulará essa linha e a tratará como uma entrada de lista. Isso pode criar uma lista chamada “List name” sem membros válidos. Sempre exclua a linha de cabeçalho antes de enviar.
Contas ainda não seguidas na nova instância
A importação de listas só adiciona contas que já existem na sua lista de seguidos na nova instância. Se você migrou sua conta usando o procedimento de Mudança, suas contas seguidas são transferidas automaticamente. Se você criou uma conta nova sem migração, primeiro siga as contas antes que a importação de listas possa atribuí-las às listas. Use a função Seguir padrão ou importe um CSV de seguidos antes de importar listas.
Nomes de lista com caracteres especiais causam erros de análise
Os nomes de lista do Mastodon podem conter letras, números, espaços e sublinhados. Nomes com vírgulas, aspas ou quebras de linha quebram o formato CSV. Se suas listas originais contiverem tais caracteres, renomeie-os no arquivo CSV antes da importação. Substitua vírgulas por espaços e remova aspas.
Exportação de Listas do Mastodon vs Recriação Manual
| Item | Exportação e Importação CSV | Recriação Manual |
|---|---|---|
| Tempo necessário | 5 a 10 minutos | 30 minutos a várias horas, dependendo do tamanho da lista |
| Risco de erro | Baixo se o CSV for editado corretamente | Alto devido a contas perdidas ou duplicatas acidentais |
| Requer acesso à instância antiga | Sim, para exportar o CSV | Não, mas você precisa lembrar de todas as associações de lista |
| Suporta múltiplas listas | Sim, todas as listas são exportadas de uma vez | Sim, mas cada lista deve ser criada individualmente |
| Lida com renomeações de conta | Usa endereços de conta que permanecem válidos após a migração | Requer busca manual por contas renomeadas |
O método CSV é significativamente mais rápido e confiável para usuários que mantêm mais de três listas. A recriação manual só é prática para usuários com uma ou duas listas contendo menos de dez contas no total.
Agora você pode recriar suas listas do Mastodon em qualquer nova instância usando as ferramentas de exportação e importação integradas à plataforma. Todo o processo leva menos de dez minutos e preserva a estrutura de agrupamento exata que você tinha antes da migração. Na próxima vez que mudar de instância, execute a exportação antes de iniciar o procedimento de Mudança para garantir que você tenha os dados de lista mais recentes. Para listas grandes com mais de 100 contas, considere dividir o CSV em arquivos menores de 500 linhas cada para evitar erros de tempo limite durante a importação.