Como Reimportar Favoritos do Mastodon Após Migração de Conta

Quando você move sua conta do Mastodon para uma nova instância, seus favoritos não acompanham automaticamente. A ferramenta de migração transfere seguidores, seguidos e configurações de perfil, mas os favoritos ficam armazenados localmente em cada instância e não fazem parte do handshake padrão do Move. Este artigo explica como exportar seus favoritos da conta antiga e importá-los na nova conta para não perder posts salvos.

O Mastodon armazena favoritos como uma lista de URIs de posts que apontam para conteúdo no fediverso. Como cada instância mantém seu próprio banco de dados de favoritos, uma migração não os copia. Você precisa usar a ferramenta oficial de Exportação para criar um arquivo CSV com seus favoritos e depois usar a ferramenta de Importação na nova conta para carregá-los de volta. O processo leva cerca de cinco minutos e exige acesso a ambas as contas.

Este guia mostra as etapas exatas para exportar favoritos da instância antiga, importá-los na nova instância e verificar se cada post salvo reaparece. Também cobre problemas comuns, como colunas CSV ausentes e URIs obsoletas que podem não resolver após a migração.

Por que os Favoritos do Mastodon Não Sobrevivem à Migração de Conta

O recurso de migração de conta do Mastodon foi projetado para mover seu grafo social — seguidores, seguidos e listas — mas exclui deliberadamente os favoritos. O handshake do Move usa a atividade Move do ActivityPub, que transfere apenas relacionamentos entre atores. Favoritos não fazem parte do padrão ActivityPub; cada instância os armazena em sua própria tabela de banco de dados local chamada bookmarks.

Quando você inicia um Move, a instância antiga envia uma mensagem para cada seguidor dizendo: “Esta conta agora está em @user@novainstancia.social.” A nova instância então copia a lista de contas que você segue. Favoritos, no entanto, são uma coleção privada de IDs de posts que não têm um protocolo de federação padronizado. Os desenvolvedores do Mastodon optaram por deixá-los de fora da migração para manter o processo Move simples e previsível.

A única maneira de transferir favoritos é através do sistema de exportação e importação de dados, que lida com arquivos CSV. Esse sistema é separado da ferramenta Move e deve ser executado manualmente antes de você perder acesso à conta antiga. Você pode exportar favoritos da instância antiga mesmo depois de iniciar o Move, desde que ainda tenha credenciais de login.

Passos para Exportar e Importar Favoritos do Mastodon

Complete estas etapas enquanto ainda tem acesso a ambas as contas. A etapa de exportação exige que você esteja logado na instância antiga. A etapa de importação exige que você esteja logado na nova instância. Se você já perdeu acesso à conta antiga, não é possível recuperar os favoritos — não há backup no servidor para eles.

Exportar Favoritos da Conta Antiga do Mastodon

1. Faça login na instância antiga e abra Preferências
   Na sua conta antiga do Mastodon, clique no ícone de engrenagem no canto superior direito da interface web. O ícone é rotulado como “Preferências” ao passar o mouse.
2. Navegue até Importar e Exportar
   Na barra lateral esquerda, clique em Importar e Exportar. Esta página tem duas seções: Exportar e Importar. Comece com Exportar.
3. Gere o arquivo CSV de favoritos
   Clique na aba Exportar se não estiver selecionada. Encontre a linha rotulada como Favoritos e clique no botão Exportar ao lado dela. O Mastodon cria um arquivo CSV chamado bookmarks.csv e o baixa para o seu computador.
4. Verifique o conteúdo do arquivo CSV
   Abra o arquivo baixado em um editor de texto ou planilha. O arquivo deve conter uma linha de cabeçalho com #uri e uma ou mais linhas com URIs de posts. Cada URI se parece com https://instancia.social/@usuario/123456. Se o arquivo estiver vazio ou sem linhas, repita a etapa de exportação.

Importar Favoritos na Nova Conta do Mastodon

1. Faça login na nova instância e abra Preferências
   Vá para sua nova conta do Mastodon e clique no ícone de engrenagem para abrir Preferências.
