Skip to content
tqmanePublic

About

Google Photo tweak

Resources

Stars

433 stars

Watchers

0 watching

Forks

Repository files navigation

GoToHP for iOS (Gunshot)

English · 日本語

Gunshot (GoToHP for iOS) is a tweak / injected library for the official iOS Google Photos app that spoofs your device as a Google Pixel, enabling original-quality unlimited cloud backups and custom upload behaviors. It integrates an optimized iOS port of the Go core from xob0t/gotohp.

It supports both Jailbroken environments (Rootless and Rootful) and Jailed environments (Sideloading, TrollStore, and LiveContainer).


🌟 Key Features

  • Pixel Spoofing Uploads:
    • Original Quality (Unlimited): Spoofs a Pixel XL (Pixel 1) to upload photos and videos in full original quality without consuming Google Account storage quota.
    • Storage Saver: Spoofs a Pixel 2 for unlimited uploads in Storage Saver quality.
    • Account Storage: Spoofs a Pixel 8 for original quality using standard account quota.
  • Native Backup Routing:
    • Automatically intercepts Google Photos' standard manual and automatic backup triggers and routes them through the GoToHP queue.
    • Seamlessly back up your library simply by using the Google Photos app normally.
  • Zero-Config Account Sync:
    • Automatically detects the signed-in Google account and acquires OAuth tokens via Google Photos' existing SSO framework.
    • No need to extract, copy, or paste tokens manually.
  • Bulk Album Import:
    • Bypasses the iOS system picker limitation (100 items per selection) by importing entire albums directly with batch processing.
  • Full Fidelity & Live Photo Support:
    • Extracts untouched original media directly via PhotoKit without re-encoding.
    • Preserves HEIC, RAW, and pairs both still and video components of Live Photos.
  • Native UI Integration:
    • Integrates the "GoToHP Settings" menu directly into the Google Photos profile sheet.
    • Optional banner to display the authentic Google Pixel "Unlimited storage" badge.
  • Bilingual Support: Fully localized in English and Japanese.

📱 Screenshots

Unlimited storage card in Google Photos profile menu GoToHP Settings entry in profile menu

Upload settings showing signed-in account and quality profiles Native backup routing settings Appearance settings for language and unlimited badge


📦 Packages & Environments

Environment Package Execution Behavior
Jailbreak (Rootless) gotohp-tweak-rootless.deb Uploads via background daemon (gotohpd). Continues uploading even when the app is closed.
Jailbreak (Rootful) gotohp-tweak-rootful.deb Uploads via background daemon (gotohpd). Continues uploading even when the app is closed.
Sideload / TrollStore / LiveContainer gotohp-tweak-jailed.deb
GunshotJailed.dylib
Runs embedded inside the Google Photos app. Active when the app is in the foreground.

Tip

Download ready-to-use packages from Releases or the latest artifacts on GitHub Actions.


🚀 Installation

1. Sideloading / TrollStore / LiveContainer (Non-Jailbroken)

See the full Jailed Installation Guide for detailed walkthroughs.

  • Using Sideloadly:
    1. Open your decrypted Google Photos IPA in Sideloadly.
    2. Under Advanced Options → Inject dylibs/frameworks, add gotohp-tweak-jailed.deb.
    3. Start the installation to your device.
  • Using TrollStore or Manual Injection:
    • Inject gotohp-tweak-jailed.deb into your decrypted IPA (using tools like Azule or Sideloadly Export) and install via TrollStore.
  • Using LiveContainer:
    • Import GunshotJailed.dylib into the LiveContainer tweaks folder for Google Photos.

Important

Inject and enable Gunshot BEFORE signing into your Google account.
GunshotJailed includes automatic SSO identifier and Keychain corrections to fix sideload login issues (no separate Sideload Spoofer required).

2. Jailbreak

  1. Install gotohp-tweak-rootless.deb or gotohp-tweak-rootful.deb through your package manager (Sileo, Zebra, etc.).
  2. Requires libSandy 1.1.6+ from opa334's repository as a dependency.
  3. If Google Photos crashes upon launch, configure Choicy to inject only Gunshot into Google Photos.

📖 How to Use

  1. Launch Google Photos and Sign In
    • GoToHP will automatically connect to your active Google account in the background. No manual token setup needed.
  2. Review Upload Settings
    • Tap your Profile icon → GoToHP Settings.
    • Choose your desired upload quality (Original / Storage Saver / Account Storage).
  3. Upload Photos & Videos
    • Automatic Native Backup:
      • Turn on Route manual and automatic backups through GoToHP in settings (ensure Google Photos' built-in backup is also enabled).
      • Photos will now automatically be routed through GoToHP's Pixel-spoofed queue. See Native Backup Routing.
    • Manual Upload:
      • Tap Uploads → Choose photos and videos (up to 100 items per selection).
      • Or choose Choose album to queue entire albums at once (see Bulk Import Guide).

Note

  • Sideloaded (Jailed) builds: Uploading occurs while Google Photos is active in the foreground. Keep the app open while uploading.
  • Jailbroken builds: Once media is staged into the queue, the background daemon handles the upload even if you close Google Photos.

⚙️ Quality Profiles

Setting Spoofed Device Upload Policy
Original Pixel XL (Pixel 1) Original quality with zero Google account quota usage.
Storage Saver Pixel 2 High quality compressed by Google with zero quota usage.
Account Storage Pixel 8 Original quality consuming standard Google account quota.

📚 Documentation


⚠️ Disclaimer

This is an unofficial open-source project and is not affiliated with, authorized, or endorsed by Google LLC or Apple Inc. Provided "as is", without warranty of any kind. Google may change policies or backend APIs at any time, which could impact quota calculation or account standing. Always keep an independent backup of your original media. Google Photos binaries, signing certificates, and proprietary credentials are not distributed in this repository.


📄 License

About

Google Photo tweak

Resources

Stars

433 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages