shishir0x / GoogleUnlimited

# GoogleUnlimited
> Automated, cross-platform media synchronization utility for Google Photos. 
> Runs as a lightweight native background watcher on Windows, macOS, and Linux to automatically sync photos and videos using Google Pixel device emulation powered by `xob0t/gotohp` — without virtual machines, Android emulators, Windows Subsystem for Android (WSA), or WSL.
---
## Table of Contents
- Overview
- Features
- Requirements
- Quick Start
 - Windows
 - macOS
 - Linux
- Authentication and Account Setup
- Commands Reference
- Folder Monitoring & Supported Media
 - Monitored Folders
 - Custom Watch Folders (`watch_dirs.txt`)
 - Supported Media Formats
 - File Readiness & Lock Detection
- Background Operation
 - Windows (VBScript & Startup Folder)
 - macOS (launchd LaunchAgent)
 - Linux (systemd User Service)
 - Single-Instance Protection
- Data Storage, Privacy, and Security
- Troubleshooting
- Limitations and Disclaimer
- Credits and License
---
## Overview
**GoogleUnlimited** monitors local folders on your computer and automatically synchronizes eligible photos and videos to your Google Photos library. It pairs native operating system event watchers (PowerShell on Windows, `fswatch` on macOS, and `inotify-tools` on Linux) with an embedded SQLite database (`gphotos.db`) and the standalone `gotohp` CLI binary.
The upload engine communicates directly with Google's mobile upload endpoints using Google Pixel device emulation. Because the requests present as a Pixel device, media backed up through this mechanism is processed according to Google Photos Pixel backup rules.
---
## Features
- **Real-Time Filesystem Monitoring**:
 - **Windows**: Uses .NET `FileSystemWatcher` with an expanded 64 KB event buffer and a 1.5-second debounce window to prevent redundant uploads on burst writes.
 - **macOS**: Uses `fswatch` for continuous low-latency filesystem event streaming.
 - **Linux**: Uses `inotifywait` (`inotify-tools`) listening to `close_write`, `moved_to`, and `create` kernel events.
- **Initial Sync & Periodic Safety Sweeps**:
 - Traverses all monitored directories at startup (Phase 1) to upload any existing unrecorded media.
 - Runs periodic background safety sweeps (every 30 seconds on Windows, every 15 minutes on macOS/Linux) to detect offline camera imports or files added while the watcher was paused.
- **Cross-Platform Content-Hash Deduplication**:
 - Tracks all uploaded files in a local SQLite database (`gphotos.db`) using WAL mode.
 - Lookups use both file paths and a combined `filename|filesize` key paired with a SHA-256 `content_hash`. This prevents duplicate re-uploads on dual-boot machines or shared external drives where paths differ between operating systems.
- **Active Download & Lock Detection**:
 - Verifies file size stability across multiple sampling checks and tests for exclusive write access before uploading. This prevents uploading partial files during active web downloads, screen recordings (OBS, Xbox Game Bar), or video rendering e