iFakeGPS 📍

🌐 繁體中文版本

A powerful GUI application for simulating GPS location on iOS devices (iOS 17+).

• Teleport your device's GPS to any location with a single click
• Walk routes by creating waypoints with realistic movement
• Search locations by name or address

---

📥 Download & Run

Pre-built Windows executable available! No Python installation required.

👉 Download from GitHub Releases

Quick Start

1. Download iFakeGPS.exe from releases
2. Enable Developer Mode on your iOS device (Settings > Privacy & Security > Developer Mode)
3. Connect your iOS device via USB
4. Run iFakeGPS.exe (click "Yes" for admin prompt)
5. Select your device from the list and start spoofing!

That's it! The app handles everything else automatically, including the iOS 17+ tunnel service.

---

✨ Features

🎯 Single Point Mode

Click anywhere on the map to instantly teleport your device's GPS location.

🚶 Route Walking Mode

• Click multiple points to create a walking route
• Adjust walking speed (1-50 km/h)
• Add speed noise for realistic movement
• Loop mode for continuous walking

🛠️ Developer Mode Management

• Automatic Status Check: Instantly see if Developer Mode is enabled on your connected device.
• One-Click Enable: Trigger the developer mode prompt on your device directly from the app.
• Auto-Mount: Automatically handles the developer disk image mounting required for the menu to appear.

� Location Search

Search for any location by name and set it as your GPS position.

---

� Troubleshooting

Device Not Found

1. Ensure Developer Mode is enabled on your iOS device
2. Trust the computer when prompted on your device
3. Try reconnecting the USB cable
4. Wait a few seconds for device discovery

Location Not Changing

1. Close and reopen location-dependent apps
2. Some apps cache location data - restart them

Connection Issues (iOS 17+)

The app automatically manages the tunnel service. If you have issues:

1. Make sure you're running as Administrator
2. Check Windows Firewall allows Python/iFakeGPS
3. Ensure IPv6 is enabled on your system

Bug Reports and Logs

If you hit an error, please include the log file when reporting an issue.

1. Open the app sidebar and click Open Logs Folder
2. Attach %LOCALAPPDATA%\iFakeGPS\logs\ifakegps.log
3. Include what action you performed before the issue happened

---

👨‍💻 For Developers

Click to expand development setup

Setup & Prerequisites

Before using iFakeGPS, ensuring you have the following prerequisites is CRITICAL:

1. iTunes (Windows Only):

   • You MUST have iTunes installed (not the Microsoft Store version if possible, though Store version usually works for drivers).
   • This is required for the necessary Apple drivers to detect your device.
   • After checking, run iTunes and ensure it can see your device.

2. iOS Developer Mode (iOS 16+):

   • On your iPhone/iPad, go to Settings -> Privacy & Security.
   • Scroll down to Developer Mode and turn it ON.
   • You will need to restart your device. After restart, unlock it and tap "Turn On" in the alert, then enter your passcode.
   • Troubleshooting: If you don't see the "Developer Mode" option:
     • Ensure your device is connected and "Trusted".
     • If running from source, run: uv run python -m pymobiledevice3 amfi reveal-developer-mode
     • Or use a 3rd party tool like iCareFone or 3uTools to trigger it.

3. Trust Computer:

   • When connecting your device via USB, ensure you tap "Trust" on the "Trust This Computer?" prompt on your device.

Installation

# Clone the repository
git clone https://github.com/user/ifakegps.git
cd ifakegps

# Using uv (recommended)
uv sync

# Or using pip
python -m venv .venv
.venv\Scripts\activate  # Windows
pip install -r requirements.txt

Running from Source

# Using uv
uv run python ifakegps.py

# Or directly (requires admin for iOS 17+)
python ifakegps.py

Manual Tunnel Setup (Advanced)

For iOS 17+, if you need to run the tunnel separately:

# Run as Administrator
python -m pymobiledevice3 remote tunneld

Note: This is usually NOT needed as the app handles it automatically.

Developer Disk Image (iOS 14-16 only)

For iOS 14-16, you may need to mount the developer disk image:

pymobiledevice3 mounter auto-mount

Note: iOS 17+ does NOT require this step.

Building Windows Executable

# Using batch file
pack.bat

# Or using Python
python pack.py

Output: dist/iFakeGPS.exe (auto-requests admin privileges)

---

⚖️ Legal Disclaimer

This tool is for development and testing purposes only. Location spoofing may violate app Terms of Service. Use responsibly.

---

🙏 Credits

• pymobiledevice3 - iOS device communication
• tkintermapview - Interactive map widget
• customtkinter - Modern UI framework