gitwtfhub

wtf is home-location-endpoint?

loading886/home-location-endpoint — explained in plain English

Analysis updated 2026-05-18

43PythonAudience · developerComplexity · 4/5Setup · hard

TL;DR

A self-hosted Linux server tool that intercepts Apple's network location lookups and reports a randomized location within a chosen city instead.

Mindmap

mindmap
  root((Home-Location-Endpoint))
    What it does
      Intercepts Apple location requests
      Reports randomized city coordinates
      Bundles optional proxy setup
    Tech stack
      Python
      Xray-core
      Telegram Bot API
    Use cases
      Change reported iPhone network location
      Manage multiple locations via Telegram
      Pair with a self-hosted proxy connection
    Audience
      Self-hosting enthusiasts
      Privacy-focused technical users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Install a location-changing endpoint on a Linux server for an iPhone to connect to.

REASON 2

Switch between multiple preset city locations through a Telegram bot.

REASON 3

Pause and resume location rewriting without disconnecting the proxy.

What's in the stack?

PythonXray-coreTelegram Bot APINominatim

How it stacks up

loading886/home-location-endpointalibaba/omnidoc-tokenbencharccalc/dwmfix
Stars434343
LanguagePythonPythonPython
Setup difficultyhardmoderateeasy
Complexity4/53/52/5
Audiencedeveloperresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires a Linux server, root access, and comfort running install scripts with environment variables.

Wtf does this do

This project turns a Linux server into an endpoint that changes what location Apple's network based location system reports back to an iPhone. It intercepts the specific Apple location lookup traffic, figures out what city the server's public IP address is in, then picks a random point within that city's real boundaries to report instead of the server's own coordinates. Regular internet traffic through the server is not affected by this location rewriting. The installer offers three modes. A beginner mode sets up both the location changer and a bundled proxy connection automatically. An intermediate mode, which the project recommends, adds the same setup plus a Telegram bot that lets you switch between multiple preset city locations, restore your real location, and receive connection details through chat messages. An advanced mode installs only the location changing component, leaving the proxy setup entirely to the user. Setup is a single command that downloads and runs an install script, with options to run the whole process without any interactive prompts by passing environment variables and command line flags. After installation, the tool generates a connection link, a certificate profile to install on the iPhone, and a fingerprint to verify that certificate. The phone downloads and trusts this certificate so it can talk through the server, then the user turns on the appropriate proxy or VPN mode. The project is explicit about its limits. Apple can still learn a phone's real location from other signals such as nearby WiFi networks, cellular data, GPS, or account level information, since this project only changes the response to Apple's WiFi based network location requests. It does not claim to hide location from every possible source, and warns that installing a private security certificate increases what the device has to trust, though the certificate's private key is deleted immediately after use. The README describes this as an early stage project meant for testing on non critical devices, not for emergency services, anti theft features, or safety critical uses. It targets technical users comfortable running server commands who want to control what location their iPhone reports over the network.

Yoink these prompts

Prompt 1
Explain how this project intercepts and rewrites Apple network location requests.
Prompt 2
Walk me through setting up the intermediate mode with the Telegram bot.
Prompt 3
What are the stated privacy limitations of this location changing tool?
Prompt 4
Help me install the CA certificate profile this project generates on an iPhone.

Frequently asked questions

wtf is home-location-endpoint?

A self-hosted Linux server tool that intercepts Apple's network location lookups and reports a randomized location within a chosen city instead.

What language is home-location-endpoint written in?

Mainly Python. The stack also includes Python, Xray-core, Telegram Bot API.

How hard is home-location-endpoint to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is home-location-endpoint for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.