File: README.md

package info (click to toggle)
detox 1.4.5-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, sid
  • size: 720 kB
  • sloc: ansic: 2,173; sh: 857; yacc: 284; lex: 86; makefile: 35
file content (42 lines) | stat: -rw-r--r-- 1,056 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
# Overview

`detox` is a program that renames files to make them easier to work with under
Unix and related operating systems.  Spaces and various other unsafe
characters (such as "$") get replaced with "_".  ISO 8859-1 (Latin-1)
characters can be transliterated to ASCII, as can UTF-8 characters.
More details are contained in the `detox.1` man page.

# Runtime Notes

The most important option to learn is `-n`, aka `--dry-run`.  This will let you
run `detox` without actually changing any files, so that you can get an idea
of what `detox` is all about.

The simplest way to run `detox` is to just run it on a directory containing
files that need work:

	detox xfer_files/

You can also just to specify the filename:

	detox my\ bad\ file.txt

You can also specify recursion (this works best on directories):

	detox -r /music/transferred_from_elsewhere/

# Build

To build `detox` from source, run:

```
git clone https://github.com/dharple/detox.git
cd detox
autoreconf --install
./configure
make
```

# Contact

Doug Harple <detox.dharple@gmail.com>