Geogramint - OSINT-инструмент геолокации для Telegram

Конец : 06/09/2024

Популярность Geogramint началась с этой статьи Projet FOX, где возможности инструмента были продемонстрированы в действии. Также он был представлен на Международном форуме по кибербезопасности (FIC) в Лилле, Франция, в 2023 году, что привело к этой статье Projet FOX.

Geogramint использовался многими журналистами, следователями, специалистами по OSINT и другими. Лично я хочу поблагодарить всех, кто использовал инструмент, и надеюсь, что Geogramint был полезен в ваших расследованиях!

- Alb310

Twitter @Alb_310 | Сайт Projet FOX | Twitter @ProjetFOX | Discord Projet FOX | LinkedIn Projet FOX

О программе

Geogramint — это OSINT-инструмент, который использует API Telegram для поиска ближайших пользователей и групп. Вдохновлённый Telegram Nearby Map от Tejado, который больше не поддерживается, он стремится предоставить более удобную альтернативу.

Geogramint находит только тех пользователей и группы Telegram, которые активировали функцию «Рядом». По умолчанию она отключена.

Инструмент полностью поддерживается на Windows и частично поддерживается на Mac OS и дистрибутивах Linux.

🛠️ Установка

Требования: Python 3.9, 3.10 or 3.11

На Windows

• С помощью установщика: Нажмите здесь!

• Через 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

Или в зависимости от вашей установки :

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

На Mac OS и Linux

• Через 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

Или в зависимости от вашей установки :

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

Более подробно в Wiki.

📡 Пример: GUI

1. Начните с создания ключа API для вашего аккаунта Telegram здесь. Также необходимо установить фото профиля в вашем аккаунте и в настройках Конфиденциальность и безопасность включить отображение фото профиля для всех.

2. Запустите Geogramint
3. В настройках введите свои данные (api_id, api_hash и номер телефона), предпочтения отчёта и нажмите save

4. Выберите местоположение для поиска: либо передвигая карту, либо используя функцию поиска с координатами в формате lat, lon

5. Telegram отправит вам код подтверждения. Введите его в всплывающем окне (+ пароль двухфакторной аутентификации, если он у вас есть)

6. Затем нажмите Start Search
7. Все результаты будут отображаться следующим образом:

• зелёный для 500 м
• жёлтый для 1000 м
• оранжевый для 2000 м
• красный для >3000 м

(Примечание: результаты также можно найти в Geogramint/cache_telegram/ в форматах json и csv + изображения профилей)

8. Reset очистит результаты и удалит cache_telegram

Более подробно в Wiki.

📡 Пример: CLI

1. Начните с создания ключа API для вашего аккаунта Telegram здесь. Также необходимо установить фото профиля в вашем аккаунте и в настройках Конфиденциальность и безопасность включить отображение фото профиля для всех.

2. Запустите Geogramint

3. Начните с настройки: с помощью команды set-config укажите свои данные (api_id, api_hash и номер телефона)

4. Запустите функцию поиска, используя координаты в формате lat lon с помощью команды start-scan:

⬇

5. Все результаты будут отображаться следующим образом:

• зелёный для 500 м
• жёлтый для 1000 м
• оранжевый для 2000 м
• красный для >3000 м

(Примечание: результаты можно экспортировать в зависимости от параметров, использованных с start-scan; по умолчанию изображения профилей и результаты в формате json находятся в Geogramint/cache_telegram/)

6. reset-scan очистит cache_telegram

Более подробно в Wiki.

📖 Wiki

Не забудьте проверить Wiki перед тем, как опубликовать issue или задать вопрос.

📝 Лицензия

GNU General Public License v3.0

🙏 Благодарности:

• Мои коллеги из Projet FOX
• sergiombd