How ctrlsam/careless-whisper-python works
Careless Whisper is a Python proof of concept for analyzing delivery-receipt timing and running silent-message floods. The primary workflow configures a fingerprint scan, sends probes through a messenger, correlates receipt and send-order evidence, infers device and activity states, then reports or exports results. A separate DoS tool sends high-payload messages. The graph includes the documented exporters and Prometheus/Grafana monitoring capability; implementation excerpts establish only selected runtime links, so unsampled integrations are not treated as verified calls.
Main entry points: fingerprint/main.py Fingerprint runner · dos/main.py Flood runner · exporters/base.py Exporter contract · messengers/base.py Messenger interface
Components 19
User tools
- Interactive CLI
carelesswhisper/tools/cli/main.py - Terminal display
carelesswhisper/tools/cli/ui.py - Fingerprint runner
carelesswhisper/tools/fingerprint/main.py - Scan settings
carelesswhisper/tools/fingerprint/config.py - Flood runner
carelesswhisper/tools/dos/main.py - Flood settings
carelesswhisper/tools/dos/config.py
Probe runtime
- Messenger interface
carelesswhisper/messengers/base.py - WhatsApp adapter
carelesswhisper/messengers/whatsapp.py - Receipt correlation
carelesswhisper/exploit.py
Analysis and telemetry
- Behavior analysis
carelesswhisper/fingerprint.py
Export and monitoring
- CSV exporter
carelesswhisper/exporters/csv.py - JSONL exporter
carelesswhisper/exporters/jsonl.py - SQLite exporter
carelesswhisper/exporters/sqlite.py - Exporter contract
carelesswhisper/exporters/base.py - Prometheus metrics
carelesswhisper/metrics.py
Other components
- Operator
- Target device
- Prometheus scrape
- Grafana dashboards
Connections 28
- Operator → Interactive CLI: runs
README.md - Interactive CLI → Terminal display: updates
carelesswhisper/tools/cli/main.py - Interactive CLI → Fingerprint runner: starts
carelesswhisper/tools/cli/main.py - Operator → Fingerprint runner: runs
README.md - Fingerprint runner → Scan settings: uses settings
carelesswhisper/tools/fingerprint/main.py - Fingerprint runner → Messenger interface: configures callbacks
carelesswhisper/tools/fingerprint/main.py - Fingerprint runner → Receipt correlation: registers listeners
carelesswhisper/tools/fingerprint/main.py - Fingerprint runner → Behavior analysis: registers reports
carelesswhisper/tools/fingerprint/main.py - Fingerprint runner → Exporter contract: saves results
carelesswhisper/tools/fingerprint/main.py - Fingerprint runner → Prometheus metrics: publishes analysis
carelesswhisper/tools/fingerprint/main.py - Messenger interface → WhatsApp adapter: implemented by
carelesswhisper/messengers/whatsapp.py - WhatsApp adapter → Target device: sends probes
README.md - Target device → WhatsApp adapter: returns receipts
README.md - Receipt correlation → Messenger interface: sends silent messages
carelesswhisper/exploit.py - Receipt correlation → Behavior analysis: provides receipt evidence
carelesswhisper/fingerprint.py - Operator → Flood runner: runs
README.md - Flood runner → Flood settings: uses settings
carelesswhisper/tools/dos/main.py - Flood runner → Messenger interface: sends flood messages
carelesswhisper/tools/dos/main.py - Flood runner → Target device: floods
README.md - Fingerprint runner → CSV exporter: selects exporter
README.md - Fingerprint runner → JSONL exporter: selects exporter
README.md - Fingerprint runner → SQLite exporter: selects exporter
README.md - Exporter contract → CSV exporter: implemented by
carelesswhisper/exporters/csv.py - Exporter contract → JSONL exporter: implemented by
carelesswhisper/exporters/jsonl.py - Exporter contract → SQLite exporter: implemented by
carelesswhisper/exporters/sqlite.py - Fingerprint runner → Prometheus metrics: enables metrics
README.md - Prometheus metrics → Prometheus scrape: exposes metrics
carelesswhisper/metrics.py - Prometheus scrape → Grafana dashboards: feeds dashboards
README.md