LocationSimulator

> [!NOTE]
> You can now beta test LocationSimulator2 (closed source for now). Please read [this](https://github.com/Schlaubischlump/LocationSimulator2/discussions/1) for more information.

> [!WARNING]
> iOS 17 and later are not supported by the LocationSimulator source code in this repo.
> For more details, click [here](https://github.com/Schlaubischlump/LocationSimulator/issues/171).

<p align="center">
  <img src="LocationSimulator/Assets.xcassets/AppIcon.appiconset/AppIcon_256.png" width="128">
</p>

# LocationSimulator

[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/donate/?hosted_button_id=9NR3CLRUG22SJ)
[![License](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://opensource.org/licenses/gpl-3.0)

LocationSimulator is a macOS app that allows spoofing the location of an Apple device (iOS, iPadOS, tvOS). The target audience for this project is developers who want to test their location-service-based application(s). I do not encourage using this application to cheat in iOS games, and I do not provide support for these games. If you use this application outside of the intended purposes, you are on your own.

![LocationSimulator screenshot](Preview/screenshot.png)

<details>
<summary><b>Table of Contents</b></summary>

- [Background](#background)
- [Features](#features)
- [Install](#install)
- [Build](#build)
  - [Requirements](#requirements)
  - [Build the app](#build-the-app)
- [Usage](#usage)
  - [Start spoofing](#start-spoofing)
  - [Moving](#moving)
  - [Stop spoofing](#stop-spoofing)
- [License](#license)
- [Contribute](#contribute)
- [Donate](#donate)
- [Enhancements](#enhancements)
- [Acknowledgements](#acknowledgements)

</details>

## Background

While I originally planned to build on the fantastic work of [Watanabe Toshinori's LocationSimulator](https://github.com/watanabetoshinori/LocationSimulator), I decided to recreate the whole project because the original lacked a license at the time (August 2019). I created all necessary images and source code files and removed all third-party binary dependencies except for [libimobiledevice](https://github.com/libimobiledevice/libimobiledevice). The project uses several Swift packages (listed under [Build](#build)) but no longer requires [Xcode](https://apps.apple.com/us/app/xcode/id497799835?mt=12) to be installed at runtime. You need the `DeveloperDiskImage.dmg` and `DeveloperDiskImage.dmg.signature` files for your iOS version.

## Features

- Spoof the iOS device location without a jailbreak or installing an app on the device.
- Spoof the iPhoneSimulator device location.
- Automatically try to download the DeveloperDiskImage files for your iOS version.
- Set the device location with a long-click on the map.
- Support custom and predefined (Walk/Cycle/Drive) movement speeds.
- Control the movement using the arrow keys.
- Navigate from the current location to a new location.
- Support network devices.
- Search for locations.
- Support dar