InstagramPrivSniffer Documentation

The tool is executed using main.py. You can access private account posts that are revealed via collaboration with public accounts, or download specific media posts.

View available commands

To see the help menu and all available flags, run:

python main.py -h

Access private account post links

Use the -n flag followed by the target Instagram username to retrieve post links:

python main.py -n <username>

Download and view a specific post

Use the -d flag followed by the full Instagram post URL to download the media:

python main.py -d <post_url>

# Access post links for a user
python main.py -n keyloggerluvr

# Download a specific post
python main.py -d https://www.instagram.com/keyloggerluvr/p/DL47hX4olz8wRQXBQ4HAaEmba9x7nC9HCSm4M80

Follow these steps to set up the tool in a local environment using a Python virtual environment.

1. Clone the repository

   git clone https://github.com/obitouka/InstagramPrivSniffer.git
   cd InstagramPrivSniffer

2. Create a virtual environment

   • Linux / macOS:

     python3 -m venv .venv

   • Windows:

     python -m venv .venv

3. Activate the virtual environment

   • Linux / macOS:

     source .venv/bin/activate

   • Windows:

     .venv\Scripts\activate

4. Install dependencies

   python -m pip install -r requirements.txt

Instagram PrivSniffer is a command-line tool that provides two primary functionalities: fetching account data and downloading media. The tool uses a command-line argument parser to determine the mode of operation.

Modes of Operation

1. Fetch Account Data: Triggered by providing a --name argument (representing the Instagram username). This uses the fetch_data core function.
2. Download Media: Triggered by providing a --dload argument. This uses the download_media core function.

Both modes support a --debug flag to enable debug logging.

# Example: Fetch data for a specific user
python main.py --name <username>

# Example: Download media for a specific user
python main.py --dload <username>

# Example: Enable debug mode
python main.py --name <username> --debug

The following flags are used with main.py to control the tool's behavior.

- `-h`: View available commands (help)
- `-n <username>`: Use this to access private account post links
- `-d <post_url>`: Use this to download and view a specific post