2. Vá para Importar e Exportar
   Clique em Importar e Exportar na barra lateral esquerda. Desta vez, selecione a aba Importar.
3. Escolha o arquivo CSV de favoritos
   Clique no botão Procurar e selecione o arquivo bookmarks.csv que você exportou anteriormente. Certifique-se de que o menu suspenso de tipo de arquivo mostre “CSV” e a opção de mesclagem esteja definida como Mesclar — isso adiciona os favoritos importados a quaisquer outros que você já tenha salvado.
4. Inicie a importação
   Clique no botão Enviar. O Mastodon processa o arquivo em segundo plano. Uma barra de progresso aparece no topo da página. Não feche a aba do navegador até que a barra desapareça.
5. Aguarde a conclusão da importação
   Listas grandes de favoritos podem levar vários minutos. Você pode verificar o progresso atualizando a página de Importação. Quando a importação terminar, um banner verde confirma o sucesso. Seus favoritos agora aparecem na lista de favoritos da sua nova conta, acessível pelo ícone de estrela.

Problemas Comuns ao Reimportar Favoritos do Mastodon

Arquivo CSV de Favoritos Não Contém Linhas Após a Exportação

Se o arquivo CSV exportado tiver apenas a linha de cabeçalho e nenhum dado, você pode ter selecionado a opção de exportação errada. O Mastodon exporta favoritos separadamente de seguidos e listas. Verifique se você clicou no botão Exportar ao lado de Favoritos, não no botão ao lado de Lista de seguidos ou Listas. Se o arquivo ainda estiver vazio, sua conta antiga pode ter zero favoritos. Verifique abrindo a visualização de favoritos (ícone de estrela) na conta antiga antes de exportar.

Importação Falha com Erro de “Conflito de mesclagem”

A ferramenta de importação do Mastodon não aceita URIs duplicadas. Se você importou favoritos anteriormente de um arquivo diferente, algumas URIs podem já existir na sua nova conta. A opção de mesclagem ignora duplicatas, mas um CSV mal formatado com colunas extras pode fazer o parser falhar. Abra o arquivo CSV e confirme que ele contém exatamente uma coluna chamada #uri sem vírgulas extras ou quebras de linha. Remova quaisquer linhas que não sejam URIs de post válidas.

Posts Favoritados Não Aparecem Após a Importação

Uma importação bem-sucedida adiciona a URI à sua lista de favoritos, mas o post pode não carregar se a instância original estiver offline ou o post tiver sido excluído. O Mastodon mostra uma mensagem de placeholder na visualização de favoritos para posts indisponíveis. Se o post for de uma instância defederada, ele também pode ficar oculto. Você pode remover favoritos obsoletos manualmente clicando novamente no ícone de favorito na nova conta.

Botão de Importação Desabilitado

O Mastodon impõe um intervalo de três dias entre importações. Se você importou um arquivo recentemente, o botão permanece desabilitado até que o intervalo expire. Verifique a página de Importação por uma mensagem que diz “Você pode importar novamente em X dias.” Aguarde o tempo especificado antes de tentar novamente. Para evitar isso, combine todos os dados que deseja importar em um único arquivo CSV antes de enviar.

Item	Exportar da Instância Antiga	Importar na Nova Instância
Formato do arquivo	CSV com coluna #uri	Mesmo arquivo CSV, sem modificações necessárias
Tempo necessário	Menos de 1 minuto	1 a 5 minutos, dependendo do tamanho do arquivo
Acesso necessário	Login ativo na instância antiga	Login ativo na nova instância
Intervalo	Nenhum	3 dias entre importações
Comportamento de mesclagem	N/A	Ignora URIs duplicadas, adiciona novas

Agora você pode restaurar todos os seus favoritos do Mastodon após uma migração de conta usando as ferramentas de Exportar e Importar em Preferências. Execute a exportação antes de perder acesso à instância antiga e use a opção Mesclar na nova conta para evitar duplicatas. Para coleções grandes de favoritos, combine todos os arquivos CSV em um antes de importar para contornar o intervalo de três dias. Após a importação, abra a visualização de favoritos na nova conta e verifique se os primeiros posts carregam corretamente.