Como usar o rsync com um celular Android e um Mac

O rsync não alcança um celular que vive dentro da janela de um app, do jeito que o Android File Transfer e o OpenMTP o mostram, porque ele precisa de um caminho de cada lado. Monte o celular como um volume, e copiar as fotos da câmera para o Mac vira um comando só:

rsync -av --progress "$PHONE/DCIM/Camera/" ~/Pictures/Phone/

Do celular para o Mac, isso funciona do jeito que está. No sentido do celular, use -rt no lugar de -a, porque o armazenamento do celular não guarda as permissões do Mac, e não é possível criar links simbólicos nele. Teste qualquer coisa nova com -n antes e trate o --delete com cuidado. Sem montar, o pull e o push do próprio adb, e uma ferramenta chamada better-adb-sync, fazem parte do mesmo trabalho.

Como achar o caminho do celular

O SideMount monta o celular pelo cabo USB como um volume que o Finder mostra como um disco (configurar leva poucos minutos). Ele não fica em /Volumes: é uma pasta com o nome do celular dentro de ~/Library/Application Support/SideMount/Volumes/. O armazenamento interno do celular é a raiz do volume, e um cartão SD é uma pasta chamada SD Card dentro dela.

Você não precisa digitar esse caminho. No Terminal, digite PHONE= sem espaços, arraste o volume do celular do Finder para a janela e pressione Return. O Terminal escreve o caminho para você, com uma barra invertida antes de cada espaço. A partir daí, "$PHONE" representa o celular em todos os comandos daquela janela. Mantenha as aspas duplas: o caminho tem um espaço.

Copiar as fotos do celular

rsync -av --progress "$PHONE/DCIM/Camera/" ~/Pictures/Phone/

• -a copia a pasta e tudo o que está dentro dela, e mantém a data de modificação de cada arquivo.
• -v lista cada arquivo, e --progress mostra quanto de cada um já foi.
• A barra no fim de Camera/ faz diferença. Com ela, as fotos vão direto para ~/Pictures/Phone. Sem ela, o rsync cria ~/Pictures/Phone/Camera e as coloca lá.

Rode o mesmo comando na semana que vem e o rsync copia só as fotos novas: ele compara o tamanho e a data de modificação de cada arquivo dos dois lados e pula os que batem. As capturas de tela costumam ficar em Pictures/Screenshots ou DCIM/Screenshots, e usam o mesmo comando com esse caminho.

Uma pasta com milhares de arquivos pequenos demora mais do que o tamanho sugere. Cada arquivo tem um custo fixo no cabo, seja qual for a ferramenta que o copia, então algumas centenas de fotos passam rápido, e a pasta de mídia de um app de mensagens, não.

Teste antes com -n

rsync -avn "$PHONE/DCIM/Camera/" ~/Pictures/Phone/

-n, ou --dry-run, faz uma simulação: lista tudo o que o rsync copiaria e não copia nada. Use sempre que mudar um caminho ou acrescentar uma opção, e toda vez antes do --delete.

Espelhar com --delete

O --delete faz do destino uma cópia exata da origem: qualquer arquivo no destino que não esteja na origem é apagado. Isso serve para uma pasta de músicas que você mantém no Mac e quer que o celular acompanhe, como em copiar músicas do Mac para o Android. Primeiro a simulação, depois para valer:

rsync -rtn --delete --exclude '.DS_Store' ~/Music/Phone/ "$PHONE/Music/"
rsync -rt --delete --progress --exclude '.DS_Store' ~/Music/Phone/ "$PHONE/Music/"

Leia a simulação antes de rodar a segunda linha. Um caminho errado, ou uma barra faltando depois da origem, pode apontar o --delete para uma pasta que você não queria, e ele apaga para sempre: nada vai para a lixeira em nenhum dos lados. Também nunca o use num backup tirado do celular. Uma foto que você apagasse no celular sumiria do backup na execução seguinte, o que acaba com o propósito do backup.

