Exportar e Reimportar Favoritos do Mastodon: Guia Passo a Passo

Você salvou posts no Mastodon para ler depois. Agora precisa mover esses favoritos para uma nova instância ou manter um backup local. O Mastodon não sincroniza favoritos entre instâncias automaticamente. Este guia mostra como exportar seus favoritos como um arquivo CSV e reimportá-los em outra conta do Mastodon para manter cada post salvo.

Os favoritos são armazenados por conta em uma única instância. Ao mudar de instância ou criar uma nova conta, seus favoritos ficam para trás. A ferramenta de exportação nas configurações do Mastodon permite baixar um arquivo CSV contendo a URL e o autor de cada post favoritado. Você pode então enviar esse CSV para uma nova conta usando uma ferramenta de importação compatível.

Este artigo cobre as etapas exatas para exportar favoritos pela interface web, preparar o arquivo CSV e reimportar os favoritos em uma conta diferente do Mastodon. Também explica problemas comuns, como posts ausentes e entradas duplicadas.

Como os Favoritos do Mastodon São Armazenados e Por Que a Exportação é Necessária

Os favoritos do Mastodon são armazenados no banco de dados da sua instância atual. Cada favorito vincula-se à URL de um post remoto e à conta do autor. Ao mudar para uma instância diferente, sua nova conta tem uma lista de favoritos vazia. Não existe sincronização entre instâncias.

O recurso de exportação nas configurações do Mastodon cria um arquivo CSV com três colunas: URL do Favorito, URL da Conta e Criado em. O CSV não inclui o conteúdo do post, mídia ou impulsionamentos. Ele armazena apenas o link e o endereço do autor.

A reimportação requer um método que possa chamar a API do Mastodon para criar favoritos um por um. A ferramenta de importação nativa do Mastodon suporta listas de seguindo, listas de silenciados e listas de bloqueados, mas não favoritos. Portanto, você deve usar um script ou um serviço de terceiros para enviar o CSV.

O Que o Arquivo CSV Contém

O arquivo CSV exportado usa vírgulas como delimitadores. A primeira linha é um cabeçalho com estes nomes de coluna:

• URL do Favorito – A URL completa do post favoritado.
• URL da Conta – A URL completa do perfil do autor no Mastodon.
• Criado em – O timestamp de quando o favorito foi criado no formato ISO 8601.

Cada linha subsequente contém um favorito. Se o CSV contiver URLs duplicadas, o script de importação pode criar favoritos duplicados na nova conta.

Passos para Exportar Favoritos do Mastodon

1. Abra as Configurações do Mastodon
   Faça login na sua instância do Mastodon. Clique no ícone de engrenagem no menu superior direito ou navegue até a página de Configurações diretamente usando a URL https://suainstancia.com/settings.
2. Vá para Importar e Exportar
   Na barra lateral esquerda, clique em Importar e Exportar. Esta página mostra opções para exportar seus dados e importar listas.
3. Clique na Aba Exportar
   No topo da página Importar e Exportar, clique na aba Exportar. Você verá uma lista de tipos de dados que podem ser exportados.
4. Selecione CSV para Favoritos
   Encontre a linha rotulada Favoritos. Clique no botão CSV ao lado dela. Seu navegador baixará um arquivo chamado bookmarks.csv.
5. Salve o Arquivo CSV
   Armazene o arquivo CSV em um local seguro. Não o compartilhe publicamente porque contém URLs que podem revelar seus hábitos de leitura.

Após o download, abra o CSV em um editor de texto ou planilha para verificar os dados. Espere uma linha por favorito. Se você não tiver favoritos, o CSV conterá apenas a linha de cabeçalho.

Passos para Reimportar Favoritos em uma Nova Conta do Mastodon

A ferramenta de importação nativa do Mastodon não suporta arquivos CSV de favoritos. Você deve usar um método baseado em API. Os passos a seguir mostram como usar um script Python para reimportar os favoritos.

Pré-requisitos para Reimportação

