Skip to main content

How can we help?

Most reports trace back to one of the causes below. Work down the list and stop when spoofing works.

Spoofing isn't working on a site

These are ordered from most to least common. You likely won't need to reach the end.

GeoSpoof also runs on Chrome, Edge, Brave, and Safari. The steps below are written for Firefox, where these conflicts are most common — on other browsers, apply the equivalent settings.

Last updated: July 2026

  1. Refresh the tab, or reopen it

    GeoSpoof only takes effect on pages loaded after it's enabled. Any tab that was already open when you installed, updated, or re-enabled GeoSpoof won't be spoofed until it reloads. Refresh the tab you're testing — if that doesn't help, close it and open it again.

  2. Update to the latest version

    Many issues are already fixed in a newer release. In the popup, open Details → Advanced to see your version, then compare it to the latest release below and update through your browser's extension manager if you're behind.

    View the latest release on GitHub

  3. Confirm GeoSpoof is running on the site

    GeoSpoof's toolbar icon shows whether it's active on the current tab. If it isn't active, nothing gets spoofed — most often because of the site scope set in the Filters tab.

    GeoSpoof toolbar icon with a badge showing it is active on the current tab
    Active on this tab
    GeoSpoof toolbar icon with a badge showing it is not running on the current tab
    Not running on this tab
    • Allowlist mode: only listed sites are spoofed — add the site you're testing.
    • Denylist mode: make sure the site isn't on the list.
    • Or switch to "All" to spoof everywhere.

  4. Reset the site's location permission

    If a test reports "Geolocation: Denied", Firefox is blocking the request — usually because the prompt was once denied with "Remember this decision" checked.

    A fingerprint test result reporting "Geolocation: Denied" because Firefox blocked the location request
    What a blocked location request looks like on a fingerprint test.
    • Click the lock icon in the address bar.
    • Clear any remembered Block for location, then reload the page.
    • In Firefox settings, confirm "Block new requests asking to access your location" is off.
    • If GeoSpoof's "Preserve location prompts" toggle is on and you denied the prompt, either allow it or turn the toggle off so GeoSpoof answers directly.
    The GeoSpoof popup with the "Preserve location prompts" toggle turned off
    GeoSpoof popup with "Preserve location prompts" turned off.

  5. Restart your browser

    Some browser APIs are set up at startup, so a recent install, update, or settings change may not take effect until you fully close and reopen your browser.

  6. Best diagnostic

    Test in a fresh Firefox profile

    A clean profile isolates GeoSpoof from your existing setup.

    • Open about:profiles and create a new profile.
    • Launch it, install GeoSpoof, and test the same site again.

    If spoofing works in the clean profile, GeoSpoof itself is fine — something in your normal profile is interfering, almost always a privacy tool or an about:config change. The next two steps cover those.

  7. Disable conflicting privacy tools

    Hardening tools change many of the same browser APIs as GeoSpoof and can override it. Temporarily disable any you use, then retry: Arkenfox, Betterfox, LibreWolf, CanvasBlocker, JShelter, Chameleon, Trace, or any fingerprint randomizer.

  8. Check about:config (advanced)

    If you've hardened Firefox, confirm these preferences are disabled, then restart and retry. Strict Enhanced Tracking Protection is usually fine and doesn't need changing.

    • privacy.resistFingerprinting
    • privacy.fingerprintingProtection
    • privacy.fingerprintingProtection.pbmode

  9. Confirm on a second fingerprint test

    Tests measure different APIs and some are simply buggy. Before assuming GeoSpoof is at fault, verify the result on another reputable test — we recommend the Region section of arkenfox's TZP.

    Open the TZP test

Other common questions

How it works

Open the menu-bar icon and choose “Set Up…”. The wizard checks each step off as you go. Connect your iPhone with a cable to finish setup, then it keeps working over Wi-Fi.

