Osintgram README

The project's README from github.com/Datalux/Osintgram. As one markdown file: README.md.

Osintgram 🔎📸

version-1.3 GPLv3 Python3 Telegram Docker

Osintgram is an OSINT tool on Instagram to collect, analyze, and run reconnaissance.

Disclaimer: FOR EDUCATIONAL PURPOSE ONLY! The contributors do not assume any responsibility for the use of this tool.

$${\color{red}Warning:}$$ It is advisable to not use your own/primary account when using this tool.

$${\color{red}Warning:}$$ If you fork the project and add your instagram credentials to you home repository do not upload them to github. You can disable uploading a certain file by adding it to ignore list.

Tools and Commands 🧰

Osintgram offers an interactive shell to perform analysis on Instagram account of any users by its nickname. You can get:

- addrs           Get all registered addressed by target photos
- captions        Get user's photos captions
- comments        Get total comments of target's posts
- followers       Get target followers
- followings      Get users followed by target
- fwersemail      Get email of target followers
- fwingsemail     Get email of users followed by target
- fwersnumber     Get phone number of target followers
- fwingsnumber    Get phone number of users followed by target
- hashtags        Get hashtags used by target
- info            Get target info
- likes           Get total likes of target's posts
- mediatype       Get user's posts type (photo or video)
- photodes        Get description of target's photos
- photos          Download user's photos in output folder
- propic          Download user's profile picture
- stories         Download user's stories  
- tagged          Get list of users tagged by target
- wcommented      Get a list of user who commented target's photos
- wtagged         Get a list of user who tagged target

You can find detailed commands usage here.

Latest version | Commands | CHANGELOG

FAQ

  1. Can I access the contents of a private profile? No, you cannot get information on private profiles. You can only get information from a public profile or a profile you follow. The tools that claim to be successful are scams!
  2. What is and how I can bypass the challenge_required error? The challenge_required error means that Instagram notice a suspicious behavior on your profile, so needs to check if you are a real person or a bot. To avoid this you should follow the suggested link and complete the required operation (insert a code, confirm email, etc)

Installation ⚙️

  1. Fork/Clone/Download this repo

    git clone https://github.com/Datalux/Osintgram.git

  2. Navigate to the directory

    cd Osintgram

  3. Create a virtual environment for this project

    python3 -m venv venv

  4. Load the virtual environment

    • On Windows Powershell: .\venv\Scripts\activate.ps1
    • On Linux and Git Bash: source venv/bin/activate

  5. Run pip install -r requirements.txt

  6. Open the credentials.ini file in the config folder and write your Instagram account username and password in the corresponding fields. Or use hikerapi_token from https://hikerapi.com/tokens (first 100 requests are free after registration and confirmation of your tg)

    Alternatively, you can run the make setup command to populate this file for you.

  7. Run the main.py script in one of three ways

    • As an interactive prompt python3 main.py <target username>
    • Or execute your command straight away python3 main.py <target username> --command <command>
    • Or execute using HikerAPI token via env HIKERAPI_TOKEN=<hikerapi token> python3 main.py <target username> -c <command>

Use Osintgram v2 (beta)

You can use Osintgram2 beta just switching to v2 branch. The v2 has some improvements and is faster with a new command execution interface. Try it just running git checkout v2.

Docker Quick Start 🐳

This section will explain how you can quickly use this image with Docker or Docker-compose.

Prerequisites

Before you can use either Docker or Docker-compose, please ensure you do have the following prerequisites met.

  1. Docker installed - link
  2. Docker-composed installed (if using Docker-compose) - link
  3. Credentials configured - This can be done manually or by running the make setup command from the root of this repo

Important: Your container will fail if you do not do step #3 and configure your credentials

Docker

If docker is installed you can build an image and run this as a container.

Build:

docker build -t osintgram .

Run:

docker run --rm -it -v "$PWD/output:/home/osintgram/output" osintgram <target>

Using docker-compose

You can use the docker-compose.yml file this single command:

docker-compose run osintgram <target>

Where target is the Instagram target for recon.

Alternatively, you may run docker-compose with the Makefile:

