How can we help you?

Step-by-step troubleshooting, setup guides, and diagnostics for GeoCeptor Safari Extension and GeoCeptor Companion for Mac.

Want to inspect your active browser signals?

Run a free live audit to check your HTML5 GPS coordinates, WebRTC shield, Timezone offset, and Canvas noise.

Open Signal Report
GeoCeptor

GeoCeptor Safari Extension (iOS & macOS)

1
Reload or reopen the web pageExtensions inject coordinate overrides when a page initializes. Reload already open tabs.
+

Safari Web Extensions inject their privacy hooks and coordinate overrides when a web page is initialized. If a tab was already open prior to enabling GeoCeptor or switching locations, click the Safari Reload button or close and reopen the tab.

Pro Tip: Reloading the tab resolves over 80% of reported location issues.
2
Verify extension permissions in SafariEnsure GeoCeptor is toggled ON and granted "Always Allow" on all websites.
+

On iOS: Open Settings ▸ Apps ▸ Safari ▸ Extensions ▸ GeoCeptor ▸ set permissions to "Always Allow" on "All Websites". On macOS: Safari ▸ Settings ▸ Extensions ▸ ensure GeoCeptor is checked and allowed for all websites.

iOS / iPadOS:Settings ▸ Safari ▸ Extensions ▸ GeoCeptor ▸ Always Allow on All Sites.
macOS:Safari ▸ Settings ▸ Extensions ▸ Enable GeoCeptor for all sites.
3
Reset remembered "Denied" website location promptsClear saved "Don't Allow" location decisions if a site reports Geolocation: Denied.
+

If a site reports "Geolocation: Denied", Safari is blocking the request because "Don't Allow" was previously saved. On iOS: tap the "aA" icon in the address bar ▸ Website Settings ▸ Location ▸ set to Allow or Ask. On Mac: Safari ▸ Settings for [Website] ▸ set Location to Ask or Allow.

iOS: Tap aA in address bar ▸ Website Settings ▸ Location ▸ Allow.

Mac: Click Safari ▸ Settings for [Website]... ▸ Location ▸ Allow.

4
Coordinate VPN location with GeoCeptor coordinatesMatch your VPN server city with GeoCeptor to eliminate location mismatch flags.
+

Websites inspect both your network IP address and HTML5 GPS coordinates. If your VPN is connected to London while GeoCeptor is set to New York, websites detect the mismatch. Always select the same metropolitan area in both your VPN and GeoCeptor.

Pro Tip: GeoCeptor automatically aligns Intl.DateTimeFormat timezone and WebRTC leak protection with your target city.
GeoCeptor Companion

GeoCeptor Companion macOS App (System-Wide iOS GPS)

✓macOS 14+
✓iOS/iPadOS 15+
✓USB Data Cable
✓Apple developer tools
GeoCeptor Companion for macOSFree companion driver for system-wide iPhone & iPad GPS spoofing (requires GeoCeptor Pro on iOS).
1
Step 1: Install & launch Companion on your MacFor Macs on macOS 14+; lives in your menu bar with a streamlined setup assistant.
+

On a Mac running macOS 14 or later, download <a href="https://updates.geoceptor.com/downloads/GeoCeptorCompanion.dmg" class="text-[#007AFF] hover:underline font-semibold">GeoCeptorCompanion.dmg</a>, drag the app into your Applications folder, and launch it. It runs in your macOS menu bar with an interactive setup wizard.

Pro Tip: Read our full <a href="/blog/how-to-setup-geoceptor-companion-ios-gps-spoofing" class="text-[#007AFF] hover:underline font-semibold">Companion Setup Guide</a> for step-by-step instructions.
2
Step 2: Allow Local Network access on macOSRequired for Companion to discover and communicate with your iPhone.
+

Click "Allow" when macOS prompts for Local Network access on first launch. If missed, enable under macOS System Settings ▸ Privacy & Security ▸ Local Network ▸ GeoCeptor Companion.

Pro Tip: A stuck "No device found" is usually resolved by turning on Local Network access.
3
Step 3: Connect iPhone via USB & tap "Trust This Computer"Unlock screen, tap Trust, and enter your passcode.
+

Plug your iPhone into your Mac using a data-capable cable (charge-only cables will not work). Keep the screen unlocked, tap "Trust" when prompted, and enter your passcode.

4
Step 4: Enable Developer Mode on iOS/iPadOS 16+Required on iOS/iPadOS 16 or later; iOS/iPadOS 15 uses the legacy service.
+

