Photohaul

Effortless photo management.

• Sync Anywhere: Local, Cloud (S3, GDrive, Dropbox), or SFTP.
• Auto-Organize: Custom paths by date, camera, or file type.
• Smart Logic: Hash-based deduplication and incremental runs.
• Speed & Control: Configurable concurrent migrations to optimize network utilization.
• Risk-Free: Built-in dry run simulation.

Say goodbye to photo clutter - 👋 + 🚀

Motivation

As an avid photographer, I use Adobe Lightroom to organize my edited SLR photos with custom file names and folder structures. This has worked well for me since 2015, when I started getting serious about photography.

I want to apply those same patterns to old photos, so that it is easier for me to access my precious memories. However, I struggle to apply the same organization to my vast collection of older photos. I cannot apply Lightroom settings to previously exported images and writing custom scripts seems daunting.

I also want to migrate my photos over to a NAS or a cloud provider like Google Drive, but it involves endless rounds of manual drag-and-drop operations. I keep thinking to myself - is there a solution out there that "just works" for my workflow?

Value

Photohaul addresses the pain points above by providing a central hub for photographers to filter, organize, and migrate photos to local storage and cloud services. The folder structure for photos can be based on info such as year taken and camera make.

Getting started

For detailed instructions: link

Install prerequisites:

• Java 21 or later
• Gradle 9 or later

Configure settings:

• Set your Filtering rules to filter by extension, file size, etc.
• Set the Migration mode (e.g., Local Path, Dropbox, Google Drive, SFTP, S3)
• Set your Folder structure preferences to adjust how photos are organized
• Fill config file. Refer to examples in src/main/resources

Run application:

• Run ./gradlew run in your terminal
  • Optional: override -Dphotohaul.config with classpath or filesystem path.

> Task :run
08:05:14.518 [main] INFO io.huangsam.photohaul.Settings -- Use config file from photohaul.config: personal/path.properties
08:05:14.520 [main] INFO io.huangsam.photohaul.Settings -- Loaded settings from classpath: personal/path.properties
08:05:14.526 [main] DEBUG io.huangsam.photohaul.traversal.PathWalker -- Start traversal of /Users/samhuang/Pictures/Dummy PNG
08:05:14.536 [main] INFO io.huangsam.photohaul.deduplication.PhotoDeduplicator -- Deduplication complete: 6 unique photos, 0 duplicates removed
08:05:14.536 [main] DEBUG io.huangsam.photohaul.migration.PathMigrator -- Start path migration to /Users/samhuang/Pictures/Dummy FIN
08:05:14.627 [main] INFO io.huangsam.photohaul.Application -- Finish with success=6 failure=0

BUILD SUCCESSFUL in 535ms
3 actionable tasks: 1 executed, 2 up-to-date

That's it! Sit back and rediscover your memories! 😎 + 🍹 + 🌴

You're welcome 🙏