fren

File renamer toolkit. Slugify, directorize, flatten, and normalize filenames.

Extra: uv tool install buvis-gems[fren]

Commands

fren slug

Slugify filenames — convert to URL-safe lowercase with hyphens.

fren slug file1.txt file2.txt
fren slug *.pdf

fren directorize

Wrap each file in a directory named after the file stem.

fren directorize ~/downloads/

fren flatten

Copy nested files into a flat destination directory.

fren flatten ~/nested-dir/ ~/flat-output/

fren normalize

NFC-normalize directory names (Unicode normalization).

fren normalize ~/documents/