Demonstration: GUI

Contents

1. Configure Geogramint
   1. Telegram's API
   2. Account settings
2. Explanation of the interface
3. Begin a scan
4. Explanation of the results
   1. On the interface
   2. In the files
5. PDF Reports

Configure Geogramint

Once Geogramint is installed, you will need to configure a few things before you can start using it. You will need a Telegram account. If you don't have one, create one first and then come back to us.

Telegram's API

To use Geogramint, you will need to obtain the API hash and API id linked to your account. Open my.telegram.org

Log in using the phone number linked to your account, then go to API development tools. Once you configured your "App", you will have access to the api_id and api_hash.

Back to Geogramint, now go to Settings and fill in all the required information.

Set the Extended Report option to your preference : if enabled, all detected entities will be displayed on the PDF reports, otherwise only detected entities up to 2000m radius.

Account settings

In order to use Geogramint, you will need to put a profile picture on your Telegram account and change some privacy settings. With Tejado's Telegram Nearby Map, we didn't have to make all of these changes, but Telegram has since made changes to its API. Perhaps they realized that some people who were practicing osint were using its Nearby feature for purposes other than its primary function.

After choosing a profile picture, go to Settings->Privacy and Security and enable Profile Photo to everybody.

Let's go back to Geogramint

Explanation of the interface

The interface of Geogramint is quite simple:

• Settings Button: you should have already used it in the previous part, it is the button that allows you to access the settings menu to configure Geogramint.
• Search on map: it's the search feature. You can move the map to a certain location by using it with coordinates in the lat, lon format. Ex: 35.174655830253165, 33.36142587267438 for the city of Nicosia in Cyprus.
• Start scan of a zone: By clicking, you launch a scan, on the pin point of the map, to search for users or groups nearby.
• Reset a search: You will need to click on it if you want to run a new scan. Clicking it will delete all the profile pictures downloaded to Geogramint/cache_telegram/users/ and Geogramint/cache_telegram/groups/. You also delete Geogramint/cache_telegram/users.json and Geogramint/cache_telegram/groups.json, the json results of your scan.

Begin a scan

We will start by using the search feature with the coordinates of Nicosia in Cyprus 35.174655830253165, 33.36142587267438.

It's time to run a scan.

Once the Start Search button is clicked, a pop up window will appear and ask for a code and a password (optional).

Enter the code you received from Telegram (either by sms, Telegram message or phone call) in the pop up. If you have activated the two-step verification, write your password.

Here are the results of the scan:

Explanation of the results

On the interface

For all users in the area, Geogramint will display Profile picture, Id, First Name, Last Name, Username and Distance. Some of those information may not be available due to the privacy settings of the user.

For groups in the area, Geogramint will display Profile picture, Id, Name and Distance. Some of those information may not be available due to the privacy settings of the group.

The users and groups in green were located within a radius of 500m around the point of origin. Those in yellow were located within a radius of 1km, and those in orange within 2km radius. Those in red, they were located within a radius of 3km or more around the point of origin.

In the files

Geogramint provides more details from a scan in Geogramint/cache_telegram/.

• All detected users are available in Geogramint/cache_telegram/users.json and Geogramint/cache_telegram/users.csv, each user has his id, First name, Last name, Phone number and distance if available. For searches in countries with non-Latin alphabets, it is recommended to check the json or csv output in UTF-8 to get the correct spelling of the names.
• All detected groups are available in Geogramint/cache_telegram/groups.json and Geogramint/cache_telegram/groups.csv, each group has his id, name and distance if available. For searches in countries with non-Latin alphabets, it is recommended to check the json or csv output in UTF-8 to get the correct spelling of the names.
• All profile pictures of users and groups are available in Geogramint/cache_telegram/users/ and Geogramint/cache_telegram/groups/. They are named by the id of their corresponding user or group.

PDF Reports

Since v1.2, Geogramint allows to export the results as a pdf report :

By clicking the Export PDF button, a file selector will pop-up and allows you to choose the location and name of the pdf.

In the pdf report, you will find all the data acquired by Geogramint. Depending on your settings, users whose location is >3000m will be displayed or not.