renx 0.0.3

Advanced file renaming tool with regex and case transformation support

renx - Advanced File Renaming Tool

renx is a powerful command-line utility for batch renaming files and directories with advanced pattern matching and transformation capabilities.

☕ Support

If you find this project helpful, consider supporting me:

Features

• Recursive directory traversal (top-down or bottom-up)
• Multiple renaming transformations:
  • Case conversion (lowercase/uppercase)
  • URL-safe filename generation
  • Regular expression substitutions
• Flexible filtering:
  • Include/exclude by glob patterns or regex
  • Maximum depth control
• Safety features:
  • Dry-run mode by default
  • Preview changes before executing

Installation

pip install renx

Usage

python -m renx [OPTIONS] [PATHS...]

Basic Examples

1. Dry-run preview (default behavior):

   python -m renx /path/to/files
   

2. Convert filenames to lowercase:

   python -m renx --lower /path/to/files
   

3. Actually perform renames (disable dry-run):

   python -m renx --act --lower /path/to/files
   

4. Make filenames URL-safe:

   python -m renx --urlsafe /path/to/files
   

Regex Substitutions

The --subs (-s) option supports Perl-style regex substitutions:

Format: /DELIMITER/PATTERN/DELIMITER/REPLACEMENT/DELIMITER/FLAGS

Examples:

1. Replace spaces with underscores:

   python -m renx -s '/ /_/g' /path/to/files
   

2. Remove special characters:

   python -m renx -s '/[^a-zA-Z0-9.]//' /path/to/files
   

3. Add prefix to numbered files:

   python -m renx -s '/(\d+)/image_$1/' *.jpg
   

4. Case-insensitive extension fix:

   python -m renx -s '/\.jpe?g$/.jpg/i' *
   

Filtering Options

1. Process only matching files:

   python -m renx --name '*.txt' --lower /path/to/files
   

2. Exclude directories:

   python -m renx --exclude 'temp/*' /path/to/files
   

3. Limit recursion depth:

   python -m renx --max-depth 2 /path/to/files