https://github.com/huangsam/photohaul

Effortless photo management
https://github.com/huangsam/photohaul

canon dropbox file-transfer google-drive gradle java jpeg lightroom nas-storage nikon photo photography png productivity-tools sony

Last synced: 7 days ago
JSON representation

Effortless photo management

• Host: GitHub
• URL: https://github.com/huangsam/photohaul
• Owner: huangsam
• License: mit
• Created: 2024-11-23T23:23:27.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2024-12-30T17:59:46.000Z (about 1 month ago)
• Last Synced: 2025-01-17T18:16:59.793Z (16 days ago)
• Topics: canon, dropbox, file-transfer, google-drive, gradle, java, jpeg, lightroom, nas-storage, nikon, photo, photography, png, productivity-tools, sony
• Language: Java
• Homepage:
• Size: 6.47 MB
• Stars: 64
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Photohaul

[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/huangsam/photohaul/ci.yml)](https://github.com/huangsam/photohaul/actions)

[![Code Coverage](https://img.shields.io/codecov/c/github/huangsam/photohaul)](https://codecov.io/gh/huangsam/photohaul)

[![License](https://img.shields.io/github/license/huangsam/photohaul)](https://github.com/huangsam/photohaul/blob/main/LICENSE)

Effortless photo management.

- Reorganize 10K+ photos (30 GB) in seconds!

- Migrate photos locally and to the cloud (Dropbox, Google Drive)

- Customize folder structures based on date, camera, and more

- Filter photos by file type, size, and other criteria

Say goodbye to photo clutter - 👋 + 🚀

![Sunny Bunny Tidy Up](images/sunny-bunny-tidy-up.webp)

## 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](USERGUIDE.md)

**Install prerequisites:**

- Java 17 or later

- Gradle 8 or later

**Build application:**

- Run `./gradlew build` in your terminal

**Configure settings:**

- Set `PathRuleSet` to filter by extension, file size, etc.

- Set `MigratorMode` to `PATH`, `DROPBOX` or `GOOGLE_DRIVE`

- Set `PhotoResolver` to adjust folder structure

- Fill config file. Refer to examples in [src/main/resources](src/main/resources)

**Run application:**

- Run `./gradlew run` in your terminal

![Migration](images/migration-step.png)

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

You're welcome 🙏