google_photos_mobile_client

Google Photos client based on reverse engineered mobile API.

---

CLI Demo

Features

• Unlimited uploads in original quality (can be disabled).
• Use as a CLI tool or Python library.
• Skips files already present in your account.
• Upload individual files or entire directories, with optional recursive scanning.
• Album creation based on directory structure or custom album name.
• Real-time progress tracking.
• Configurable threads for faster uploads (default: 1).

Installation

Run the command:

pip install https://github.com/xob0t/google_photos_mobile_client/archive/refs/heads/main.zip --force-reinstall

Example Usage

Note

If auth_data is omitted, GP_AUTH_DATA env variable will be used

Python Client

from gpmc import Client

path = "/path/to/media_file.jpg" # file or dir path
auth_data = "androidId=216e583113f43c75&app=com.google.android.app..."


client = Client(auth_data=auth_data)
output = client.upload(target=path, show_progress=True)

print(output)

# {"/absolute/path/to/media_file.jpg": "google_photos_media_key"}

CLI

gpmc "/path/to/media_file.jpg" --progress --auth-data "androidId=216e583113f43c75&app=com.google.android.app..."

usage: gpmc [-h] [--auth_data AUTH_DATA] [--album ALBUM] [--proxy PROXY] [--progress] [--recursive] [--threads THREADS] [--force-upload] [--delete-from-host] [--use-quota] [--saver] [--timeout TIMEOUT]
            [--log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}] [--filter FILTER] [--exclude] [--regex] [--ignore-case] [--match-path]
            path

Google Photos mobile client.

positional arguments:
  path                  Path to the file or directory to upload.

options:
  -h, --help            show this help message and exit
  --auth_data AUTH_DATA
                        Google auth data for authentication. If not provided, `GP_AUTH_DATA` env variable will be used.
  --album ALBUM         Add uploaded media to an album with given name. If set to 'AUTO', albums will be created based on the immediate parent directory of each file.
                        Example for using 'AUTO':
                        When uploading '/foo':
                        '/foo/image1.jpg' goes to 'foo'
                        '/foo/bar/image2.jpg' goes to 'bar'
                        '/foo/bar/foo/image3.jpg' goes to 'foo' (distinct from the first 'foo' album)
  --proxy PROXY         Proxy to use. Format: `protocol://username:password@host:port`
  --progress            Display upload progress.
  --recursive           Scan the directory recursively.
  --threads THREADS     Number of threads to run uploads with. Defaults to 1.
  --force-upload        Upload files regardless of their presence in Google Photos (determined by hash).
  --delete-from-host    Delete uploaded files from source path.
  --use-quota           Uploaded files will count against your Google Photos storage quota.
  --saver               Upload files in storage saver quality.
  --timeout TIMEOUT     Requests timeout, seconds. Defaults to 60.
  --log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}
                        Set the logging level (default: INFO)

File Filter Options:
  --filter FILTER       Filter expression.
  --exclude             Exclude files matching the filter.
  --regex               Use regex for filtering.
  --ignore-case         Perform case-insensitive matching.
  --match-path          Check for matches in the path, not just the filename.

auth_data? Where Do I Get Mine?

You only need to do this once.

Option 1 - ReVanced. No root required

1. Install Google Photos ReVanced on your device.

   • Install GmsCore https://github.com/ReVanced/GmsCore/releases
   • Install patched apk https://github.com/j-hc/revanced-magisk-module/releases or patch it yourself

2. Connect the device to your PC via ADB.

3. Open the terminal on your PC and execute

   Windows

   adb logcat | FINDSTR "auth%2Fphotos.native"

   Linux/Mac

   adb logcat | grep "auth%2Fphotos.native"

4. If you are already using ReVanced - remove Google Account from GmsCore.

5. Open Google Photos ReVanced on your device and log into your account.

6. One or more identical GmsCore logs should appear in the terminal.

7. Copy text from androidId= to the end of the line from any log.

8. That's it! 🎉

Option 2 - Official apk. Root required

Click to expand

1. Get a rooted android device or an emulator. Recommended Android versions 9-13

2. Connect the device to your PC via ADB.

3. Install HTTP Toolkit

4. In HTTP Toolkit, select Intercept - Android Device via ADB. Filter traffic with

   contains(https://www.googleapis.com/auth/photos.native)
   

   Or if you have an older version of Google Photos, try

   contains(www.googleapis.com%2Fauth%2Fplus.photos.readwrite)
   

5. Open Google Photos app and login with your account.

6. A single request should appear.
   Copy request body as text.
   

7. Now you've got yourself your auth_data! 🎉

Troubleshooting

• No Auth Request Intercepted
  1. Log out of your Google account.
  2. Log in again.
  3. Try Android App via Frida interception method in HTTP Toolkit.

My Other Google Photos Scripts And Tools

• Web api python client: https://github.com/xob0t/google_photos_web_client
• Disguise any file as media for GP to accept and store it: https://github.com/xob0t/gp-file-hide
• Manage library with bulk operations: https://github.com/xob0t/Google-Photos-Toolkit