https://github.com/huangsam/photohaul

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

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

Last synced: 11 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 (30 days ago)
• Default Branch: main
• Last Pushed: 2024-12-08T06:09:42.000Z (15 days ago)
• Last Synced: 2024-12-08T06:22:26.562Z (15 days ago)
• Topics: canon, dropbox, google-drive, gradle, java, jpeg, lightroom, nikon, photo, photography, png, productivity-tools, sony
• Language: Java
• Homepage:
• Size: 5.86 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• 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)

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

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

Effortless photo management.

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

- Migrate photos locally and to the cloud

Say goodbye to photo clutter - 👋 + 🚀

![Sunny Bunny Tidy Up](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. Unfortunately, Lightroom settings

cannot apply to photos after they are exported. And writing bespoke

scripts to manage these photos is no fun!

If I also want to migrate my photos over to a NAS or a cloud provider

like Google Drive, it typically involves many drag + drop operations.

After a few dozen times, I get tired of doing it again and again.

## Value

Photohaul addresses the pain points above by providing a central hub

for photographers to filter, organize, and migrate photos to local

storage or cloud services. The folder structure for photos can be based

on info such as year taken and camera make.

## Getting started

Prerequisites:

- Java 17+ installed on your system

- Gradle 8+ installed on your system

- Basic understanding of command line tools

Steps:

1. Run `gradle build` in your terminal to build the application

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

3. Set `MigratorMode` to `PATH`, `DROPBOX` or `GOOGLE_DRIVE`

4. Set `PhotoResolver` to adjust folder structure for photos

5. Set `Settings` to your properties file in `src/main/resources`

6. Fill relevant parameters in your properties file

7. Run `gradle run` in your terminal to start the magic!

Then sit back and rediscover your memories! 😎 + 🍹 + 🌴

You're welcome 🙏