Quickstart

1. Check a folder for missing date prefixes

fslint --dateprefix ./Photos/

Any file or folder without a YYYY, YYYY-MM, or YYYY-MM-DD prefix is printed to stdout. Exit code is 1 if violations exist, 0 otherwise.

2. Narrow the scope with filters

Only check files (not folders):

fslint --isfile --dateprefix ./Photos/

Only check .jpg files:

fslint --isext jpg --dateprefix ./Photos/

Only check Android screenshots:

fslint --isfile --isext png --pattern 'Screenshot_*' --dateprefix ./Screenshots/

Filters are cumulative — an entry must pass every active filter to be included in validation.

3. Fix filenames with a fixer script

List what would change (dry run):

python src/fslint/fix_android_photo.py ./Photos/

Apply the changes:

python src/fslint/fix_android_photo.py --execute ./Photos/

Then verify:

fslint --isfile --isext jpg --dateprefix ./Photos/