Repository files navigation

Pavel Durov, the founder and CEO of Telegram, announced the discontinuation of the "People Nearby" feature. The feature has been non-functional for a week.

The removal of this feature means that Geogramint and other OSINT tools that utilize the API no longer work. As of today, this GitHub repository will be archived.

The popularity of Geogramint began withthis Projet FOX article, where the tool's capabilities were demonstrated in action. It was also showcased at the International Cybersecurity Forum (FIC) in Lille, France, in 2023, which led to thisProjet FOX article.

Geogramint was used by many journalists, investigators, OSINT practitioners, and others. I personally want to thank everyone who used the tool, and I hope Geogramint was helpful in your investigations!

- Alb310

Twitter @Alb_310 |Projet FOX's Website |Twitter @ProjetFOX |Projet FOX's Discord |Projet FOX's LinkedIn

Geogramint is an OSINT tool that uses Telegram's API to find nearby users and groups. Inspired byTejado's Telegram Nearby Map, which is no longer maintained, it aims to provide a more user-friendly alternative.

Geogramint only finds Telegram users and groups which have activated the nearby feature. Per default it is deactivated.

The tool is fully supported on Windows and partially supported on Mac OS and Linux distributions.

Requirements:Python 3.9, 3.10 or 3.11

• With the installer: Clickhere!

• With Github:

git clone https://github.com/Alb-310/Geogramint.gitcd Geogramint/pip3 install -r requirements.txtpython3 geogramint.py# for GUI modepython3 geogramint.py --help# for CLI mode

Or depending on your installation :

git clone https://github.com/Alb-310/Geogramint.gitcd Geogramint/pip install -r requirements.txtpython geogramint.py# for GUI modepython geogramint.py --help# for CLI mode

• With Github:

git clone https://github.com/Alb-310/Geogramint.gitcd Geogramint/pip3 install -r requirements.txtpython3 geogramint.py# for GUI modepython3 geogramint.py --help# for CLI mode

Or depending on your installation :

git clone https://github.com/Alb-310/Geogramint.gitcd Geogramint/pip install -r requirements.txtpython geogramint.py# for GUI modepython geogramint.py --help# for CLI mode

More details in theWiki.

1. Start by creating an API key for your Telegram accounthere. You will also need to put a profile picture on your account and, in yourPrivacy and Security settings, enable the profile picture for everyone.

2. LaunchGeogramint
3. In the settings, write your information (api_id, api_hash and phone number), report preference and thensave

4. Choose the location where you want to search, either by moving around the map or by using the search feature with coordinates inlat, lon format

5. Telegram will send you a verification code, write it in the pop-up window (+ your two-step verification password if you have one)

6. Then clickStart Search
7. All results will be displayed following:

• green for 500m
• yellow for 1000m
• orange for 2000m
• red for >3000m

(NB: results can also be found inGeogramint/cache_telegram/ injson andcsv format + profiles pictures)

8. Reset will clear the results and erase thecache_telegram

More details in theWiki.

1. Start by creating an API key for your Telegram accounthere. You will also need to put a profile picture on your account and, in yourPrivacy and Security settings, enable the profile picture for everyone.

2. LaunchGeogramint

3. Start with the config, with the commandset-config set your information (api_id, api_hash and phone number)

4. Start the search feature by using coordinates inlat lon format with the commandstart-scan :

⬇

5. All results will be displayed following:

• green for 500m
• yellow for 1000m
• orange for 2000m
• red for >3000m

(NB: results can be exported depending options used withstart-scan, by default profile pictures and results injson format are present inGeogramint/cache_telegram/)

6. reset-scan will clearcache_telegram

More details in theWiki.

Remember to check theWiki before posting an issue or asking a question.

GNU General Public License v3.0

• My teammates at Projet FOX
• sergiombd