Skip to content

Alb-310/Geogramint

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.

Geogramint - OSINT Geolocalization tool for Telegram

GitHub

About

Geogramint is an OSINT tool that uses Telegram's API to find nearby users and groups. Inspired by Tejado'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.

πŸ› οΈ Installation

Requirements: Python 3.8 or 3.9

On Windows Windows

  • With the installer: Click here!

  • With Github:

git clone https://github.com/Alb-310/Geogramint.git
cd Geogramint/
pip3 install -r requirements.txt

python3 geogramint.py # for GUI mode
python3 geogramint.py --help # for CLI mode

Or depending on your installation :

git clone https://github.com/Alb-310/Geogramint.git
cd Geogramint/
pip install -r requirements.txt

python geogramint.py # for GUI mode
python geogramint.py --help # for CLI mode

On Mac OS macOS and Linux Linux

  • With Github:

git clone https://github.com/Alb-310/Geogramint.git
cd Geogramint/
pip3 install -r requirements.txt

python3 geogramint.py # for GUI mode
python3 geogramint.py --help # for CLI mode

Or depending on your installation :

git clone https://github.com/Alb-310/Geogramint.git
cd Geogramint/
pip install -r requirements.txt

python geogramint.py # for GUI mode
python geogramint.py --help # for CLI mode

More details in the Wiki.

πŸ“‘ Example: GUI

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

  1. Launch Geogramint
  2. In the settings, write your information (api_id, api_hash and phone number), report preference and then save

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

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

  1. Then click Start Search
  2. All results will be displayed following:
  • green for 500m
  • yellow for 1000m
  • orange for 2000m
  • red for >3000m

(NB: results can also be found in Geogramint/cache_telegram/ in json and csv format + profiles pictures)

  1. Reset will clear the results and erase the cache_telegram

More details in the Wiki.

πŸ“‘ Example: CLI

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

  1. Launch Geogramint

image

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

image

  1. Start the search feature by using coordinates in lat lon format with the command start-scan :

image

⬇

  1. 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 with start-scan, by default profile pictures and results in json format are present in Geogramint/cache_telegram/)

  1. reset-scan will clear cache_telegram

More details in the Wiki.

πŸ“– Wiki

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

πŸ“ License

GNU General Public License v3.0

πŸ™ Thanks to: