shishir0x/GoogleUnlimited

选用指南

AI 根据 README 整理 · 2026/10/16 09:31:22

使用方式

通过命令行或交互式菜单使用，支持 watch、status、logs、enable、disable、stop 等命令。

查看 README 依据

- **Multi-OS Interoperability**: Windows, macOS, and Linux scripts share the exact same SQLite database schema (`gphotos.db`), with dual-key lookups (`path` + `filename|filesize`) to seamlessly prevent duplicate uploads on shared or external partitions. - **Unified Clean Architecture (Zero Clutter)**: - **Windows**: `GoogleUnlimited.bat` provides an interactive menu or CLI commands (`watch`, `silent`, `status`, `logs`, `enable`, `disable`, `stop`).

- **macOS & Linux**: `google-unlimited.sh` unified runner (`watch`, `status`, `logs`, `setup`, `enable`, `disable`, `stop`). Zero separate script clutter. - **Real-Time Auto-Sync**: Monitors standard user folders instantly when files are downloaded or saved, with debounce protection for active downloads. - **Embedded SQLite Tracking**: Tracks every upload in `gphotos.db` — zero duplicate re-uploads, crash-resilient with automatic retry queues. - **Live Terminal Progress Bar**: Real-time dynamic progress bar, elapsed timer, and file size indicator. - **Background Auto-Start**:

部署要求

Windows 需要 PowerShell；macOS 需要 Homebrew 安装 fswatch；Linux 需要 inotify-tools、sqlite3、curl。

查看 README 依据

- **Unlimited Google Photos Backup**: Spoofs Google Pixel mobile upload API ([`xob0t/gotohp`](https://github.com/xob0t/gotohp)) so all uploaded photos and videos consume **0 bytes of Google Drive / Google One storage**. - **Cross-Platform (Windows, macOS & Linux)**: - **Windows**: Native PowerShell engine with bundled portable `PSSQLite`. - **macOS**: Native Bash + `fswatch` engine supporting both Apple Silicon (M1-M4) and Intel Macs via universal binary. - **Linux**: Native POSIX Bash + `inotify-tools` engine for all major distributions (Ubuntu, Debian, Fedora, Arch).

GoogleUnlimited.bat stop # Stop any running background watcher ``` --- ## macOS Setup & Usage GoogleUnlimited runs natively on macOS (Apple Silicon M1/M2/M3/M4 & Intel) using `fswatch`, `sqlite3`, and the official universal Mach-O binary. ### 1. Clone the Repository ```bash git clone https://github.com/shishir0x/GoogleUnlimited.git cd GoogleUnlimited ``` ### 2. One-Command Setup Make executable and run setup (auto-installs `fswatch` via Homebrew and downloads the universal binary): ```bash chmod +x google-unlimited.sh ./google-unlimited.sh setup ```

git clone https://github.com/shishir0x/GoogleUnlimited.git cd GoogleUnlimited ``` ### 2. One-Command Setup Run setup to auto-install dependencies (`inotify-tools`, `sqlite3`, `curl`): ```bash chmod +x google-unlimited.sh ./google-unlimited.sh setup ``` ### 3. Sign In (One-Time) #### Option A: Retrieve `oauth_token` via Browser 1. In any web browser, open the Google Embedded Setup sign-in page: 👉 **[https://accounts.google.com/embedded/setup/v2/android](https://accounts.google.com/embedded/setup/v2/android)** 2. Sign in with your Google account and click **I agree**.

已知限制

需要手动获取 Google 账号的 oauth_token 进行登录，且登录页面可能无限缓冲属正常现象。

查看 README 依据

1. Double-click **`gotohp-x64.exe`** and click **Add Google account**. 2. Click **Open Google sign-in** and sign in with your Google account. 3. Sign in on the Google Embedded Setup page and click **I agree**. *(Note: The page buffering indefinitely is completely normal and expected).* 4. Open browser Developer Tools (**F12**): - Go to **Application** tab (Chrome/Edge/Brave) or **Storage** tab (Firefox). - Under **Cookies**, click `https://accounts.google.com`. - Copy the value of the **`oauth_token`** cookie. 5. In `gotohp`, paste the token and click **Connect account**.

*(If Homebrew is not installed, install it with: `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`)* ### 3. Sign In (One-Time) 1. Open the Google Embedded Setup sign-in page: 👉 **[https://accounts.google.com/embedded/setup/v2/android](https://accounts.google.com/embedded/setup/v2/android)** 2. Sign in with your Google account and click **I agree** *(buffering indefinitely is normal)*. 3. Press **Option + Command + I** (or right-click → **Inspect**) to open Developer Tools: