Os favoritos do Mastodon permitem salvar publicações para revisitar depois. Diferente de curtidas, os favoritos são privados e não são compartilhados com o autor original. Se você mudar de instância ou precisar de um backup local, pode exportar seus favoritos como um arquivo JSON. Este artigo explica como exportar seus favoritos do Mastodon e reaplicá-los em uma nova conta ou após uma reinicialização.
A ferramenta de exportação integrada do Mastodon produz um arquivo que contém todas as suas publicações favoritadas. O arquivo inclui a URL da publicação, o autor e o timestamp. Você pode armazenar esse arquivo para referência pessoal ou usar ferramentas de terceiros para importá-lo de volta em uma conta diferente. No entanto, o Mastodon não oferece um recurso nativo de importação para favoritos. Você precisará usar um script ou um aplicativo web para restaurá-los.
Este guia aborda as etapas exatas para exportar favoritos, as limitações do formato de exportação e os métodos disponíveis para reaplicar favoritos em uma nova conta. Você também aprenderá quais dados são preservados e quais são perdidos durante o processo.
Principais Conclusões: Salvar e Restaurar Favoritos do Mastodon
- Preferências > Importar e exportar > Exportar: Gera um arquivo JSON contendo todas as publicações favoritadas da sua conta atual do Mastodon.
- Ferramenta de Importação de Favoritos do Mastodon (terceiros): Um aplicativo web que lê o arquivo JSON exportado e favorita cada publicação novamente em uma nova conta por meio da API do Mastodon.
- Sem importação nativa no Mastodon: O arquivo de exportação é apenas para backup; você deve usar scripts ou ferramentas externas para restaurar favoritos em uma conta diferente.
Como Funciona a Exportação de Favoritos do Mastodon e Suas Limitações
O Mastodon armazena favoritos como uma lista de IDs de publicações vinculadas à sua conta. Quando você exporta seus dados, o sistema cria um arquivo JSON que contém a URL de cada publicação favoritada, o nome de usuário do autor, o conteúdo da publicação (em texto simples) e o timestamp de quando você a favoritou. Este arquivo é um instantâneo dos seus favoritos no momento da exportação.
O arquivo de exportação não inclui a mídia, incorporações ou contexto completo da thread da publicação original. Ele armazena apenas a URL da publicação e os primeiros 500 caracteres do texto. Isso é suficiente para identificar a publicação, mas não para exibi-la por completo.
A principal limitação é que o Mastodon não oferece uma função de importação nativa para favoritos. Você não pode fazer upload do arquivo JSON de volta para a mesma conta ou para uma conta diferente através da interface web. Para reaplicar favoritos, você deve usar uma ferramenta de terceiros que chame a API do Mastodon para favoritar cada publicação individualmente. Essas ferramentas exigem que você autorize o acesso à sua nova conta e depois processem o arquivo exportado.
Outra limitação é que o arquivo exportado contém apenas publicações que ainda existem no servidor original. Se a publicação original foi excluída pelo autor ou removida da instância, a URL será inválida. A ferramenta de importação pulará essas publicações ou falhará ao favoritá-las.
Etapas para Exportar Favoritos da Sua Conta do Mastodon
Siga estas etapas para baixar um backup completo dos seus favoritos. A exportação inclui todos os outros tipos de dados por padrão, mas você pode selecionar apenas favoritos na interface de exportação.
- Abra a página de Exportação
Na interface web do Mastodon, clique no link Preferências na coluna da direita. Em seguida, selecione Importar e exportar no menu. Clique na aba Exportar no topo da página. - Selecione os tipos de dados a exportar
Role até a seção Exportação de dados. Você verá uma lista de caixas de seleção para diferentes tipos de dados. Marque a caixa Favoritos. Desmarque qualquer outra caixa se quiser apenas favoritos. Se quiser um backup completo, deixe todas as caixas marcadas. - Gere o arquivo de exportação
Clique no botão Exportar. O Mastodon criará um arquivo CSV para cada tipo de dado selecionado. O arquivo de favoritos é nomeado bookmarks.csv. Seu navegador baixará o arquivo automaticamente. - Salve o arquivo com segurança
Armazene o arquivo CSV baixado em um local seguro. O arquivo contém URLs públicas de publicações e seu nome de usuário do Mastodon. Ele não contém sua senha ou tokens de acesso.
O arquivo CSV exportado tem colunas para URL, Conta, Criado em e Conteúdo. A coluna URL contém o link completo para a publicação favoritada. A coluna Conteúdo contém os primeiros 500 caracteres do texto da publicação.
Etapas para Reaplicar Favoritos em uma Conta Diferente do Mastodon
Como o Mastodon não possui uma importação nativa de favoritos, você deve usar uma ferramenta de terceiros. O método mais confiável é a Ferramenta de Importação de Favoritos do Mastodon hospedada em mastodon-bookmark-import.glitch.me. Esta ferramenta lê seu arquivo CSV exportado e usa a API do Mastodon para favoritar cada publicação na sua nova conta.
- Prepare o arquivo CSV exportado
Certifique-se de ter o arquivo bookmarks.csv da etapa de exportação. Não modifique o arquivo. A ferramenta espera a estrutura exata de colunas que o Mastodon produz. - Abra a ferramenta de importação no navegador
Navegue até mastodon-bookmark-import.glitch.me. Este é um aplicativo web mantido pela comunidade. Ele não armazena seus dados. Todo o processamento ocorre no seu navegador. - Autorize a ferramenta a acessar sua nova conta
Clique no botão Log in with Mastodon. Digite o domínio da sua nova instância do Mastodon (por exemplo, mastodon.social). Clique em Authorize. A ferramenta solicitará permissão para ler e escrever seus favoritos. Conceda a permissão. - Faça upload do arquivo CSV exportado
Após a autorização, você verá uma área de upload de arquivo. Clique em Choose File e selecione seu arquivo bookmarks.csv. A ferramenta analisará o arquivo e exibirá uma prévia das publicações encontradas. - Inicie o processo de importação
Clique no botão Import Bookmarks. A ferramenta processará cada URL uma por uma. Ela pulará qualquer publicação que não exista mais ou que pertença a uma instância bloqueada. O processo pode levar vários minutos se você tiver muitos favoritos. - Verifique os favoritos importados
Após a importação ser concluída, vá para sua nova conta do Mastodon. Abra a seção Favoritos no menu do seu perfil. Você deve ver todas as publicações que foram importadas com sucesso. Publicações que falharam devido a exclusão ou inacessibilidade não aparecerão.
Se preferir uma abordagem de linha de comando, você pode usar o script Python mastodon-bookmark-import disponível no GitHub. Este script requer que você gere um token de acesso nas configurações da sua conta do Mastodon e execute o script localmente.
Problemas Comuns com Exportação e Reaplicação de Favoritos
Arquivo CSV exportado está vazio ou sem favoritos
Se o arquivo CSV exportado não contiver linhas, você pode não ter favoritos na sua conta. Verifique seus favoritos abrindo a seção Favoritos na interface web do Mastodon. Se você vir favoritos lá, tente a exportação novamente. Certifique-se de ter marcado a caixa Favoritos antes de clicar em Exportar.
A ferramenta de importação mostra erro: formato de arquivo inválido
A ferramenta de importação espera o formato CSV exato do Mastodon. Se você editou o arquivo ou o abriu em um programa de planilha que alterou a formatação, a ferramenta pode rejeitá-lo. Baixe uma exportação nova e faça upload sem modificações. Não altere a extensão do arquivo ou a ordem das colunas.
Alguns favoritos estão faltando após a importação
Publicações que foram excluídas pelo autor original ou removidas da instância não serão importadas. A ferramenta de importação tenta buscar cada URL. Se o servidor retornar um erro 404 ou 410, a ferramenta pula essa publicação. Isso é comportamento esperado. Você pode verificar o log de importação na ferramenta para ver quais URLs falharam.
A autorização falha para a ferramenta de importação
Algumas instâncias do Mastodon bloqueiam aplicativos de terceiros de criar tokens de acesso. Se você vir um erro durante a autorização, verifique as políticas de moderação da sua instância. Talvez seja necessário usar uma ferramenta diferente ou executar o script localmente com um token de acesso pessoal. Para gerar um token, vá em Preferências > Desenvolvimento > Nova aplicação, conceda os escopos read:bookmarks e write:bookmarks e copie o token de acesso.
Exportação de Favoritos do Mastodon vs Ferramenta de Importação de Terceiros
| Item | Exportação Nativa | Ferramenta de Importação de Terceiros |
|---|---|---|
| Propósito | Fazer backup dos favoritos em um arquivo local | Restaurar favoritos em uma conta diferente |
| Formato do arquivo | CSV com colunas: URL, Conta, Criado em, Conteúdo | Lê o mesmo arquivo CSV |
| Requer autorização | Não | Sim, token OAuth da nova conta |
| Lida com publicações excluídas | Exporta a URL independentemente da existência da publicação | Pula publicações que retornam 404 ou 410 |
O Mastodon não fornece importação nativa para favoritos. A exportação é um backup unidirecional. Para mover favoritos para uma nova conta, você deve contar com ferramentas da comunidade. Sempre teste a importação em um conjunto pequeno de favoritos antes de processar um arquivo grande.
Após importar seus favoritos com sucesso, você pode organizá-los usando as categorias de favoritos integradas do Mastodon. Para criar uma categoria, abra a seção Favoritos, clique no menu de três pontos em uma publicação favoritada e selecione Adicionar à categoria. Esse recurso ajuda a agrupar favoritos por tópico. Você também pode usar a barra de pesquisa na seção Favoritos para filtrar publicações por palavra-chave.
Se você planeja migrar de instância com frequência, considere usar um serviço de gerenciamento de favoritos que sincronize com o Mastodon via API. Serviços como Bookmarky ou Raindrop.io podem salvar automaticamente favoritos de várias contas do Mastodon. No entanto, esses serviços exigem autorização contínua e podem não ser adequados para usuários preocupados com privacidade.
Para usuários avançados, a API do Mastodon permite escrever um script personalizado que exporta e importa favoritos no formato de sua preferência. Você pode usar o endpoint GET /api/v1/bookmarks para buscar todos os favoritos e o endpoint POST /api/v1/statuses/:id/bookmark para adicioná-los. Isso oferece controle total sobre o processo e permite lidar com erros de forma mais precisa do que uma ferramenta genérica.