On iOS/iPadOS 16 or later: Open Settings ▸ Privacy & Security ▸ Developer Mode ▸ Toggle ON ▸ Restart. After rebooting, confirm by tapping "Turn On" and entering your passcode. iOS/iPadOS 15 is supported without this setting; older releases are not supported by the GeoCeptor iOS app.

Pro Tip: The Developer Mode option appears after your iPhone or iPad connects to your Mac via USB at least once.
5
Step 5: Pair device in CompanionOne-time secure cryptographic handshake between Mac and iPhone.
+

Click "Pair" in GeoCeptor Companion on your Mac. A secure one-time cryptographic handshake is established. Keep your iPhone unlocked during pairing.

6
Step 6: Mount Apple Developer Disk Image (DDI)Mounts Apple's signed developer image to simulate physical GPS coordinates.
+

Click "Mount Image" in Companion to load Apple's signed Developer Disk Image. If needed, you can run the standard Terminal sync command below.

xcrun devicectl manage ddis update
7
Step 7: Set GPS location & simulate over Wi-FiSimulates GPS across all native iOS apps for development and testing. Works wirelessly over Wi-Fi.
+

Pick any location in Companion. Your iPhone's system GPS updates instantly across all native iOS apps. You can unplug the cable—simulation continues wirelessly as long as both devices share the same Wi-Fi or Hotspot.

Pro Tip: To restore your real GPS location, click "Reset Location" in Companion or restart your iPhone.

Frequently Asked Questions

Detailed answers for common configurations, privacy vectors, and streaming questions.

Safari ExtensionWhy does a website still see my real location in Safari?
+

Most often, this occurs because: (1) the tab was already open before spoofing was turned on (reload the tab), (2) Safari has a remembered "Denied" permission for that domain (tap aA ▸ Website Settings ▸ Location ▸ Allow), or (3) your VPN exit node differs from GeoCeptor's coordinates (e.g. IP in Chicago, GPS in Miami).

Pro Tip: Run a live diagnostic at <a href="/check" class="text-[#007AFF] hover:underline font-medium">geoceptor.com/check</a> to confirm your HTML5 coordinates, timezone, and WebRTC status.
Safari ExtensionCan I use GeoCeptor in Safari Private Browsing tabs?
+

By default, iOS and macOS disable extensions in Private Browsing. To enable GeoCeptor in private tabs: Open iOS Settings ▸ Safari ▸ Extensions ▸ GeoCeptor ▸ toggle "Allow in Private Browsing" ON.

Safari ExtensionHow do I bypass sports blackouts & YouTube TV location blocks?
+

Regional sports broadcasts (MLB.TV, NBA League Pass, NFL Sunday Ticket, YouTube TV) verify physical GPS coordinates and JavaScript clock offsets in Safari. Set GeoCeptor and your VPN to an authorized out-of-market city. If you previously visited while logged in, clear browser cookies for that streaming domain.

Pro Tip: Use our <a href="/check" class="text-[#007AFF] hover:underline font-medium">/check</a> tool to verify your HTML5 GPS coordinates and timezone before loading the streaming site.
Safari ExtensionCan I use GeoCeptor on Tinder Web, Bumble Web & dating sites?
+

Navigate to Tinder.com or Bumble.com in Safari. Open GeoCeptor and set your target city. When the dating web app asks for browser location, tap "Allow". GeoCeptor will feed your custom coordinates, enabling you to browse matches anywhere.

Pro Tip: Clear website cookies if the dating web app cached your previous location on login.
Safari ExtensionHow do I prevent GPS accuracy drift or erratic jumps?
+

GeoCeptor intercepts both navigator.geolocation.getCurrentPosition and watchPosition. It returns fixed high-precision coordinates with custom accuracy (default 5.0m) and timestamp updates, ensuring the browser sees a stable, believable GPS fix without erratic jumping.

Safari ExtensionWhy is a website remembering my old ZIP code despite GPS changes?
+

Some websites (like shopping or local delivery sites) store your previously entered zip code in localStorage or cookies. If a website still displays an old city, clear site data in Safari: Settings ▸ Safari ▸ Advanced ▸ Website Data ▸ search the site and tap Delete.

Safari ExtensionDoes GeoCeptor work across Safari Profiles & Tab Groups?
+

In macOS Sonoma/Sequoia and iOS 17+, Safari supports Profiles. Make sure GeoCeptor is enabled in each profile: open Safari Settings ▸ Profiles ▸ Extensions, and verify GeoCeptor is checked for your active profile.

