CLI tool for renaming files to remove toxic or problematic characters from filenames
notox is a command-line file renaming utility that sanitizes filenames by removing or replacing problematic characters. Similar to the detox tool, it processes file and directory paths to eliminate characters that might cause issues across different operating systems or file systems.
The tool operates in a safe-by-default mode, displaying proposed changes without executing them unless the --do flag is specified. This preview functionality allows users to review all planned renames before committing to changes. notox can process multiple paths simultaneously and outputs results in various formats including plain text, JSON, or quiet mode for scripting scenarios.
Beyond command-line usage, notox functions as a Rust library with a programmatic API. The library accepts HashSet collections of PathBuf objects and provides configurable output formats through the NotoxArgs structure. This dual CLI/library design makes it suitable for both interactive file management tasks and integration into larger Rust applications that need filename sanitization capabilities.
# via Cargo
cargo install notox