Requisitos

  • macOS 12 Monterey ou posterior (o formato do banco de dados do iMessage mudou no macOS 12).
  • Homebrew instalado — se não tiver, execute o instalador de uma linha em brew.sh.
  • A conta do iMessage conectada neste Mac deve ser a mesma conta da qual você deseja exportar.

Passo 1: Conceder Acesso Total ao Disco para o Terminal

O banco de dados do iMessage está armazenado em um local protegido. O Terminal precisa de permissão explícita para lê-lo.

1
Abra as Configurações do Sistema (macOS 13+) ou Preferências do Sistema (macOS 12).
2
Navegue até Privacidade e Segurança → Acesso Total ao Disco.
3
Clique no botão + e adicione o Terminal (encontrado em /Applications/Utilities/Terminal.app). Se o Terminal já estiver na lista, certifique-se de que seu toggle está ativado.
Se você usa iTerm2 ou outro aplicativo de terminal, adicione-o em vez do Terminal. A permissão segue o aplicativo, não o comando.

Passo 2: Instalar o imessage-exporter

Abra o Terminal e execute:

brew install imessage-exporter

Isso instala a ferramenta de linha de comando open-source imessage-exporter. Ela lê diretamente do seu banco de dados local do iMessage — nada é enviado para nenhum servidor.

Passo 3: Exportar suas Mensagens

Execute o seguinte comando para exportar todas as conversas em formato de texto simples com arquivos de mídia copiados junto:

imessage-exporter -f txt -c copy -o ~/imessage-export

Significado dos parâmetros:

  • -f txt — formato de texto simples (necessário para o XMOX)
  • -c copy — copia arquivos de mídia (notas de voz, imagens) para a pasta de exportação
  • -o ~/imessage-export — diretório de saída (você pode alterar este caminho)
Uma exportação completa de uma grande biblioteca do iMessage pode levar vários minutos e produzir uma pasta grande. Se você precisar apenas de uma conversa, exporte apenas esse contato (veja a dica abaixo).

Passo 4: Encontrar a Pasta de Conversa Correta

Após a exportação, abra ~/imessage-export no Finder. Você verá uma pasta por contato ou grupo, nomeada pelo número de telefone ou Apple ID:

~/imessage-export/
  +15551234567/
    +15551234567.txt
    attachments/
      audio_message.caf
  group_chat_abc123/
    ...

Localize a pasta do contato ou grupo que deseja analisar.

Passo 5: Compactar a Pasta da Conversa

1
No Finder, clique com o botão direito na pasta do contato (ex.: +15551234567) e escolha Comprimir.
2
Um arquivo .zip é criado no mesmo local. Este é o arquivo que você faz upload para o XMOX.

Passo 6: Fazer Upload para o XMOX

3
No seu espaço de trabalho do XMOX, clique em + Novo Trabalho e escolha "Exportação do iMessage".
4
Faça upload do arquivo ZIP. O XMOX analisa o arquivo de conversa .txt e localiza os anexos de notas de voz dentro da pasta attachments/.
5
O processamento é concluído quando o trabalho mostra Pronto. As notas de voz (no formato .caf da Apple) são convertidas para MP3 e transcritas automaticamente.

Dicas para Bibliotecas Grandes

  • Para exportar apenas um contato específico: imessage-exporter -f txt -c copy -o ~/imessage-export -t "+15551234567"
  • O parâmetro -t filtra por número de telefone ou e-mail — isso mantém a exportação pequena e rápida.
  • Chats em grupo usam um ID interno, não um número de telefone. Execute uma exportação completa primeiro, depois localize a pasta do grupo reconhecendo os nomes dos contatos no arquivo .txt.
As conversas do iMessage são armazenadas apenas em dispositivos que têm a conta conectada com o iMessage ativado. Se você não usou o iMessage neste Mac recentemente, algumas mensagens mais antigas podem não estar presentes localmente.

Pronto para analisar suas conversas do iMessage? Faça upload da exportação para o XMOX agora.

Abrir Espaço de Trabalho →