Safari ExtensionHow do I resolve conflicts with third-party Content Blockers?
+

Very aggressive third-party script blockers or fingerprint randomizers (like CanvasBlocker or strict user scripts) can occasionally intercept the same Geolocation APIs. Ensure GeoCeptor runs with standard Safari settings. Strict Tracking Prevention built into Safari works 100% harmoniously with GeoCeptor.

Companion (macOS)What should I do if Companion reports "No Device Found" or fails to connect?
+

Ensure macOS Local Network access is granted in System Settings ▸ Privacy & Security ▸ Local Network ▸ GeoCeptor Companion. Ensure your iPhone is unlocked with the screen ON and you tapped "Trust This Computer". Verify you are using a data-capable USB cable (some braided cables are charge-only).

Pro Tip: Test with Apple's original USB-C/Lightning cable directly into a Mac port without hubs.
Companion (macOS)Why is the Developer Mode option missing in my iPhone Settings?
+

Developer Mode applies to iOS/iPadOS 16 or later. Apple intentionally hides the menu until an iPhone or iPad connects to a Mac or PC over a USB cable. Once plugged in and trusted, open Settings ▸ Privacy & Security ▸ scroll to the bottom, and Developer Mode will appear. iOS/iPadOS 15 is supported through the legacy service and does not show this setting.

Pro Tip: After toggling Developer Mode ON, your iPhone will reboot. Unlock and tap "Turn On" to complete.
Companion (macOS)Does Companion require a paid Apple Developer account?
+

Apple Developer Mode and Developer Disk Images (DDIs) are free, standard capabilities of iOS and macOS. You do NOT need a paid Apple Developer subscription or custom provisioning profiles.

Companion (macOS)Does Companion work across all native iOS apps?
+

Because GeoCeptor Companion communicates with iOS at the device kernel/DDI level, every native application receives the simulated GPS coordinates for location QA and development.

Pro Tip: See our <a href="/blog/how-to-setup-geoceptor-companion-ios-gps-spoofing" class="text-[#007AFF] hover:underline font-semibold">Companion Setup Guide</a> for step-by-step instructions.
Companion (macOS)What happens when I unplug my iPhone from my Mac?
+

Once paired and mounted, the simulated GPS coordinate remains active on your device. As long as your Mac and iPhone are connected to the same Wi-Fi network or hotspot, Companion controls the location wirelessly. If you leave Wi-Fi range, the last set location persists until you reboot your iPhone or click "Reset Location".

Pro Tip: Restarting your iPhone immediately restores factory GPS behavior.
Companion (macOS)How do I completely reset my iPhone back to genuine real GPS?
+

To stop location simulation: Click "Reset Location" in GeoCeptor Companion on your Mac. Alternatively, simply restart your iPhone (Power Off ▸ Power On). Rebooting immediately clears simulated CoreLocation memory and restores real hardware GPS.

Privacy & SecurityWhat is WebRTC IP leak protection and why is it enabled?
+

WebRTC allows audio/video streaming in browsers but can disclose your real LAN and ISP IP address even when connected to a VPN. GeoCeptor intercepts WebRTC ICE candidates inside Safari to guarantee your true IP is never leaked.

Pro Tip: Verify your WebRTC status on our <a href="/check" class="text-[#007AFF] hover:underline font-medium">/check</a> page.
Privacy & SecurityHow does Canvas 2D fingerprint defense protect my identity?
+

Modern tracking scripts force your browser to render hidden canvas shapes to generate a unique digital footprint based on your graphics card. GeoCeptor injects imperceptible micro-variations into canvas pixel data, rendering fingerprint profiling ineffective without breaking websites.

Privacy & SecurityWhy do websites check my JavaScript timezone clock?
+

Even if your IP says New York, if your system clock is in Berlin (+01:00), websites calculate the difference and flag VPN usage. GeoCeptor intercepts Intl.DateTimeFormat and Date.prototype.getTimezoneOffset so your browser clock perfectly matches your target GPS coordinates.

Still need assistance?

Our team reviews inquiries directly. Send us an email with your setup details, and we'll reply promptly.

Recommended Details
  • ✓Product: Safari Extension vs Companion
  • ✓Device & OS: e.g., iPhone 15 on iOS 18 / Mac on macOS 15
  • ✓Target Site/App: Domain or app name
  • ✓VPN (if active): Provider & exit city
  • ✓Signal Report: Results from /check