🧼 Limpando nomes de arquivos no Linux com detox – a ferramentinha que salvou meus backups

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski
😤 Quando um backup falha... por causa de um nome de arquivo
Há pouco tempo, um dos meus backups automatizados no Linux travou no meio da execução sem aviso. Nenhuma mensagem de erro bonita, nenhum fallback elegante — só um aborto silencioso.
Depois de muito grep pesado e de uma bela espeleologia nos logs, achei o culpado: um único arquivo com um nome fora do padrão que a ferramenta de backup não conseguia processar. Pior ainda — o arquivo tinha vindo de um sistema macOS (MacBook Air). Claro. 😅
Pelo jeito, o macOS adora salpicar umas peculiaridades Unicode, caracteres invisíveis e um uso criativo de símbolos especiais. Ótimo para humanos, nem tanto para sistemas de arquivos Linux ou ferramentas de backup.
💾 Entra o rdiff-backup: minha arma preferida para backups versionados
Uso o rdiff-backup nos meus backups diários porque ele suporta backups versionados e incrementais — tipo Time Machine, só que mais nerd e amigo da linha de comando:
rdiff-backup /data /mnt/backup/data
Mas aí vem a pegadinha: o rdiff-backup engasgou com aquele nome de arquivo malformado e desistiu. Nada de mágica incremental, nada de versionamento — só falha.
Lição aprendida: limpe seus arquivos antes de fazer o backup. Então adicionei uma etapa antes do backup: detox.
🧼 O que é o detox e por que você deveria se importar?
O detox é uma pequena ferramenta de linha de comando do Linux que limpa nomes de arquivos bagunçados de forma recursiva, removendo caracteres problemáticos como:
- Espaços
- Tremas (ä, ö, ü → ae, oe, ue)
- Loucuras do Unicode
- Símbolos estranhos e caracteres de controle
Perfeito para arquivos que vieram de... bem... qualquer lugar que não seja Linux.
🛠️ Instalação
Na maioria das distros, é simples assim:
sudo apt install detox
🚀 Uso básico
Para limpar um diretório recursivamente:
detox -r /your/directory
🔧 Exemplo de mágica antes/depois
| Nome original | Depois da limpeza |
|---|---|
| Urlaubsfotos 2024 (Köln).jpg | Urlaubsfotos_2024_Koeln.jpg |
| Résumé_finalé.pdf | Resume_finale.pdf |
| Projekt 1#Beta!.zip | Projekt_1Beta.zip |
🧪 Schemes recomendados
O detox suporta vários “schemes” que definem como os nomes de arquivos são higienizados. Isto foi o que funcionou melhor para mim:
detox -r -s utf_8 -s iso8859_1 -v /data
utf_8: remove coisas Unicode multibyte esquisitasiso8859_1: translitera acentos alemães/franceses-v: mostra exatamente o que está sendo renomeado (altamente recomendado)
🔁 Agora meu pipeline de backup fica assim
# Step 1: Clean up file names
detox -r -s utf_8 -s iso8859_1 -v /data
# Step 2: Run versioned backup
rdiff-backup /data /mnt/backup/data
Desde que coloquei o detox na mistura, minhas execuções do rdiff-backup estão lisas como manteiga — mesmo sincronizando arquivos bagunçados do macOS, de pendrives ou de pastas sincronizadas na nuvem.
🧙 Automatize como um nerd
Se você curte scripts, aqui vai um exemplo sem firula:
#!/bin/bash
SOURCE="/data"
TARGET="/mnt/backup/data"
# Clean first
detox -r -s utf_8 -s iso8859_1 -v "$SOURCE"
# Then backup with version history
rdiff-backup "$SOURCE" "$TARGET"
Coloque no cron, no systemd ou no que for o seu sabor de automação. Seu eu do futuro vai agradecer.
📚 Considerações finais
Se você roda backups, sincroniza entre sistemas operacionais diferentes ou só quer nomes de arquivos que não façam seus shell scripts chorarem, o detox é indispensável.
É pequeno, rápido, recursivo e salvou minha pele. Principalmente junto com o rdiff-backup, ele deixa seu pipeline de backup bem mais resiliente e determinístico.
E lembre-se: lixo entra, lixo sai. Primeiro limpe, depois faça o backup.