O --exclude '.DS_Store' está ali porque o Finder deixa esses arquivos nas pastas do Mac, e o celular não tem nenhum uso para eles.

Deixar as miniaturas de fora

rsync -av --progress --exclude '.thumbnails' "$PHONE/DCIM/" ~/Pictures/Phone-DCIM/

Os apps de galeria de celulares mais antigos guardam miniaturas em DCIM/.thumbnails, que pode crescer bastante e que o celular refaz quando precisa. Um padrão sem barra vale em qualquer nível, então --exclude '.thumbnails' pula essa pasta onde quer que ela esteja. --exclude '.*' vai além e pula todos os arquivos e pastas ocultos.

Por que -a é um mau hábito no sentido do celular

-a é um atalho para -rlptgoD. Num disco do Mac, tudo isso faz sentido. No armazenamento compartilhado de um celular, várias dessas opções não fazem:

• -p, -o e -g copiam permissões, dono e grupo. O armazenamento compartilhado do Android não guarda isso por arquivo, então não há o que definir. O celular montado aceita o pedido e o ignora, então a cópia passa, mas o rsync encontra a mesma diferença na execução seguinte e pede de novo.
• -l copia links simbólicos como links, e não dá para criar um link no celular montado, então cada um falha. Se a sua pasta tem links, -L copia os arquivos para onde eles apontam.
• -D copia arquivos de dispositivo, que uma pasta de fotos ou de músicas nunca tem.

Do resto, o que importa é -r e -t. Então, no sentido do celular, use -rt, ou mantenha o -a e acrescente --no-perms --no-owner --no-group. Mantenha o -t em qualquer caso. O celular guarda as datas de modificação, e sem elas todo arquivo parece alterado, então cada execução copia tudo de novo.

Sobra uma peculiaridade de horário, nos cartões SD. Um cartão formatado em FAT32 guarda os horários com precisão de dois segundos, então um arquivo pode parecer um segundo diferente e ser copiado de novo a cada execução. Acrescente --modify-window=1, que diz ao rsync para tratar horários com um segundo de diferença como iguais.

Deixe de fora também o -c (--checksum). Ele lê cada arquivo inteiro dos dois lados para compará-los, o que, no celular, significa puxar todos os arquivos pelo cabo. Tamanho e data bastam.

O rsync que vem no seu Mac

Rode rsync --version num Mac recente e ele responde:

openrsync: protocol version 29
rsync version 2.6.9 compatible

Desde o macOS 15.4, a Apple traz o openrsync, uma reescrita sob uma licença no estilo BSD, no lugar do rsync 2.6.9 sob GPL que manteve por anos. Ele aceita um subconjunto das opções do rsync, e todos os comandos desta página funcionam com ele. Para os extras do rsync 3, como --info=progress2, que mostra uma única linha de progresso para a execução inteira, instale-o com o Homebrew (brew install rsync); depois disso, a cópia do Homebrew costuma vir primeiro no Terminal.

Sem montar: as ferramentas do próprio adb

Todas elas precisam da depuração USB no celular; ativá-la leva um minuto. As ferramentas do adb também precisam das Android platform tools do Google no Mac.

• adb pull -a /sdcard/DCIM/Camera ~/Pictures/ copia a pasta inteira para ~/Pictures/Camera, mantendo a data e o modo de cada arquivo. Copia tudo, toda vez.
• adb push --sync copia arquivos para o celular e pula aqueles cujas datas já batem. Nunca apaga nada.
• O better-adb-sync é o que existe de mais parecido com o rsync pelo adb: pip install BetterADBSync, depois adbsync pull ou adbsync push, com --dry-run, --exclude e --del. Ele começou como uma reescrita do adb-sync do próprio Google, que foi arquivado em março de 2025 e hoje aponta para ele.

Só um programa por vez pode ocupar a conexão adb de um celular. Se o SideMount está com o celular, ejete-o antes, o que libera o celular. Se o seu servidor adb já estava rodando antes de ejetar, rode adb kill-server uma vez para que ele procure o celular de novo.

Perguntas