Skip to content

roxm337/ArgusScan

Repository files navigation

👁️‍🗨️ ArgusScan

The All-Seeing Camera Scanner
Named after Argus Panoptes — The Hundred-Eyed Giant of Greek Mythology


🗺️ Overview

ArgusScan is a powerful, multi-threaded tool for discovering and checking the accessibility of public cameras worldwide.
Scan by country, filter results, and enjoy a colorized, organized terminal experience.


📊 Architecture

              +-------------------+
              |  Camera Network   |
              +--------+----------+
                       |
           +-----------v-----------+
           |      ArgusScan       |
           |  (The All-Seeing)    |
           +-----------+----------+
                       |
         +-------------v-------------+
         |   Discovered Cameras     |
         |   - Country Filtering    |
         |   - Accessibility Check  |
         |   - Multi-threaded Scan  |
         +---------------------------+

✨ Features

  • 🌍 Country Scanning: Scan cameras in 100+ countries using ISO codes
  • Parallel Processing: Multi-threaded architecture for faster results
  • Accessibility Check: Test which cameras are actually online and accessible
  • 📁 Organized Output: Automatic saving to categorized text files
  • 🎨 Colorized UI: Easy-to-read terminal interface with status colors
  • 🔧 Customizable: Control scan depth, output format, and verbosity

🖥️ Demo

ArgusScan Terminal Demo


🛠️ Installation

Requirements

  • Python 3.8+
  • Linux/macOS/Windows (WSL recommended for Windows)

Steps

# 1. Clone repository
git clone https://github.com/roxm337/ArgusScan.git && cd ArgusScan

# 2. Install dependencies
pip3 install -r requirements.txt

# 3. Make executable (optional)
chmod +x arguscan.py

# 4. Verify installation
./arguscan.py

🚀 Usage

Basic Command

python3 arguscan.py -c US  # Scan US cameras (saves to US_cameras.txt)

Full Options

Parameter Description Example
-c Country code (required) -c DE (Germany)
-o Custom output filename -o my_scan.txt
-p Max pages to scan (default: all) -p 3 (3 pages only)
-t Test camera accessibility -t (enable check)
-v Verbose mode (show details) -v
-h Show help message -h

Enjoy scanning the world with ArgusScan! 🌐

About

The All-Seeing Camera Scanner

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages