Repository files navigation

Osintgram is aOSINT 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.

Warning: It is advisable tonot use your own/primary account when using this tool.

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 usagehere.

Latest version |Commands |CHANGELOG

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 thechallenge_required error? Thechallenge_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)

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. Runpip install -r requirements.txt

6. Open thecredentials.ini file in theconfig folder and write your Instagram account username and password in the corresponding fields

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

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

   • As an interactive promptpython3 main.py <target username>
   • Or execute your command straight awaypython3 main.py <target username> --command <command>

You can use Osintgram2 beta just switching tov2branch.The v2 has some improvements and faster with a new command execution interface. Try it just runninggit checkout v2.

This section will explain how you can quickly use this image withDocker orDocker-compose.

Before you can use eitherDocker orDocker-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 themake setup command from the root of this repo

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

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>

• The<target> is the Instagram account you wish to use as your target for recon.
• The required-i flag enables an interactive terminal to use commands within the container.docs
• The required-v flag mounts a volume between your local filesystem and the container to save to the./output/ folder.docs
• The optional--rm flag removes the container filesystem on completion to prevent cruft build-up.docs
• The optional-t flag allocates a pseudo-TTY which allows colored output.docs

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

docker-compose run osintgram<target>

Wheretarget is the Instagram target for recon.

Alternatively you may rundocker-compose with theMakefile:

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

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

Here is a sample work flow to spin up a container and runosintgram 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 themain.py script. Useful for anit Docker session for development
3. make cleanup-testing - Cleans up the testing container created frombuild-run-testing

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

git checkout development

and update to last version using:

git pull origin development

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

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

Here is a list of Osintgram's contributors:

Instagram API