Os filtros do Mastodon permitem ocultar postagens que contenham palavras ou frases específicas em suas timelines inicial e pública. Você pode ter criado uma longa lista de palavras-chave personalizadas para bloquear spoilers, termos gatilho ou tópicos específicos. Exportar esses filtros permite fazer backup ou movê-los para uma nova instância sem redigitar cada entrada.
O Mastodon inclui uma ferramenta de exportação integrada que salva os filtros como um arquivo CSV. Esse arquivo contém cada filtro, suas palavras-chave e a ação definida. Você pode usar esse arquivo para restaurar filtros na mesma conta ou importá-los para uma conta diferente do Mastodon.
Este artigo explica as etapas exatas para exportar filtros com palavras-chave personalizadas do Mastodon. Também aborda o formato do arquivo, erros comuns e o que fazer se a exportação falhar.
Principais Pontos: Exportando Filtros do Mastodon como CSV
- Preferências > Importar e exportar > Exportar: O caminho do menu para acessar a exportação do arquivo CSV de filtros.
- Formato do arquivo CSV: Cada linha contém título do filtro, palavra-chave, ação e expiração. As palavras-chave são separadas pelo caractere pipe.
- Importar em uma nova instância: Use a mesma página Importar e exportar para enviar o arquivo CSV e restaurar todos os filtros.
Como Funciona a Exportação de Filtros do Mastodon
O Mastodon armazena filtros no lado do servidor no banco de dados da sua conta. Cada filtro tem um título, uma lista de palavras-chave, uma ação e um tempo de expiração opcional. A ação pode ser ocultar ou avisar. O título é o rótulo que você vê na sua lista de filtros.
A ferramenta de exportação cria um arquivo CSV contendo todos os seus filtros. O arquivo CSV usa as seguintes colunas:
- Título: O nome que você deu ao filtro.
- Palavra-chave: Todas as palavras-chave para aquele filtro, separadas pelo caractere pipe.
- Ação do filtro: Ocultar ou avisar.
- Expira em: O número de segundos até o filtro expirar, ou vazio se nunca expirar.
- Contexto das palavras-chave: Cada palavra-chave pode ter um contexto, como home, public, notifications ou conversation. Isso faz parte dos dados da palavra-chave.
- Palavra inteira: Um indicador booleano que informa se a palavra-chave deve corresponder apenas a palavras inteiras.
O arquivo CSV não inclui as configurações de contexto do filtro diretamente. O contexto da palavra-chave e o sinalizador de palavra inteira estão embutidos nos dados da palavra-chave. Ao reimportar o arquivo, o Mastodon recria os filtros com seus contextos originais se o formato corresponder.
Você precisa estar logado na sua conta do Mastodon para exportar filtros. O recurso de exportação está disponível em todas as instâncias do Mastodon que executam a versão 4.0 ou posterior. Instâncias mais antigas podem não suportar a exportação de filtros.
Passos para Exportar Filtros do Mastodon
Siga estas etapas para baixar seus filtros como um arquivo CSV. O processo leva menos de um minuto.
- Abra as preferências do Mastodon
Clique no ícone de preferências no canto superior direito da interface web do Mastodon. O ícone parece uma engrenagem ou uma silhueta de pessoa, dependendo do tema. Selecione Preferências no menu suspenso. - Navegue até Importar e exportar
Na barra lateral esquerda, clique em Importar e exportar. Esta página lista todas as opções de exportação de dados da sua conta. - Clique no botão Exportar para filtros
Procure pela seção rotulada Exportar. Encontre a linha que diz Filtros. Clique no botão Exportar à direita do rótulo Filtros. O navegador baixa um arquivo chamado mastodon_filters.csv. - Abra o arquivo CSV para verificar o conteúdo
Abra o arquivo baixado em um editor de texto ou aplicativo de planilha. Cada linha representa um filtro. A primeira linha contém os cabeçalhos das colunas: Título, Palavra-chave, Ação do filtro, Expira em, Contexto das palavras-chave, Palavra inteira. Verifique se suas palavras-chave personalizadas aparecem na coluna Palavra-chave, separadas por caracteres pipe. Se o arquivo estiver vazio ou faltando linhas, repita o processo de exportação.
O arquivo CSV usa codificação UTF-8. Se você abri-lo no Excel no Windows, pode ser necessário importar o arquivo usando a opção Dados > De Texto/CSV para ver caracteres especiais corretamente.
Erros Comuns ao Exportar Filtros do Mastodon
Arquivo CSV exportado está vazio
Se o arquivo baixado contém apenas cabeçalhos e nenhuma linha de dados, você não tem filtros definidos. Crie pelo menos um filtro com uma palavra-chave antes de exportar. Vá em Preferências > Filtros e clique em Adicionar novo filtro. Insira um título e uma palavra-chave, depois salve o filtro. Exporte novamente.
Palavras-chave aparecem embaralhadas ou ausentes após a importação
O arquivo CSV usa o caractere pipe como delimitador entre palavras-chave dentro de uma única célula. Se uma palavra-chave contiver um caractere pipe, a ferramenta de exportação pode dividi-la incorretamente. Evite usar caracteres pipe em suas palavras-chave. Se você já tiver essas palavras-chave, edite-as antes de exportar.
Contextos dos filtros não são preservados durante a reimportação
O arquivo CSV armazena dados de contexto das palavras-chave na coluna Contexto das palavras-chave. Nem todas as versões do Mastodon suportam essa coluna durante a importação. Se você importar o arquivo em uma instância mais antiga, os contextos podem ser redefinidos para o contexto padrão. Verifique a versão da sua instância do Mastodon antes de importar.
Botão Exportar está ausente ou desabilitado
O recurso de exportação de filtros requer a versão 4.0 ou posterior do Mastodon. Se você estiver em uma instância mais antiga, atualize o software da instância ou peça ao administrador para fazer a atualização. Alternativamente, use a API do Mastodon para exportar filtros manualmente por meio de um script.
Exportação de Filtros do Mastodon vs. Backup Manual
| Item | Exportação CSV | Cópia Manual |
|---|---|---|
| Tempo necessário | Menos de um minuto | 10 a 30 minutos dependendo da quantidade de filtros |
| Precisão | Cópia exata de todas as palavras-chave e ações | Propenso a erros de digitação e entradas perdidas |
| Compatibilidade | Funciona com qualquer instância do Mastodon executando versão 4.0 ou posterior | Nenhum requisito de versão de software |
| Suporte a reimportação | Ferramenta de importação integrada na mesma página | Deve reinserir cada filtro manualmente |
| Preservação de contexto | Preserva o contexto das palavras-chave se a instância de importação suportar | Contexto é perdido a menos que anotado manualmente |
O backup manual envolve copiar cada título de filtro e lista de palavras-chave para um arquivo de texto. Esse método é mais lento e propenso a erros. Use a exportação CSV para backups e migrações confiáveis.
Após exportar, você pode importar o arquivo CSV para uma nova conta do Mastodon acessando Preferências > Importar e exportar > Importar. Selecione o tipo de arquivo Filtros e envie o arquivo CSV. O Mastodon recria todos os filtros com suas palavras-chave e ações originais. Verifique a lista de filtros após a importação para confirmar que tudo foi transferido corretamente.
Se precisar editar filtros antes de reimportar, abra o arquivo CSV em um editor de planilhas. Modifique a coluna Palavra-chave, adicionando ou removendo palavras-chave separadas por pipe. Salve o arquivo como CSV com codificação UTF-8 e depois importe-o.