/ Published in Gümrük Malları

Backup e restauração do Maccy: como salvar configurações, itens fixados e histórico da área de transferência

Backup e restauração do Maccy: como salvar configurações, itens fixados e histórico da área de transferência

Resposta rápida: o Maccy não tem um botão de exportar, mas tudo o que ele guarda fica em dois lugares que você pode copiar: um arquivo de preferências (suas configurações) e um pequeno banco de dados SQLite (histórico e itens fixados). Feche o Maccy App, copie os dois para uma pasta segura e, para restaurar, coloque-os de volta nos mesmos locais antes de abrir o app de novo. As configurações também podem ser exportadas sozinhas com um único comando defaults.

O que o Maccy realmente armazena e o que vale a pena salvar?

O Maccy Mac é local-first: não existe conta nem cópia na nuvem para te salvar. Seus dados existem apenas no seu Mac. Eles se dividem em três camadas, e cada uma pede um tratamento diferente:

Camada O que tem nela Vale a pena salvar? Método
Configurações Atalho global, tamanho do histórico, listas de exclusão, aparência, comportamento ao colar Sim, sempre defaults export ou copiar o .plist
Itens fixados Snippets que você fixou para reutilizar Sim, são curados e difíceis de recriar Copiar o banco de dados
Histórico da área de transferência Tudo o que você copiou recentemente Geralmente não. É efêmero e muitas vezes sensível Copiar o banco de dados (opcional)

Itens fixados e histórico compartilham o mesmo banco de dados, então não dá para fazer backup de um sem o outro. Se você quer só os fixados, restaure o banco e depois limpe os itens não fixados pelo menu.

Passo 0: qual versão do Maccy você está usando?

Isso importa mais do que qualquer outra coisa neste tutorial, porque os locais dos arquivos mudam. A versão da Mac App Store roda no sandbox da Apple, que move os dados para uma pasta de contêiner. A versão do GitHub ou do Homebrew (brew install maccy) não roda em sandbox. —

App Store (sandbox) GitHub / Homebrew
Pasta de dados ~/Library/Containers/org.p0deje.Maccy/Data/Library/Application Support/Maccy/ ~/Library/Application Support/Maccy/
Arquivo de preferências ~/Library/Containers/org.p0deje.Maccy/Data/Library/Preferences/org.p0deje.Maccy.plist ~/Library/Preferences/org.p0deje.Maccy.plist

Não sabe qual você tem? Abra o Terminal e rode ls ~/Library/Containers | grep -i maccy. Se aparecer org.p0deje.Maccy Clipboard, você está na versão com sandbox. Se não aparecer nada, olhe em ~/Library/Application Support/Maccy/. (A pasta Biblioteca fica oculta no Finder por padrão. Use Ir → Ir para a Pasta… e cole o caminho.)

Como fazer backup das configurações do Maccy

Opção A: o comando defaults (versão sem sandbox)

As preferências do Maccy ficam no domínio org.p0deje.Maccy do defaults. Exporte-as para um arquivo portátil:

defaults export org.p0deje.Maccy ~/Desktop/maccy-settings.plist

Isso é mais limpo do que copiar o arquivo de preferências cru, porque lê os valores atuais em vez do que o macOS gravou por último no disco.

Opção B: copiar o plist diretamente (funciona nas duas versões)

Primeiro feche o Maccy pelo ícone na barra de menus e depois copie o arquivo de preferências do caminho indicado na tabela acima. Fechar o app é importante: o macOS mantém as preferências em cache na memória e pode sobrescrever sua cópia, ou o arquivo restaurado, ao encerrar.

Aviso para quem usa a versão da App Store: o defaults export lê o local comum de preferências, não o contêiner do sandbox, então na versão com sandbox ele pode devolver valores vazios ou desatualizados. Use a Opção B nesse caso.

Como fazer backup dos itens fixados e do histórico da área de transferência

  1. Feche o Maccy por completo. O banco de dados está em uso enquanto o app roda.
  2. Abra a pasta de dados da sua versão (veja a tabela acima).
  3. Copie a pasta Maccy inteira. Não escolha só um arquivo. Bancos SQLite em modo WAL guardam as gravações recentes em arquivos auxiliares (normalmente -wal e -shm, ao lado do arquivo .sqlite principal), e um backup só do arquivo principal pode perder silenciosamente seus últimos itens fixados. —
  4. Cole a pasta em um lugar seguro, de preferência com a data no nome, como maccy-2026-10-21.
  5. Abra o Maccy de novo.

Um one-liner rápido para a versão sem sandbox:

osascript -e 'quit app "Maccy"'
cp -R ~/Library/Application\ Support/Maccy ~/Desktop/maccy-backup-$(date +%F)
open -a Maccy

Como restaurar o Maccy no mesmo Mac ou em um Mac novo

  1. Instale o Maccy (pelo mesmo canal de antes, para os caminhos coincidirem) e abra-o uma vez para ele criar suas pastas. Depois feche.
  2. Restaure o banco de dados: substitua o conteúdo da pasta de dados Maccy pela sua cópia de backup.
  3. Restaure as configurações:
    • Sem sandbox: defaults import org.p0deje.Maccy ~/Desktop/maccy-settings.plist
    • Qualquer versão: copie o .plist salvo por cima do que está no caminho de preferências.
  4. Limpe o cache de preferências: killall cfprefsd
  5. Abra o Maccy e chame-o com o seu atalho. Seus itens fixados e configurações devem ter voltado.
  6. Conceda as permissões de novo. O macOS associa a permissão de Acessibilidade ao app instalado, então em um Mac novo você precisa ativar o Maccy em Ajustes do Sistema → Privacidade e Segurança → Acessibilidade para o colar automático funcionar.

