# ownCloud Photo Organizer

## Overview

ownCloud's Android app does not support automatic year/month subfolder creation
during instant upload (unlike Nextcloud). This script compensates by running
nightly and sorting all uploaded photos and videos into a `YEAR/YEAR-MM/`
folder structure.

## Script

**Location on server:** `/usr/local/bin/organize_photos.sh`

**Source folder watched:**
`/mnt/INTEL-SSD/ownCloud - Joe Gitta@cloud.jgitta.com/Personal/InstantUpload`

**Subfolders processed:** `Camera`, `BlueIris`, `Facebook`, `scans`, `EufyVideoDir`

**Supported file types:** jpg, jpeg, png, gif, heic, webp, bmp, tiff, mp4, mov, pdf

## How It Works

The script reads the date from each filename using these patterns (in order):

1. `YYYYMMDD` embedded in the filename (e.g. `20231022_082107.jpg`)
2. `YYYY-MM-DD` or `YYYY_MM_DD` format
3. 13-digit Unix timestamp in milliseconds (e.g. `FB_IMG_1572815868839.jpg`)
4. `MM_DD_YYYY` prefix (scans folder format, e.g. `06_11_2026_7_28_16_AM.pdf`)

Files that don't match any pattern are moved to `_unsorted/` for manual review.

## Output Structure

```
InstantUpload/
└── Camera/
    ├── 2023/
    │   ├── 2023-06/
    │   └── 2023-12/
    ├── 2024/
    │   └── 2024-03/
    └── _unsorted/
```

## Cron Job

Runs nightly at 2:00 AM as root:

```
0 2 * * * /usr/local/bin/organize_photos.sh
```

To view or edit: `sudo crontab -e`

## Log File

Each run appends to `/var/log/organize_photos.log`:

```
=== 2026-06-14 02:00:01 Starting ===
  Moved: 12  Unsorted: 0  Skipped: 0  Errors: 0
=== Done ===
```

Check the log anytime with:
```bash
cat /var/log/organize_photos.log
```

## Installation

```bash
sudo cp organize_photos.sh /usr/local/bin/organize_photos.sh
sudo chmod +x /usr/local/bin/organize_photos.sh
(sudo crontab -l; echo "0 2 * * * /usr/local/bin/organize_photos.sh") | sudo crontab -
```