make run - Builds and Runs with compose. Prompts for a target before running.

Makefile (easy mode)

For ease of use with Docker-compose, a Makefile has been provided.

Here is a sample work flow to spin up a container and run osintgram with just two commands!

  1. make setup - Sets up your Instagram credentials
  2. make run - Builds and Runs a osintgram container and prompts for a target

Sample workflow for development:

  1. make setup - Sets up your Instagram credentials
  2. make build-run-testing - Builds an Runs a container without invoking the main.py script. Useful for an it Docker session for development
  3. make cleanup-testing - Cleans up the testing container created from build-run-testing

Development version 💻

To use the development version with the latest feature and fixes just switch to development branch using Git:

git checkout development

and update to last version using:

git pull origin development

Updating ⬇️

To update Osintgram with the stable release just pull the latest commit using Git.

  1. Make sure you are in the master branch running: git checkout master
  2. Download the latest version: git pull origin master

Contributing 💡

You can propose a feature request opening an issue or a pull request.

Here is a list of Osintgram's contributors:

External library 🔗

Instagram API

Osintgram (Datalux/Osintgram)

Searching Database…

15.1K ·GitHub
Osintgram
Что это такое?Osintgram — это OSINT-инструмент для Instagram, который позволяет собирать, анализировать и проводить разведку по любому публичному аккаунту Instagram через интерактивную оболочку, достаточно указать его никнейм.
Это библиотека или отдельная программа, которую я запускаю?Это самостоятельная CLI-программа на Python: вы клонируете репозиторий и запускаете main.py, после чего попадаете в интерактивную оболочку с командами разведки по целевому аккаунту.
Как это запустить?Клонируйте репозиторий, создайте виртуальное окружение Python, выполните pip install -r requirements.txt, заполните credentials.ini (или выполните make setup), затем запустите python3 main.py либо в режиме интерактивной строки, либо с --command для одной команды.
Что нужно иметь до запуска — логин в Instagram?Нужно либо настоящее имя пользователя и пароль Instagram, указанные в credentials.ini, либо токен HikerAPI (первые 100 запросов бесплатны), переданный через конфигурацию или переменную окружения HIKERAPITOKEN.
Может ли он получать доступ к закрытым профилям и есть ли риск для моего аккаунта?Нет: он работает только с публичными профилями или с теми, на которые вы уже подписаны, а любой инструмент, утверждающий обратное, — мошенничество. В README также предупреждается, что использование вашего собственного основного аккаунта Instagram грозит ошибкой 'challenge required' или ограничением аккаунта.
Одинаково ли он работает на Windows и Linux?Да, он работает в Windows (PowerShell), Linux и Git Bash, с немного разными командами активации виртуального окружения для каждой системы; также предусмотрены варианты установки через Docker и Docker-compose.
Есть ли вариант с Docker, чтобы не настраивать Python самостоятельно?Да, есть Dockerfile и docker-compose.yml, а также Makefile с целями make setup и make run, которые настраивают учетные данные и запускают контейнер в две команды.
Есть ли более новая версия инструмента?Да, Osintgram2 (бета) доступен в ветке v2 с более быстрым и улучшенным интерфейсом выполнения команд — переключиться на нее можно командой git checkout v2.
Какую информацию можно получить о целевом аккаунте?В README указан отдельный справочник команд, в котором перечислено всё, что интерактивная оболочка может получить о подписчиках, публикациях и активности целевого аккаунта, но в основном README не перечислены все команды.
Можно ли этим легально пользоваться?Проект прямо помечен как предназначенный только для образовательных целей, а участники проекта снимают с себя ответственность за то, как используется инструмент.
What are similar projects?maigret, social-analyzer, holehe, OneForAll, theHarvester, Photon, GhostTrack, bbot
Which topics is it in?osint-python, instagram, analysis, information-gathering, reconnaissance, osint, python3, penetration-testing, hacking, docker-compose, gplv3, command-line-tool
Creator
Datalux
Size
4.3 MB
Stars
15.1K
Updated
CommitOct 15Release2.0Sep 14
Age
7y
Commits · 90 Days