HyTrackV3

Overview

HyTrackV3 is a self-hosted, headless tracking engine designed for users who want a centralized solution to monitor multiple shipments. Instead of manually checking tracking numbers across different courier websites, HyTrackV3 automatically extracts new tracking numbers from your inbox, tracks them in the background, and emails formatted HTML updates when a package transit status changes.

Key Features

• Automatic Discovery: Scans Gmail or Outlook inboxes for new 11-digit (Blue Dart) and 12-14 digit (Delhivery) tracking numbers without user intervention.
• Smart Change Detection: Employs SHA-256 hashing to compare a shipment's "fingerprint" against previous states, guaranteeing notifications are only triggered upon genuine status updates.
• Hybrid Web Scraper: Dynamically switches scraping strategies based on the carrier. Utilizes requests and BeautifulSoup for static sites (Blue Dart), and headless Selenium (Chrome) for dynamic pages (Delhivery).
• Mobile-First Notifications: Dispatches HTML emails with direct tracking links, status icons, and chronological progression.

How It Works

1. Ingestion: A Python script securely logs into the designated IMAP server and uses Regular Expressions (Regex) to extract newly received waybills.
2. Tracking: The core engine routes the tracking ID to the appropriate scraper function to pull the latest shipping event data.
3. Analysis: The scraped data is hashed (SHA-256) and compared against the last known status stored in the local SQLite database.
4. Notification: If the hash differs, the system triggers the SMTP protocol to construct and send a formatted alert to the user.

Database & State Management

To remain lightweight and portable, the system manages state using a single-table SQLite database. This persistent backend prevents duplicate notifications and allows the script to run statelessly across cron jobs.