Skip to content

hazraChandrima/nirmas

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

14 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

NIRMAS

Tired of manually screenshotting Instagram profiles/posts and WhatsApp chats?

Let NIRMAS do the creepy work for you. It logs in, scrolls, and snatches every image while you pretend you're not a stalker.....just don’t blame us if you get caught πŸ˜Άβ€πŸŒ«οΈ

πŸ“œ Contents

  1. Setting Up
  2. WhatsApp Chat Screenshot Capture Tool
  3. Instagram Posts Screenshot Capture Tool
  4. Credits

πŸ› οΈ Setting up

  1. Clone the repo:

    git clone --depth=1 https://github.com/hazraChandrima/nirmas.git
    cd nirmas
  2. Create a virtual environment:

    python -m venv venv
  3. Activate the virtual environment:

    • On Windows:
      venv\Scripts\activate
    • On Linux/macOS:
      source venv/bin/activate
  4. Install the necessary dependencies:

    pip install -r requirements.txt


WhatsApp Chat Screenshot Capture Tool

It automates the process of capturing screenshots of a WhatsApp chat on an Android device. It uses the Android Debug Bridge (ADB) to communicate with the device and Python libraries for image processing and comparison.

✨ Features

  • Automatically navigates to a specified WhatsApp chat.
  • Captures screenshots of the chat and saves them locally.
  • Detects repeated content to avoid redundant screenshots.
  • Performs swipe gestures to scroll through the chat.

πŸ“ Requirements

Python Dependencies

Ensure you have Python installed on your system. The script uses the following libraries:

  • Pillow (for image processing)
  • numpy (for efficient image difference calculation)
  • colorama (for colored console output)

To install these dependencies, run:

pip install -r requirements.txt

βœ… Prerequisites

  1. An Android device.
  2. WhatsApp installed in the Android device.
  3. USB Debugging enabled on the device (steps provided below).
  4. A USB cable to connect the device to your computer.

Steps to Enable USB Debugging on Android

1. Enable Developer Options

  1. Open the Settings app on your Android device.
  2. Scroll down and tap on About phone (or About device).
  3. Find the Build number (may be under Software information).
  4. Tap the Build number 7 times until you see a message: "You are now a developer!"

2. Turn on USB Debugging

  1. Go back to the Settings app.
  2. Open System (or Additional settings on some devices).
  3. Tap on Developer options.
  4. Scroll down and find USB Debugging.
  5. Toggle USB Debugging to ON.
  6. Confirm the action when prompted.

πŸ“¦ Bundled ADB

This repository includes the necessary adb.exe executable and related files for Windows systems.

No Additional Installation Required

  • The script automatically uses the included ADB executable in the adb-tools/ folder.

Platform Compatibility

If you experience any issues with the included ADB, ensure the device is connected properly and that USB Debugging is enabled.

βš™οΈ Running the script

python adb_script.py


Instagram Posts Screenshot Capture Tool

It automates the process of taking screenshots of an Instagram profile and its posts (images only) using Selenium WebDriver for Chrome.

✨ Features

  • Logs into an Instagram account.
  • Captures a screenshot of the user profile.
  • Captures screenshots of all image posts by scrolling through the profile.
  • Saves screenshots in a designated folder.

πŸ“ Requirements

Python Dependencies

Ensure you have Python installed on your system. The script uses the following libraries:

  • selenium (for browser automation)
  • chromedriver-autoinstaller (for ensuring Chromedriver compatibility with installed Chrome version in your system)
  • colorama (for colored console output)
  • Pillow (for image processing)

To install these dependencies, run:

pip install -r requirements.txt

βœ… Prerequisites

  1. Google Chrome installed on your system.
  2. Instagram account credentials (username and password).

βš™οΈ Running the script

python seln_script.py

πŸ™Œ Credits

Thanks to Ayush Jayaswal(our team leader for SIH), for the idea, and all the guidance!
I really got to learn so much...

About

your social media stalker 🧐

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages