whatsapp-status-checker 0.1.0

This package continously view a specific WhatsApp contact status as soon as it is uploaded OR get notified every 30mins, 1hour, 3hours or 6hours.

WhatsApp Status Checker

A high-performance, automated tool to continuously monitor and interact with WhatsApp statuses.

WhatsApp Status Checker is a high-performance tool designed to continuously monitor and interact with WhatsApp statuses. It can automatically view a specific contact's status (Images, Videos, Text, or Audio) as soon as they are uploaded, ensuring every update is registered as "viewed" even on slow internet connections. Alternatively, it can function in a notification-only mode, alerting you via WhatsApp at your preferred intervals (30m, 1h, 3h, 6h).

NOTE: WhatsApp does not allow bots or unofficial clients on their platform, so this shouldn't be considered totally safe.

Demo Video

View HD Demo Video here

AI Auto-Healing (Deprecation)

While we explored implementing an AI-powered "Auto-Healing" mechanism to dynamically resolve broken XPaths, it has been intentionally deprecated. WhatsApp Web is a "heavy" application with highly dynamic DOM structures, making automated path resolution unreliable and performance-heavy.

To ensure the bot remains stable and reliable, we manually maintain and update the XPaths using an accessibility-first approach (targeting ARIA labels and attributes). This makes the locators significantly more resilient to UI updates and provides the consistency required for heavy applications like WhatsApp.

WhatsApp Messenger

CallMeBot was used for WhatsApp message, PLEASE READ!

How to use

Make sure your installed Google Chrome Browser is the latest.

• Create a .env file.
  • Set MY_NUMBER to your phone number. (Your WhatsApp Number e.g: 234xxxxxxxxxx)
  • Set CALLMEBOT_APIKEY to your API Key. (API Key provided by CallMeBot)

    See CallMeBot for detailed information.

  • Set STATUS_UPLOADER_NAME contact you want to view their status.

    NOTE: As it is saved on your phone(Case Sensitive).

  • Optionally, set TIMEZONE to your preferred timezone. Time will be displayed in this timezone.

    If not set, it resolves to IP timezone.

Installation

• Using UV

  • Install UV if you haven't already using pip install uv
  • Initialize and create virtual environment using uv init . && uv venv
  • Install package using uv add whatsapp-status-checker
• Using PIP

  • Create a Virtual Environment using py -m venv .venv
  • Activate your virtual environment using .venv\Scripts\activate
  • Install dependencies using pip install whatsapp-status-checker

Usage

CLI (Recommended)

You can run the application directly from the terminal using the wsc alias:

• Using UV

  uv run wsc
  

• Using Python

  python -m whatsapp_status_checker
  

  Or if the package is already installed in your path:

  wsc
  

Python Script

Alternatively, you can import and run it in your own Python script:

from whatsapp_status_checker import WhatsAppStatusChecker

def main():
    # Create and run application
    app = WhatsAppStatusChecker()
    app.run()

if __name__ == "__main__":
    main()

Screenshots

Terminal | First Time Logging In

Terminal | Viewed Contact Status

WhatsApp Message | Status Notification

See other Screenshots, Click here

Errors and Fixes

• Timeout When Logging in: The application now uses an efficient 3-minute (180s) polling loop that handles QR code scanning and transient loading screens automatically.

  If you consistently timeout, ensure your internet connection is stable.

• Not Receiving WhatsApp Message: Make sure you follow CallMeBot instructions carefully.

  Also confirm your .env values are correct.

Support and Contribute

• Please to encourage developer(s).
• Fork, do your thing and create a PR.

Issues and Bug Reports

Found a bug or have a feature request? Please:

1. Check existing issues: Browse issues to see if it’s already reported.
2. Open a new issue: Create one here with:
   • A clear title
   • Description (and steps to reproduce, if a bug)
   • Expected vs actual behavior
   • Screenshots or error logs, if relevant
   • Environment (OS, Python, Chrome version)
3. Use the template: Please use the provided bug report template.
4. Feature requests: Explain what you want, why it’s useful, and any suggestions.

Discussion

Have feedback or suggestions? Open an issue or join dicussions on new features, improvements, and use cases. Your input helps shape the project!

TODO

• PyPi Package.
  • Convert to a package.
  • pip install package.
  • publish to PyPi.
• Automatically
  • Use specified timezone othwerwise automatically get it.
  • Check first time activity.
    • Make sure it is completely synced with phone (Loading messages).
  • Handle Chromedriver
    • Check if Chrome browser is updated (same version as latest chromedriver release)
    • Download latest chromedriver.
    • Extract and move to driver directory.
  • Handle dedicated Chrome profile
    • Create a new chrome profile(if not previously done).
    • Use the newly chrome profile(if just created for the first time).
    • Use existing chrome profile(if already created).