HEIC Sync

A collection of scripts for managing and syncing photos from OneDrive, with special support for Live Photos.

Overview

This repository contains a set of Python and PowerShell scripts that help with:

1. Downloading Live Photos from OneDrive
2. Syncing photos between different locations
3. Scanning photo libraries
4. Managing photo backups

Scripts

Python Scripts

get_onedrive_token.py

A Python script to obtain an OAuth2 access token for OneDrive using the official OneDrive client ID. This is required for accessing OneDrive's API.

Usage:

python get_onedrive_token.py

The script will:

1. Open your browser for authentication
2. Handle the OAuth2 flow
3. Save the token data (including refresh token) to onedrive_token.json

Note: The script uses the official OneDrive client ID and doesn't require any additional setup.

run_ps_download.py

A Python wrapper for the PowerShell Live Photo downloader. It handles the execution of the PowerShell script with proper year/month path organization.

Usage:

# Process current month (and last month if today is the 1st)
python run_ps_download.py --base-save-to "D:\Photos\OneDrive-Photo" --base-path-to-scan "\Photos\Auto-saved"

# Process specific month (2 for last month, 3 for month before last, etc.)
python run_ps_download.py --base-save-to "D:\Photos\OneDrive-Photo" --base-path-to-scan "\Photos\Auto-saved" --months 2

sync_task.py

Handles syncing of photos between different locations, organizing them by year/month.

Usage:

# Sync OneDrive to Local(Backup)
python sync_task.py d:\OneDrive\Photos\Auto-saved\ D:\Photos\Auto-saved --months 1

# Sync Photo to NAS
python sync_task.py d:\OneDrive\Photos\Auto-saved\ \\tiger-nas\Multimedia\Photos\ --months 1

# Sync Local Motion to NAS
python sync_task.py D:\Photos\OneDrive-Photo\ \\tiger-nas\Multimedia\Photos\ --months 1

scan_lib.py

Scans a Immich library using its API. This is useful for updating your media server's photo library.

Usage:

python scan_lib.py

PowerShell Scripts

Download-ODLivePhotosV2.ps1

The main script for downloading Live Photos from OneDrive. It handles authentication and downloading of both the image and video components of Live Photos.

Usage:

.\Download-ODLivePhotosV2.ps1 -SaveTo "C:\Live Photos" -PathToScan "\Pictures\Camera Roll"

Requirements

• Python 3.x
• PowerShell 5.1 or later
• Microsoft Edge WebView2 Runtime (for Live Photo downloads)
• OneDrive account with Live Photos
• Immich photo server (for library scanning)

Notes

• The scripts are designed to work with a year/month folder structure
• Live Photo downloads require authentication through OneDrive
• Some scripts may need to be run multiple times for large libraries due to potential OneDrive API limitations
• Make sure to have sufficient storage space when downloading Live Photos, as they consist of both image and video files

Error Handling

• The scripts include basic error handling and will skip already downloaded files
• If OneDrive services are temporarily unavailable, you can safely rerun the scripts later
• The scripts maintain the original folder structure from OneDrive