• Python 3.6 ou superior instalado no seu computador.
• A biblioteca requests instalada: pip install requests.
• Um token de acesso para sua nova conta do Mastodon. Crie um em Preferências > Desenvolvimento > Nova Aplicação. Conceda o escopo write:bookmarks.

Reimportação Usando um Script Python

1. Crie o Arquivo do Script
   Abra um editor de texto e cole o código a seguir. Substitua sua-instancia.com pelo domínio da sua nova instância e seu-token-de-acesso pelo token que você gerou.
   import csv
   import requests

   instance = 'https://sua-instancia.com'
   token = 'seu-token-de-acesso'
   headers = {'Authorization': f'Bearer {token}'}

   with open('bookmarks.csv', newline='', encoding='utf-8') as csvfile:
reader = csv.DictReader(csvfile)
for row in reader:
url = row['Bookmark URL']
response = requests.post(f'{instance}/api/v1/bookmarks', headers=headers, json={'url': url})
if response.status_code == 200:
print(f'Importado: {url}')
else:
print(f'Falhou: {url} - {response.status_code}')

2. Coloque o Script e o CSV na Mesma Pasta
   Salve o script como import_bookmarks.py. Coloque seu arquivo bookmarks.csv na mesma pasta.
3. Execute o Script
   Abra um terminal ou prompt de comando. Navegue até a pasta que contém o script. Execute python import_bookmarks.py. O script criará um favorito para cada URL no CSV.
4. Verifique a Importação
   Faça login na sua nova conta do Mastodon. Abra a página de favoritos. Você deve ver todos os posts importados listados.

Problemas Comuns ao Exportar e Reimportar Favoritos

CSV Exportado Não Contém Favoritos

Se o CSV baixado tiver apenas uma linha de cabeçalho, você não tem favoritos na sua conta atual. Abra a página de favoritos no Mastodon e confirme se os posts aparecem lá. Apenas posts que você favoritou usando o ícone de favorito (o símbolo de fita) são incluídos.

Script de Importação Retorna 422 Unprocessable Entity

Um erro 422 geralmente significa que a URL no CSV está malformada ou o post foi excluído. Verifique o CSV em busca de URLs truncadas ou espaços extras. Remova as linhas que apontam para posts excluídos e execute o script novamente.

Favoritos Duplicados Após Reimportação

O script não verifica favoritos existentes. Se você executar o script duas vezes, terá entradas duplicadas. Para evitar isso, execute o script apenas uma vez. Se aparecerem duplicatas, você pode removê-las manualmente usando o ícone de favorito em cada post.

URL do Favorito de Outra Instância Falha

O Mastodon pode favoritar posts de qualquer instância federada. A chamada de API usa a URL pública do post. Se a instância remota estiver offline ou defederada, a criação do favorito pode falhar. O script exibirá uma mensagem de falha para essa URL. Você pode pular essa linha manualmente.

Exportação de Favoritos do Mastodon vs Ferramentas de Backup de Terceiros

Item	Exportação CSV Nativa	Ferramenta de Backup de Terceiros
Dados incluídos	URL do favorito, URL do autor, timestamp	Conteúdo completo do post, mídia e metadados
Método de reimportação	Requer script de API ou aplicativo de terceiros	Importação direta pela interface da ferramenta
Risco de privacidade	Arquivo CSV armazenado localmente	Dados enviados para servidor de terceiros
Custo	Gratuito	Pode exigir assinatura ou doação
Automação	Exportação manual e execução de script	Backups agendados possíveis

Escolha a exportação nativa se você quer controle total e privacidade. Escolha uma ferramenta de terceiros se precisar de backups automáticos ou quiser preservar o conteúdo dos posts.

Agora você pode exportar seus favoritos do Mastodon para um arquivo CSV e reimportá-los em uma nova conta usando um script Python simples. O processo preserva as URLs e referências do autor para cada post favoritado. Para migrações futuras, considere configurar uma exportação regular para manter seu CSV atualizado. Se você gerencia várias contas, o mesmo script pode ser adaptado para lidar com importações em lote, iterando sobre vários arquivos CSV.