udevsharold / locsim

Simulate GPS location system-wide
GNU General Public License v3.0
97 stars 15 forks source link

locsim

A tool to simulate GPS location system-wide. This tool simulates GPS location natively without any runtime injection, and it's how Apple do it.

Usage

Usage: locsim <SUBCOMMAND> [LATITUDE] [LONGITUDE] [OPTIONS]
if LATITUDE and LONGITUDE not specified, random values will be generated

SUBCOMMAND:
    start   start location simulation
    stop    stop location simulation
OPTIONS:
    -x, --latitude <double>: latitude of geographical coordinate
    -y, --longitude <double>: longitude of geographical coordinate
    -a, --altitude <double>: location altitude
    -h, --haccuracy <double>: radius of uncertainty for the geographical coordinate, measured in meters
    -v, --vaccuracy <double>: accuracy of the altitude value, measured in meters
    -s, --speed <double>: speed, or  override average speed if -g specified, measured in m/s
        --saccuracy <double>: accuracy of the speed value, measured in m/s  
    -c, --course <double>: direction values measured in degrees
        --caccuracy <double>: accuracy of the course value, measured in degress 
    -t, --time <double>: epoch time to associate with the location
    -f, --force: force stop simulation, requires root access
    --help: show this help
ADDITIONAL GPX OPTIONS:
    -g, --gpx <file>: gpx file path
        --plist <file>: exported or valid plist file path
    -l, --lifespan <double>: lifespan
    -p, --type <int>: type
    -d, --delivery <int>: location delivery behaviour
    -r, --repeat <int>: location repeat behaviour
    --export-plist <file>: export converted gpx file to plist
    --export-only: export converted gpx file to plist without running simulation    

Compatibility

This package tested to be working on iOS 14.3. Might or might not work on other iOS version.

Bonus

References

Copyright (c) 2021 udevs