How tmpertor/raven-storm works
Project type and purpose
• Raven-Storm is a Python 3.8–based, CLI DDoS toolkit.
• It’s structured as a modular command-line application (monolith with plugin‐style modules) for stress-testing networks and services across multiple protocols.
File structure
• Top‐level:
• main.py – entry point for the CLI
• install.sh, install_to_bin.sh – installation scripts
• requirements.txt – external dependencies
• Raven-Storm/CLIF_Framework
• framework.py – the custom CLI framework (parses commands, dispatches)
• Raven-Storm/modules
• Subfolders for each attack module: arp, bl, l3, l4, l7, scanner, server, wifi
• Each module implements a .main() that the framework invokes
• Raven-Storm/main.py – imports CLIF_Framework and registers modules
Key README insights
• Uses CLIF Framework to provide a consistent CLI experience
• Supports multiple attack “layers” (L3 ping, L4 UDP/TCP, L7 HTTP, ARP, Bluetooth, WiFi)
• Can run standalone or in distributed mode via the “server” module
• No persistent storage or external DB
Main components
a. CLI Layer
• User Console (bash/terminal)
• CLI Framework (framework.py)
b. Core Controller
• main.py (module loader & dispatcher)
• L3 Module (icmp/ping)
• L4 Module (udp/tcp flood)
• L7 Module (http flood)
• ARP Module (local network)
• BL Module (Bluetooth)
• WiFi Module (802.11 jamming)
• Scanner Module (discovery)
• Server Module (botnet coordinator)
d. System/OS Network Stack
• Raw sockets or scapy library
• Network interface drivers
e. External Entities
• Target hosts/services
• Distributed clients (when using server module)
Relationships & data flow
1. User → CLI Framework → Core Controller
2. Core Controller → selected Module
3. Module → OS Network Stack → Target
4. (Server Module only) → accept connections from remote Raven-Storm clients → forward DDoS commands
Architectural patterns & principles
• Plugin/Command pattern: each module adheres to a common interface (.main())
• Single-process, modular design
• Separation of concerns: CLI parsing, orchestration, and attack implementation are distinct
Technologies & libraries
• Python 3.8 runtime
• CLIF Framework (custom) for command parsing
• Third-party libraries (e.g., scapy) for packet crafting
• Standard socket/threading libraries
• Bash scripts for install/uninstall
[ ] Clear component labels