Geogramint - 用于Telegram的OSINT地理定位工具

<p align="center"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/84f1b863-9fb5-41e3-8290-a88b5a291b13.png" width="300"/> </p> <p align="center"> <img src="https://img.shields.io/badge/version-1.4-orange" /> <img src="https://img.shields.io/badge/PYTHON-03b1fc?style=for-the-badge&logo=python"/> <a href="https://github.com/Alb-310"> <img alt="GitHub" src="https://img.shields.io/badge/GitHub-100000?style=for-the-badge&logo=github&logoColor=white"/><a/> <a href="https://twitter.com/Alb_310"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/ee7c467f-cbaf-416d-8637-3366c83576d4.svg"/><a/> <img src="https://yellow-cdn.veclightyear.com/835a84d5/0376ed9f-5c27-4003-8b17-62a7369ab03b.svg"/> <p align="center"> <a href="https://projetfox.com/"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/58738ecd-12ff-4ae0-a517-1bbf53342dea.png" width="200"/> <a/>

关于

Geogramint是一个OSINT工具，利用Telegram的API来查找附近的用户和群组。受到Tejado的Telegram附近地图的启发，该项目已不再维护，Geogramint旨在提供一个更加用户友好的替代方案。

Geogramint只能找到已激活附近功能的Telegram用户和群组。默认情况下，此功能是关闭的。

该工具在Windows上完全支持，在Mac OS和Linux发行版上部分支持。

<p align="center"> <img src="https://github.com/Alb-310/Geogramint/assets/52386954/7dde5789-2a58-438e-a256-06b4612f1443" />

🛠️ 安装

要求： Python 3.9, 3.10 或 3.11<br>

Windows系统

• 使用安装程序：点击这里！

• 使用Github：

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

python3 geogramint.py # GUI模式
python3 geogramint.py --help # CLI模式

或根据您的安装情况：

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

python geogramint.py # GUI模式
python geogramint.py --help # CLI模式

Mac OS系统 和 Linux系统

• 使用Github：

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

python3 geogramint.py # GUI模式
python3 geogramint.py --help # CLI模式

或根据您的安装情况：

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

python geogramint.py # GUI模式
python geogramint.py --help # CLI模式

更多详情请查看Wiki。

📡 示例：GUI

1. 首先在此处为您的Telegram账户创建一个API密钥。您还需要在账户上设置头像，并在"隐私和安全"设置中将头像设置为对所有人可见。

<p align="center"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/6938612e-4c69-4a33-9013-6ce8bac29da3.jpg" width="300"/>

2. 启动Geogramint
3. 在设置中，输入您的信息（api_id、api_hash和电话号码），选择报告偏好，然后"保存"

<p align="center"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/246801ef-2e32-455c-8a79-95336d15a2ee.png" width="500"/> <img src="https://yellow-cdn.veclightyear.com/835a84d5/36447d08-ffe1-4e22-84f4-eaad1ba6438f.png" width="500"/>

4. 选择您想搜索的位置，可以通过移动地图或使用"纬度,经度"格式的坐标搜索功能

<p align="center"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/bd02e734-886b-4b57-be58-54584851322a.png" width="700"/>

5. Telegram会向您发送验证码，将其输入弹出窗口（如果您有两步验证密码，也需要输入）

<p align="center"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/a5fbb231-402b-44f6-a613-6b38556647c5.png" width="700"/>

6. 然后点击"开始搜索"
7. 所有结果将按以下方式显示：

• 绿色表示500米内
• 黄色表示1000米内
• 橙色表示2000米内
• 红色表示3000米以上

（注：结果也可以在Geogramint/cache_telegram/目录下以json和csv格式找到，同时包含个人资料图片）

<p align="center"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/4a34fa44-b273-43e4-861c-a8cee90e5fed.png" width="700"/>

8. "重置"将清除结果并删除cache_telegram

更多详情请参阅Wiki。

📡 示例：命令行界面

1. 首先在此处为您的Telegram账户创建一个API密钥。您还需要在账户上设置头像，并在"隐私和安全"设置中将头像设置为对所有人可见。

<p align="center"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/6938612e-4c69-4a33-9013-6ce8bac29da3.jpg" width="300"/>

2. 启动Geogramint

3. 首先进行配置，使用set-config命令设置您的信息（api_id、api_hash和电话号码）

4. 使用纬度 经度格式的坐标和start-scan命令开始搜索：

<p align="center"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/4a2d5e2c-045e-4778-b293-a3f3edab5b58.png" width="500"/> <p align="center"> ⬇ </p> <p align="center"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/1c175f0f-953f-4329-85ca-02670f03513a.png" width="500"/>

5. 所有结果将按以下方式显示：

• 绿色表示500米
• 黄色表示1000米
• 橙色表示2000米
• 红色表示>3000米

（注：根据使用start-scan时的选项，结果可以导出。默认情况下，头像图片和json格式的结果会保存在Geogramint/cache_telegram/目录下）

6. reset-scan将清空cache_telegram

更多详情请查看Wiki。

📖 Wiki

在提出问题或发布issue之前，请记得查看Wiki。

📝 许可证

GNU通用公共许可证v3.0

🙏 感谢：

• 我在Projet FOX的团队成员
• sergiombd