Detox

Detox is a utility designed to clean up filenames. It replaces difficult to work with characters, such as spaces, with standard equivalents. It will also clean up filenames with UTF-8 or Latin-1 (or CP-1252) characters in them.

For instance:

$ ls Future Crew - Skaven - 2nd Reality.s3m $ detox -v . Scanning: . ./Future Crew - Skaven - 2nd Reality.s3m -> ./Future_Crew-Skaven-2nd_Reality.s3m $ ls Future_Crew-Skaven-2nd_Reality.s3m

Download

The latest release is 1.2.0, available in the download section of the project page. The change log is available here, and the readme is available here.

Features

Removal or replacement of upper ASCII Latin-1 (ISO 8859-1) characters (i.e. left facing and right facing double quotes). Whenever possible a replacement character will be used (i.e. an "A" will take the place of an "A" with an accent mark over it).

Removal or replacement of UTF-8 encoded Unicode characters. This operates along the same line as the ISO 8859-1 translation, except the scope of Unicode is much larger.

Removal or replacement of spaces and other potentially tricky characters, such as (, ), and @. Removal of any "-"s at the beginning of the filename.

Removal or replacement of CGI escaped ASCII characters, i.e. %20 becomes " " (which then becomes "_").

Trimming of excessive "_" and "-"s.

Directory recursion, dry runs, verbose listings.

It's designed with safety in mind. It won't overwrite to a file that already exists, and it doesn't touch special files normally (but it can be asked to).

Manual Pages

detox

detoxrc

detox.tbl

Translated using man2web.

Screen Shot

History

It was originally a personal project, written a few years ago to clean up the names of MP3s ripped under Windows. It started with simply removing spaces, and grew more complex from there. I've been using it for quite some time, and I'd like to give something of immediate value back to the community. It was originally written under Linux, and it's presently developed under FreeBSD.

Links

Distros and Live-CDs

Detox is included with the following distributions:

Thank Yous

Thanks to SourceForge.net for hosting the development and distribution of detox.

Special thanks to my wife, Robyn, for creating the logo for detox.

$Id: index.html,v 1.13 2008/04/12 02:46:17 purgedhalo Exp $