Big White Rabbit, which can hop wifi channels while sniffing for information
Project description
OsxHarvey
The Big White Rabbit OsxHarvey is a small tool/Wifi-Sniffer to grab all the data.
Being a rabbit, Harvey hops from wifi-channel to wifi-channel to make sure he doesn't miss anything.
Harvey is intended to be used by security professionals for LEGAL purposes.
This package is in pre-Alpha and therefore still under construction
Requirements:
OsxHarvey is tested and built on Python3.9 and macOS Big Sur, it uses scapy under the hood and needs to be run with sudo privileges.
Installation:
pip install osxharvey
Usage:
OsxHarvey can either be used in code or from the command line.
CLI:
osxharvey
Code:
from osxharvey import OsxHarvey
# Following params are default values
bwr = OsxHarvey(
iface="en0", rounds=1,
ch_from=1, ch_to=15,
devices=False, ssids=False,
probes=False, vendors=False,
verbose=False
)
# Params:
"""
:param str iface: Interface to sniff on
:param int rounds: How many times to go through the Wifi channels
:param int ch_from: Wifi channel to start sniffing on
:param int ch_to: Wifi channel to end sniffing on
:param bool devices: Write collected device/manufacturer combinations to file
:param bool ssids: Write detected ssids to file
:param bool probes: Write collected probe requests to file
:param bool vendors: Write list of unique detected vendors to file
:param bool verbose: Toggles verbose output
"""
# Disconnets the Wifi, enables monitor mode and starts scanning
# returns a dictionary with the collected data
results = bwr.start_scanning()
# Updates oui lookup data:
bwr.update_ouilookup_data()
TODO:
Enable installation as command line tool- Expand testing
Setup automated testing through github
- Extend functionality
- Generate proper documentation
- Think about GUI
- Think about portability
Changelog
0.0.9 (2021-06-08)
New
- Added function to update the oui lookup data. [kampfhamster309]
Other
- Fixed markdown mistake. [kampfhamster309]
0.0.8 (2021-06-07)
New
- OsxHarvey can now be used from the CLI. [kampfhamster309]
Changes
-
Minor changes to Readme. [kampfhamster309]
-
Small fixes/additions to Changelog and Readme. [kampfhamster309]
Other
-
Create FUNDING.yml. [Felix Harenbrock]
-
Delete custom.md. [Felix Harenbrock]
-
Update issue templates. [Felix Harenbrock]
0.0.7 (2021-06-06)
Changes
-
Added state badge to README. [kampfhamster309]
-
Added workflow for automated testing. [kampfhamster309]
-
Added requirements to setup github actions for automated testing. [kampfhamster309]
Fix
-
Wip Temporarily removed check for privileges. [kampfhamster309]
-
Some small fixes for running Github Actions. [kampfhamster309]
-
Fixed refactoring bug. [kampfhamster309]
-
Fixed bug with writing collected data to files. [kampfhamster309]
Other
- Modified gitchangelog. [kampfhamster309]
0.0.6 (2021-06-06)
Changes
-
Some minor changes to README. [kampfhamster309]
-
Added README and LICENSE. [kampfhamster309]
Fix
-
Fixed refactoring bug. [kampfhamster309]
-
Fixed bug with writing collected data to files. [kampfhamster309]
Other
-
Changelog updated. [kampfhamster309]
-
Updated changelog. [kampfhamster309]
-
Modified gitchangelog. [kampfhamster309]
0.0.5 (2021-06-06)
New
- Added tests for packet parser. [kampfhamster309]
Changes
- Some minor changes to README. [kampfhamster309]
Fix
- Fixed bug with writing collected data to files. [kampfhamster309]
0.0.4 (2021-06-06)
New
- Added actually useful info to README. [kampfhamster309]
0.0.3 (2021-06-05)
Changes
- Added README and LICENSE. [kampfhamster309]
0.0.2 (2021-06-05)
Other
-
Added automated changelog. [kampfhamster309]
-
Applied black. [kampfhamster309]
0.0.1 (2021-06-05)
Other
-
Applied basic package structure, versioning and basic test structure. [kampfhamster309]
-
Initial commit. [kampfhamster309]
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for osxharvey-0.0.9-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c312684d033e45660a93a2e7316713688be7ad2dd6ea954d9018e1df165bd8cc |
|
MD5 | 5e8d017e367a34b6d447d8a7ec644e22 |
|
BLAKE2b-256 | cc76331d2082152b6386547ea751119c19a06045efc1c79efdffff47339782f8 |