Exportar Posts Fixados do Mastodon: Como Lidar Separadamente

Quando você exporta os dados da sua conta do Mastodon, o arquivo padrão inclui suas postagens, arquivos de mídia e lista de seguidores. Mas os posts fixados — aqueles que você fixou manualmente no topo do seu perfil — não são incluídos como um item separado na exportação padrão. Isso pode ser confuso se você quiser preservá-los ao migrar para uma nova instância ou fazer backup da estrutura do seu perfil. A ferramenta de exportação do Mastodon não oferece uma opção dedicada para posts fixados porque eles são tratados como um sinalizador de metadados anexado a postagens individuais. Este artigo explica como localizar seus posts fixados dentro do arquivo de exportação e como extraí-los manualmente para tratamento separado.

Por que os Posts Fixados Não São Exportados Separadamente

O Mastodon não trata posts fixados como um tipo de conteúdo distinto. Quando você fixa uma postagem, o servidor adiciona um sinalizador pinned aos metadados da postagem no banco de dados. O processo de exportação padrão — acessado através de Preferências > Importar e Exportar > Exportar — coleta todas as postagens, arquivos de mídia, seguidores e outros dados da conta em um único arquivo ZIP. O arquivo contém um arquivo outbox.json que lista cada postagem no formato ActivityPub. Cada objeto de postagem inclui um campo type. Para posts fixados, o valor de type é Add em vez de Create para postagens comuns. Essa diferença sutil é a única maneira de identificar posts fixados na exportação.

Os desenvolvedores do Mastodon escolheram esse design porque posts fixados não são uma entidade de dados separada. Eles são simplesmente postagens comuns com um sinalizador adicional. Quando você migra para uma nova instância usando a ferramenta de migração de conta padrão, seus posts fixados não são transferidos automaticamente. A ferramenta de migração copia seus seguidores, solicitações de seguimento, listas e contas silenciadas ou bloqueadas — mas não suas postagens ou posts fixados. Para preservar os posts fixados, você deve fixá-los manualmente novamente após a migração ou usar um método alternativo para extraí-los do arquivo de exportação.

Passos para Extrair Posts Fixados do Arquivo de Exportação do Mastodon

Siga estes passos para localizar e extrair seus posts fixados da exportação padrão do Mastodon. Você precisará de um editor de texto que possa lidar com arquivos JSON grandes, como Visual Studio Code, Notepad++ ou qualquer visualizador JSON.

1. Gerar o arquivo de exportação
   Vá para Preferências > Importar e Exportar > Exportar. Clique no botão Solicitar seu arquivo. O Mastodon preparará um arquivo ZIP contendo seus dados da conta. Dependendo do tamanho da sua conta, isso pode levar alguns minutos. Quando o arquivo estiver pronto, você receberá um e-mail com um link de download. Baixe o arquivo ZIP para o seu computador.
2. Extrair o arquivo ZIP
   Use a ferramenta de extração de arquivos do seu sistema operacional para descompactar o arquivo baixado. Dentro, você verá pastas chamadas media_attachments, avatar, header e um arquivo chamado outbox.json. O arquivo outbox.json contém todas as suas postagens em formato JSON.
3. Abrir outbox.json em um visualizador JSON
   Abra outbox.json em um editor de texto ou visualizador JSON. A estrutura do arquivo começa com um campo @context e type. Role para baixo até o array orderedItems. Cada objeto neste array representa uma postagem.
4. Encontrar os posts fixados
   Procure por objetos onde o campo type é Add. Estes são seus posts fixados. Cada objeto Add contém um campo object com os dados completos da postagem, incluindo o conteúdo, URL e URLs de anexos. Copie o objeto Add inteiro para cada post fixado.
5. Criar um arquivo JSON separado para posts fixados
   Abra um novo arquivo no seu editor de texto. Cole os objetos Add copiados neste arquivo. Salve o arquivo como pinned-posts.json. Este arquivo agora contém apenas seus posts fixados e pode ser usado para fixação manual ou fins de arquivamento.
6. Fixar manualmente na nova instância
   Se você estiver migrando para uma nova instância do Mastodon, precisará recriar cada post fixado manualmente. Use as URLs do campo object para localizar as postagens originais na sua instância antiga. Se a instância antiga ainda estiver acessível, você pode copiar o conteúdo e os anexos e criar novas postagens na nova instância. Em seguida, fixe cada nova postagem clicando no menu de três pontos na postagem e selecionando Fixar.

Problemas Comuns ao Lidar com Posts Fixados em Exportações

Posts fixados não aparecem na exportação

Se o seu arquivo de exportação não contiver nenhum objeto do tipo Add, verifique se você gerou o arquivo após fixar as postagens. A exportação captura o estado da sua conta no momento em que você a solicita. Se você fixou posts após a exportação ser gerada, eles não aparecerão. Solicite uma nova exportação após fixar. Verifique também se os posts ainda estão fixados no seu perfil. Posts desafixados não aparecerão como objetos Add.

O arquivo outbox.json é muito grande para abrir

Se você tem milhares de postagens, o outbox.json pode exceder os limites de memória de editores de texto básicos. Use um analisador JSON de streaming ou uma ferramenta de linha de comando como jq para filtrar apenas os objetos Add. Por exemplo, execute jq '.orderedItems[] | select(.type == "Add")' outbox.json > pinned-posts.json em um terminal. Este comando extrai apenas os posts fixados sem carregar o arquivo inteiro na memória.

Posts fixados não são transferidos durante a migração de conta

A migração de conta no Mastodon move apenas seus seguidores, solicitações de seguimento, listas e configurações de silenciamento ou bloqueio. Suas postagens, incluindo posts fixados, permanecem na instância antiga. Para preservar os posts fixados, você deve exportá-los manualmente conforme descrito acima ou manter a instância antiga ativa como um arquivo somente leitura. Após a migração, você pode fixar manualmente os posts na nova instância usando o conteúdo da exportação.

Item	Exportação Padrão	Extração Manual de Posts Fixados
Dados incluídos	Todas as postagens, mídia, seguidores, solicitações de seguimento, listas, listas de silenciamento/bloqueio	Apenas posts fixados identificados por type: Add no outbox.json
Formato do arquivo	Arquivo ZIP com outbox.json e pastas de mídia	Arquivo JSON personalizado contendo apenas objetos de posts fixados
Facilidade de uso	Exportação com um clique a partir de Preferências	Requer filtragem manual de JSON ou ferramenta de linha de comando
Compatibilidade com migração	Seguidores e listas transferidos automaticamente; postagens não	Deve recriar posts manualmente na nova instância

A exportação padrão do Mastodon não separa posts fixados porque eles são sinalizadores de metadados em vez de entidades de dados independentes. Para lidar com posts fixados separadamente, você deve extraí-los do arquivo outbox.json filtrando por objetos type: Add. Este método fornece um arquivo limpo e portátil contendo apenas os posts que você fixou. Após migrar para uma nova instância, use este arquivo para recriar e fixar cada post. Para backups futuros, considere usar uma extensão de navegador como Mastodon Pinned Post Exporter, que automatiza o processo de extração diretamente da sua página de perfil.