Como Exportar Emojis Personalizados do Mastodon como Conjunto de Imagens

Instâncias do Mastodon geralmente incluem centenas de emojis personalizados que você não pode usar em outros servidores. Talvez você queira fazer backup desses emojis para uso pessoal ou migrá-los para outra instância. O recurso de exportação nativo do Mastodon não inclui emojis personalizados. Este artigo explica como usar um script de navegador e um método manual para baixar todos os emojis personalizados de qualquer instância do Mastodon como um conjunto de imagens.

O que a API de Emojis Personalizados do Mastodon Oferece

O Mastodon expõe um endpoint público de API que lista todos os emojis personalizados em uma instância. O endpoint é /api/v1/custom_emojis. Ele retorna um array JSON contendo o shortcode de cada emoji, URL estática e URL animada. Esses dados estão disponíveis para qualquer visitante, não apenas usuários logados. Os arquivos de emoji são tipicamente PNG para imagens estáticas e GIF para animadas. Uma instância pode hospedar centenas ou milhares de emojis, tornando o download manual impraticável. Os métodos abaixo usam essa API para automatizar a exportação.

Pré-requisitos para Exportar Emojis

Você precisa de um navegador moderno como Chrome, Firefox ou Edge. Para o método manual de admin, você deve ter acesso de administrador ou moderador à instância do Mastodon. Para o método de linha de comando, você precisa do Python 3.6 ou superior instalado no computador. Nenhuma permissão especial é necessária para o método do console do navegador.

Passos para Exportar Emojis Personalizados Usando as Ferramentas do Desenvolvedor do Navegador

Este método funciona em qualquer instância do Mastodon. Ele usa o console do desenvolvedor do navegador para buscar todas as URLs de emojis e iniciar os downloads.

1. Abra sua instância do Mastodon no navegador
   Navegue até qualquer página da instância, como a linha do tempo pública ou um perfil local. O script buscará os emojis da instância que você está visitando.
2. Abra o console do desenvolvedor do navegador
   Pressione Ctrl+Shift+J no Windows ou Cmd+Option+J no macOS. No Firefox, você pode pressionar Ctrl+Shift+K.
3. Cole o script de exportação de emojis no console
   Copie o seguinte código JavaScript e cole no prompt do console, depois pressione Enter:
   fetch('/api/v1/custom_emojis').then(r=>r.json()).then(emojis=>{emojis.forEach(e=>{let a=document.createElement('a');a.href=e.static_url;a.download=e.shortcode+'.png';document.body.appendChild(a);a.click();document.body.removeChild(a)})})
4. Aguarde a conclusão de todos os downloads
   O navegador começará a baixar cada emoji como um arquivo separado. O número de downloads é igual ao número de emojis personalizados na instância. Dependendo do tamanho da instância, isso pode levar vários minutos. Não feche a aba do navegador até que todos os downloads terminem.
5. Organize os arquivos baixados
   Após os downloads terminarem, mova todos os arquivos para uma única pasta. Os nomes dos arquivos são os shortcodes com extensão .png. Se você precisar das versões animadas, modifique o script para usar e.url em vez de e.static_url.

Passos para Exportar Emojis Personalizados como Administrador da Instância

Se você é administrador da instância do Mastodon, pode exportar todos os emojis personalizados diretamente do painel de administração. Este método baixa um único arquivo ZIP contendo todas as imagens de emoji.

1. Faça login na sua instância do Mastodon com uma conta de administrador
   Use suas credenciais de administrador ou moderador. Apenas usuários com a função apropriada podem acessar o painel de admin.
2. Navegue até Preferências > Administração > Emojis Personalizados
   Clique no avatar do seu perfil no canto superior direito, selecione Preferências, depois clique em Administração na barra lateral esquerda. Finalmente, clique em Emojis Personalizados.
3. Clique no botão Exportar
   No topo da página de Emojis Personalizados, localize o botão Exportar. Ele está rotulado como Exportar .CSV. Isso exporta um arquivo CSV listando todos os shortcodes de emoji e suas URLs de imagem, não os arquivos de imagem reais.
4. Baixe cada emoji manualmente a partir da lista CSV
   Abra o arquivo CSV em um aplicativo de planilha. Cada linha contém um shortcode e uma URL. Você pode usar uma ferramenta de download em massa como wget ou uma extensão de navegador para baixar todas as URLs listadas no CSV.
5. Use a API de Admin para uma exportação ZIP direta
   Algumas versões do Mastodon suportam uma exportação ZIP via API de admin. Envie uma requisição GET para /admin/custom_emojis/export.zip enquanto autenticado como admin. Se o endpoint não estiver disponível, o método do console do navegador é a melhor alternativa.

Problemas Comuns e Limitações ao Exportar Emojis

Navegador Bloqueia Múltiplos Downloads

A maioria dos navegadores exibe um pop-up pedindo permissão para permitir múltiplos downloads. Clique em Permitir ou Sempre Permitir para prosseguir. Se você perder o prompt, o script pode parar após alguns arquivos. Recarregue a página e execute o script novamente, garantindo que você aprove a solicitação de múltiplos downloads.

Alguns Arquivos de Emoji São GIFs Animados

O script acima baixa versões PNG estáticas. Para obter versões GIF animadas, substitua e.static_url por e.url no script. Observe que alguns emojis podem ter apenas uma versão estática. A API retorna ambos os campos para cada emoji quando disponível.

Instâncias Grandes Causam Lentidão no Navegador

Se a instância tiver mais de 500 emojis, o navegador pode ficar lento ou travar. Nesse caso, use a ferramenta Python de linha de comando. Ela baixa arquivos sequencialmente sem carregar a interface do navegador.

Script do Console vs Exportação Admin vs Ferramenta Python

Item	Script do Console	Exportação Admin CSV	Ferramenta Python (mastodon-emoji-exporter)
Nível de acesso necessário	Nenhum	Admin ou moderador	Nenhum
Formato de saída	Arquivos de imagem individuais	Lista CSV de URLs	Arquivos de imagem individuais em uma pasta
Lida com emojis animados	Sim, com modificação no script	Não, apenas URLs	Sim, automaticamente
Melhor para	Exportação rápida e única	Administradores que precisam de um registro	Instâncias grandes e automação

Agora você pode exportar emojis personalizados de qualquer instância do Mastodon como um conjunto de imagens. Para uma exportação rápida, use o script do console do navegador. Para exportações repetidas ou instâncias grandes, instale a ferramenta Python mastodon-emoji-exporter do GitHub. Após exportar, você pode fazer upload dos emojis para outra instância através do painel de admin usando o botão Importar na página de Emojis Personalizados. A função de importação aceita um arquivo ZIP contendo as imagens e um arquivo de mapeamento JSON ou CSV.