Skip to content

Phaedrus157/jaaPhotoOrganization

Repository files navigation

📸 jaaPhotoOrganization

Python utilities for organizing, renaming, and processing photo files. Each script targets a specific workflow for cataloging, renaming, and converting images.

📦 Features

  • Count Python files in a directory
  • Analyze and classify filenames by pattern
  • Simulate and perform batch renaming of generic filenames
  • Convert RAW files to DNG format
  • Ingest and organize RAW files by date or project
  • Survey and list files in a folder
  • Robust collision handling and dry-run support

🗂️ Scripts Overview

count_files.py

Count the number of .py files in a given directory. Usage:

python count_files.py

analyze_filenames.py

Classify filenames in a folder as generic (Doxie, IMAG, IMG) or original. Prints a summary. Usage:

python analyze_filenames.py

dryrename.py

Simulate renaming generic files (Doxie, IMAG) to a sequential format. No changes are made. Usage:

python dryrename.py

genrename.py / genrename2.py

Batch rename generic files to a sequential SCAN_#### format, skipping existing files. Usage:

python genrename.py
python genrename2.py

ingest_raw.py

Move .CR2 files from a source folder to a dated/project subfolder in the destination. Usage:

python ingest_raw.py

rename.py / dryrun.py

Rename or simulate renaming image files in a directory tree, applying patterns and collision resolution. Usage:

python rename.py
python dryrun.py

rename_originals.py

Rename files in a folder to a sequential IMG_####.CR2 format. Usage:

python rename_originals.py

survey_filenames.py

Print a numbered list of all files in a folder. Usage:

python survey_filenames.py

⚙️ Setup

  1. Clone the repository:
    git clone https://github.com/Phaedrus157/jaaPhotoOrganization
  2. Open in VS Code. Recommended: use the provided .vscode settings for linting and tasks.
  3. Edit script paths as needed for your environment.
  4. Run scripts from the command line or VS Code tasks.

📝 Notes

  • Scripts use hardcoded Windows paths; update these for your system.
  • All scripts include docstrings and type hints for maintainability.
  • For large batch operations, use dry-run scripts first to preview changes.

📄 License

MIT License. See LICENSE for details.

Releases

No releases published

Packages

No packages published

Languages