🧼 Bestandsnamen opschonen op Linux met detox – de kleine tool die mijn back-ups redde

Illustratie: een man die reusachtige letters schoonmaakt met een plantenspuit

🌐 Ook in: English · Deutsch · Français · Español · Italiano · Português · Polski

😤 Als een back-up mislukt... vanwege een bestandsnaam

Onlangs crashte een van mijn geautomatiseerde back-ups op Linux onverwacht halverwege. Geen mooie foutmelding, geen nette fallback — gewoon een stille afbreking.

Na flink wat hardcore grep en speleologie in de logs vond ik de boosdoener: één enkel bestand met een niet-conforme bestandsnaam die de back-uptool niet kon verwerken. Erger nog — het bestand kwam van een macOS-systeem (MacBook Air). Natuurlijk. 😅

Blijkt dat macOS er dol op is om wat schattige Unicode-eigenaardigheden, onzichtbare tekens en creatief gebruik van speciale symbolen rond te strooien. Prima voor mensen, minder prima voor Linux-bestandssystemen of back-uptools.

💾 Maak kennis met rdiff-backup: mijn favoriete wapen voor geversioneerde back-ups

Ik gebruik rdiff-backup voor mijn dagelijkse back-ups omdat het geversioneerde, incrementele back-ups ondersteunt — zoals Time Machine, maar nerdiger en CLI-vriendelijk:

rdiff-backup /data /mnt/backup/data

Maar nu komt het: rdiff-backup verslikte zich in die misvormde bestandsnaam en gaf het op. Geen incrementele magie, geen versiebeheer — alleen falen.

Les geleerd: schoon je bestanden op voordat je ze back-upt. Dus voegde ik een stap toe vóór de back-up: detox.

🧼 Wat is detox en waarom zou het je iets kunnen schelen?

detox is een kleine Linux-commandlinetool die recursief rommelige bestandsnamen opschoont door problematische tekens te verwijderen, zoals:

  • Spaties
  • Umlauten (ä, ö, ü → ae, oe, ue)
  • Unicode-waanzin
  • Vreemde symbolen en stuurtekens

Perfect voor bestanden die van... nou ja... overal vandaan komen waar geen Linux draait.

🛠️ Installeren

Op de meeste distro’s is het zo simpel als:

sudo apt install detox

🚀 Basisgebruik

Om een map recursief op te schonen:

detox -r /your/directory

🔧 Voorbeeld van voor/na-magie

Originele bestandsnaamOpgeschoond
Urlaubsfotos 2024 (Köln).jpgUrlaubsfotos_2024_Koeln.jpg
Résumé_finalé.pdfResume_finale.pdf
Projekt 1#Beta!.zipProjekt_1Beta.zip

🧪 Aanbevolen schemes

detox ondersteunt verschillende “schemes” die bepalen hoe bestandsnamen worden opgeschoond. Dit werkte voor mij het best:

detox -r -s utf_8 -s iso8859_1 -v /data
  • utf_8: verwijdert rare multibyte-Unicode-dingen
  • iso8859_1: translitereert Duitse/Franse accenten
  • -v: laat precies zien wat er hernoemd wordt (sterk aanbevolen)

🔁 Zo ziet mijn back-uppipeline er nu uit

# 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

Sinds ik detox aan de mix heb toegevoegd, lopen mijn rdiff-backup-runs zo soepel als boter — zelfs bij het synchroniseren van rommelige bestanden van macOS, USB-sticks of gesynchroniseerde cloudmappen.

🧙 Automatiseer het als een nerd

Als je van scripten houdt, hier een voorbeeld zonder poespas:

#!/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"

Zet het in cron, systemd of welke smaak automatisering je ook prefereert. Je toekomstige zelf zal je dankbaar zijn.

📚 Slotgedachten

Als je back-ups draait, tussen besturingssystemen synchroniseert of gewoon bestandsnamen wilt die je shellscripts niet aan het huilen maken, dan is detox een must-have.

Het is klein, snel, recursief en het heeft mijn hachje gered. Vooral in combinatie met rdiff-backup maakt het je back-uppipeline een stuk robuuster en deterministischer.

En onthoud: garbage in, garbage out. Eerst opschonen, dan back-uppen.

📣 Heb je een verhaal waarin een bestandsnaam je dag verpestte? Of een betere tool dan detox? Laat een reactie achter en laten we lekker nerden!

Sommige teksten en afbeeldingen op deze site zijn met hulp van AI gemaakt of door AI gegenereerd. Details