# tejado/telegram-nearby-map

Discover the location of nearby Telegram users 📡🌍

Repository: https://github.com/tejado/telegram-nearby-map
Canonical: https://ross.abutalabs.com/products/telegram-nearby-map
Language: JavaScript
License: GPL-3.0
License Family: copyleft
Topics: telegram, tdlib, nodejs, node, trilateration, nearby, locate, location, discover, map, osm, openlayers, privacy, gps
Last push: 2024-02-17T15:50:41+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 2057, "days_push": 928, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1189, forks 171 (observed 2026-08-28T04:03:55.430345+00:00)

## What it is
A Node.js web application that uses Telegram's official TDLib to discover nearby Telegram users who have enabled the nearby feature and visualize them on an OpenStreetMap. It estimates user positions via trilateration from distance measurements, though Telegram API changes now limit precision so exact locations are no longer shown.

## Use cases
- map nearby telegram users on openstreetmap
- demonstrate telegram nearby people privacy risk
- trilaterate user positions from distance measurements
- research location privacy in messaging apps
- visualize telegram nearby users on a map

## When to choose
- you want a self-hosted tool to explore Telegram's nearby-users feature on a map
- you need a practical demonstration of trilateration-based location privacy risks
- you want to audit how much location data Telegram's nearby feature exposes

## When to avoid
- you need exact precise locations of Telegram users - API changes now prevent this
- you want to locate users who have not enabled the nearby feature
- you need a production or commercial-grade geolocation service

## Facets
- artifact type: application
- maturity: maintenance
- function: http-server, data-visualization, osint, geospatial
- domain: osint, privacy, messaging-platforms, social-media
- platform: self-hosted, windows
- tags: telegram, tdlib, trilateration, openstreetmap, openlayers, location-privacy, nearby-users, maps, nodejs, web-server, linux, macos

## Member repositories
- tejado/telegram-nearby-map (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:55.430345+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:23:21.348918+00:00, confidence not recorded.
  - readme: https://github.com/tejado/telegram-nearby-map (fetched 2026-08-28T04:03:55.430345+00:00, sha f73b8e40361a)
- Data as of 2026-08-30T08:39:29.467469+00:00.