Vai migrar entre a versão com sandbox e a sem sandbox? Copie os arquivos para os caminhos correspondentes da nova versão. O formato é o mesmo, só muda o local, mas eu testaria antes com uma cópia descartável. —

Automatizando: Time Machine e um scriptzinho

O Time Machine já cobre isso se estiver ativo. Os dois locais de dados ficam dentro da Biblioteca da sua pasta pessoal, que o Time Machine inclui por padrão. Para restaurar, abra a pasta no Finder, entre no Time Machine e recupere uma versão anterior da pasta do Maccy, com o app fechado. Para a maioria das pessoas, essa é a estratégia de backup inteira.

Se você quer uma cópia deliberada e portátil (para os seus dotfiles ou para uma checklist de Mac novo, por exemplo), um script só de configurações é o ponto ideal:

#!/bin/bash
# Backup apenas das configurações do Maccy (versão sem sandbox)
mkdir -p ~/Backups/maccy
defaults export org.p0deje.Maccy ~/Backups/maccy/settings-$(date +%F).plist

As configurações são pequenas, não sensíveis e seguras para guardar em um repositório de dotfiles. O banco de dados não é nenhuma dessas coisas.

A parte que todo mundo pula: seu backup está cheio de segredos

Um banco de dados da área de transferência é um diário de tudo o que você copiou: chaves de API, endereços, trechos de mensagens privadas e, às vezes, senhas. O Maccy ignora cópias que os gerenciadores de senhas marcam como ocultas, o que ajuda, mas isso depende de o app de origem se comportar direito. Trate o banco de dados de acordo:

  • Nunca faça commit dele no Git nem o jogue em uma pasta compartilhada na nuvem.
  • Guarde-o criptografado: uma imagem de disco criptografada (Utilitário de Disco → Nova Imagem → Imagem em Branco, com criptografia) ou um volume protegido pelo FileVault.
  • Considere guardar apenas os itens fixados. Restaure o banco, abra o menu do Maccy e use Limpar para remover o histórico não fixado. Antes de compartilhar um backup, remova o que não for necessário.
  • Apague cópias antigas. Um backup de seis meses atrás ainda contém todos os segredos que você copiou naquela época.

Esse é o trade-off honesto de uma ferramenta local-first: nenhum servidor guarda seus dados, o que é uma vitória para a privacidade, mas também significa que a responsabilidade de cuidar bem dos arquivos é sua.

Quando a restauração não funciona

Sintoma Causa provável Solução
As configurações não mudaram após a importação Cache de preferências do macOS Feche o Maccy, rode killall cfprefsd e abra de novo
O histórico está vazio após restaurar Pasta da versão errada, ou só o arquivo principal do banco foi copiado Confira a tabela de caminhos; copie a pasta inteira, incluindo os arquivos auxiliares
Os itens fixados aparecem, mas os mais recentes não Backup feito com o Maccy em execução Refaça o backup com o Maccy totalmente fechado
O atalho funciona, mas o colar automático não Permissão de Acessibilidade não concedida na nova instalação Ative o Maccy em Privacidade e Segurança → Acessibilidade
As configurações restauradas voltam ao anterior ao fechar O Maccy estava em execução durante a cópia dos arquivos Sempre feche o app antes de mexer nos arquivos

Resumindo

Faça backup das configurações com frequência (é trivial e inofensivo), faça backup do banco de dados só se você tiver itens fixados que valem a pena guardar, e sempre com o Maccy fechado. Criptografe tudo o que incluir histórico. Esse é o sistema inteiro, e leva uns dois minutos na primeira vez.

O Maccy é gratuito e de código aberto (licença MIT), então, se algo no seu setup se comportar de um jeito diferente do descrito aqui, as issues do projeto no GitHub são o melhor lugar para conferir o comportamento atual. O que pesa mais para você: as configurações ou os itens fixados? Se for o segundo caso, o nosso guia sobre como organizá-los é a próxima leitura natural.

Perguntas frequentes

O Maccy tem um recurso nativo de exportar ou importar?

Até onde eu sei, não, e é por isso que este tutorial usa cópias de arquivos e o comando defaults. —

O Maccy sincroniza o histórico da área de transferência pelo iCloud?

Não. O Maccy guarda tudo localmente e não tem serviço de sincronização. A Área de Transferência Universal da Apple compartilha o conteúdo atual da área de transferência entre seus dispositivos, mas é um recurso separado do sistema e não cria um histórico sincronizado.

Onde o Maccy guarda seus dados no Mac?

Em ~/Library/Application Support/Maccy/ nas versões do GitHub e do Homebrew, ou dentro de ~/Library/Containers/org.p0deje.Maccy/ na versão da Mac App Store.

O Time Machine faz backup do histórico do Maccy?

Sim. Os dois locais ficam dentro da Biblioteca do seu usuário, que o Time Machine inclui por padrão, a menos que você tenha adicionado uma exclusão.

Dá para fazer backup só dos itens fixados?

Não separadamente. Itens fixados e histórico compartilham o mesmo banco de dados. Faça backup do banco e, depois de restaurar, limpe os itens não fixados se quiser começar do zero.