{"id":13640229,"url":"https://github.com/tejado/telegram-nearby-map","last_synced_at":"2025-05-16T10:08:58.746Z","repository":{"id":37911064,"uuid":"329705041","full_name":"tejado/telegram-nearby-map","owner":"tejado","description":"Discover the location of nearby Telegram users 📡🌍","archived":false,"fork":false,"pushed_at":"2024-02-17T15:50:41.000Z","size":43532,"stargazers_count":1130,"open_issues_count":9,"forks_count":166,"subscribers_count":27,"default_branch":"main","last_synced_at":"2025-05-14T10:35:43.653Z","etag":null,"topics":["discover","gps","locate","location","map","nearby","node","nodejs","openlayers","osm","privacy","tdlib","telegram","trilateration"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tejado.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-14T18:45:23.000Z","updated_at":"2025-05-13T17:28:08.000Z","dependencies_parsed_at":"2024-01-07T06:50:22.508Z","dependency_job_id":"33a00d8b-d6d0-4c0e-a837-4ce3e72283fd","html_url":"https://github.com/tejado/telegram-nearby-map","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tejado%2Ftelegram-nearby-map","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tejado%2Ftelegram-nearby-map/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tejado%2Ftelegram-nearby-map/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tejado%2Ftelegram-nearby-map/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tejado","download_url":"https://codeload.github.com/tejado/telegram-nearby-map/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254509477,"owners_count":22082892,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["discover","gps","locate","location","map","nearby","node","nodejs","openlayers","osm","privacy","tdlib","telegram","trilateration"],"created_at":"2024-08-02T01:01:09.082Z","updated_at":"2025-05-16T10:08:53.731Z","avatar_url":"https://github.com/tejado.png","language":"JavaScript","funding_links":[],"categories":["Social Media Tools","[](#table-of-contents) Table of contents","[↑](#contents) Tools"],"sub_categories":["[↑](#-table-of-contents) Telegram","[↑](#-Table-of-Contents) Telegram","[](#telegram)Telegram"],"readme":"# Telegram Nearby Map\n\nTelegram Nearby Map uses OpenStreetMap and the official Telegram library to find the position of nearby users.\n\n**Please note:** Telegram's API was updated a while ago to make nearby user distances less precise, preventing exact location calculations. Therefore, Telegram Nearby Map displays users nearby, but does not show their exact location.\n\nInspired by [Ahmed's blog post](https://blog.ahmed.nyc/2021/01/if-you-use-this-feature-on-telegram.html) and a [Hacker News discussion](https://news.ycombinator.com/item?id=25641399).\nDeveloped by [github.com/tejado](https://github.com/tejado).\n\n\u003cimg src=\".github/telegram-nearby-map-small.png\" alt=\"Telegram Nearby Map Screenshot\"\u003e  \n\n## How does it work?\nEvery 25 seconds all nearby users will be received with [TDLib](https://core.telegram.org/tdlib) from Telegram. This includes the distance of every nearby user to \"my\" location. With three distances from three different points, it is possible to calculate the position of the nearby user.\n\nThis only finds Telegram users which have activated the nearby feature. Per default it is deactivated.\n\n## Installation\n\nRequirements: node.js and an Telegram account\n\n1. Create an API key for your Telegram account [here](https://my.telegram.org)\n2. Download the repository\n3. Create config.js (see config.example.js) and put your Telegram API credentials in it\n4. Install all dependencies: npm install\n5. Start the app: npm start\n6. Look carefully at the output: you will need to confirm your Telegram login\n7. Go to http://localhost:3000 and have fun\n\n## Changelog\n\n### 2023-09-23\n- Switched to [prebuild-tdlib](https://github.com/Bannerets/tdl)\n- Updated all dependencies\n- Bugfix of the search distance field\n\n### 2021-11-13\n- Added [tdlib.native](https://github.com/ForNeVeR/tdlib.native/releases) for Linux (now it works in GitHub Codespaces)\n- Updated all dependencies\n- Bugfixes\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftejado%2Ftelegram-nearby-map","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftejado%2Ftelegram-nearby-map","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftejado%2Ftelegram-nearby-map/lists"}