What you'll need

  • macOS 13 (Ventura) or later.
  • The GeoSpoof app for iPhone with GeoSpoof Pro. The app is your control surface that sets the location, and moving the device's real GPS is a Pro feature.
  • An iPhone with Developer Mode enabled, connected by USB cable for first-time setup.
  • Xcode, Apple's free developer app from the Mac App Store. It's a big download, so set aside about 15 GB of free space. (You don't build anything; the setup steps below explain how it's used.)

  1. Install the app

    Open the DMG, drag GeoSpoof GPS into Applications, then launch it. It lives in your menu bar (no Dock icon, no window) and opens the setup wizard the first time it runs.

    The GeoSpoof GPS disk image open in Finder, with the app icon being dragged onto the Applications folder.

  2. Allow Local Network access

    On first launch, macOS asks for Local Network access. Click Allow so GeoSpoof GPS can find and talk to your iPhone. Without it, the app can't see your phone.

    • Missed the prompt? Turn it on under System Settings ▸ Privacy & Security ▸ Local Network ▸ GeoSpoof GPS.
    • A stuck “No device found” is the usual sign this permission is off.
    macOS System Settings, Privacy & Security ▸ Local Network, with the GeoSpoof GPS toggle switched on.

  3. Install Xcode

    GeoSpoof GPS needs Apple's Developer Disk Image, and it ships inside Xcode. Kick off this download first — it's large (several GB), so let it install in the background while you do the quick iPhone steps below.

    • Install Xcode (free) from the Mac App Store and launch it once.
    • On first launch it shows a “Select platforms” screen. Check macOS and leave the rest (including iOS) unchecked, then continue — you don't need the iOS SDK or Simulator, the developer image is part of Xcode's base setup either way.
    • Let it finish “Installing components,” then quit Xcode. No project, no build, nothing to compile, and no paid Apple Developer account.
    • Already have a developer image? Point GeoSpoof GPS at that folder instead and skip the Xcode download entirely.
    Get Xcode on the Mac App StoreXcode's first-launch “Select platforms to install” screen, with macOS checked and iOS and the other platforms left unchecked.

  4. Connect your iPhone

    Plug your iPhone into your Mac and unlock it. Use a data-capable cable, since some are charge-only. If it doesn't appear, try another cable or port.

  5. Trust this computer

    When your iPhone asks whether to trust this computer, tap Trust and enter your passcode. That lets your Mac and phone talk to each other.

    • No prompt? Keep the phone unlocked, then unplug and replug the cable. The alert only shows while the screen is unlocked.
    • Still nothing? Lock and unlock the phone (or restart it) and reconnect.
    • Last resort only: Settings ▸ General ▸ Transfer or Reset iPhone ▸ Reset ▸ Reset Location & Privacy, then reconnect and tap Trust.
    The “Trust This Computer?” alert on an iPhone, with the Trust button highlighted.

  6. Enable Developer Mode

    On your iPhone, open Settings ▸ Privacy & Security ▸ Developer Mode, switch it on, and restart when prompted. It only appears after the phone has connected to your Mac at least once.

    iPhone Settings, Privacy & Security ▸ Developer Mode, with the toggle switched on.

  7. Pair with this Mac

    In the setup window, click Pair. This one-time secure handshake lets your Mac drive the iPhone's GPS. Keep the phone unlocked and connected while it runs.

  8. Prepare the developer image

    Requires Xcode installed (above). With your iPhone connected and unlocked, click Prepare. GeoSpoof GPS personalizes Apple's Developer Disk Image (DDI) to your device and mounts it — the piece that lets an app set your real GPS location. It's Apple-signed and done for you; there's nothing to configure.

    Image not found? If Prepare says it can't find the developer image, Xcode's setup may not have finished laying it down. Open Terminal, run this, then click Prepare again:

    xcrun devicectl manage ddis update

  9. Pick a location in GeoSpoof

    Set your location as usual in GeoSpoof. Your iPhone's system-level GPS follows it and stays aligned, even after you unplug and switch to Wi-Fi.

    Get GeoSpoof for iPhoneThe GeoSpoof GPS menu-bar panel showing setup complete with GPS active.

Still need help?

Send us an email and we'll get back to you within a day or two.

support@geospoof.com

Include these so we can help faster:

  • Firefox version
  • Operating system
  • GeoSpoof version
  • VPN provider (if applicable)
  • The fingerprint test site you're using
  • A screenshot of the result
  • Whether spoofing works in a fresh Firefox profile

You can also report bugs on GitHub.