Readme
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.
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.
pip install osxharvey
OsxHarvey can either be used in code or from the command line.
osxharvey
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()
Some more refactoring. [kampfhamster309]
Started some refactoring. [kampfhamster309]
Update README.md. [Felix Harenbrock]
Create codeql-analysis.yml. [Felix Harenbrock]
Updated changelog. [kampfhamster309]
Minor changes to Readme. [kampfhamster309]
Small fixes/additions to Changelog and Readme. [kampfhamster309]
Create FUNDING.yml. [Felix Harenbrock]
Delete custom.md. [Felix Harenbrock]
Update issue templates. [Felix Harenbrock]
Added tests for packet parser. [kampfhamster309]
Added actually useful info to README. [kampfhamster309]
Added automated changelog. [kampfhamster309]
Minor additions to Readme. [kampfhamster309]
Added state badge to README. [kampfhamster309]
Added workflow for automated testing. [Felix Harenbrock]
Added requirements to setup github actions for automated testing. [kampfhamster309]
Some minor changes to README. [kampfhamster309]
Added README and LICENSE. [kampfhamster309]
More fixes for automated testing. [Felix Harenbrock]
Wip Temporarily removed check for privileges. [kampfhamster309]
Some more tinkering for test automation. [kampfhamster309]
Some small fixes for running Github Actions. [kampfhamster309]
Fixed refactoring bug. [kampfhamster309]
Fixed bug with writing collected data to files. [kampfhamster309]
Merge branch 'main' of https://github.com/kampfhamster309/OsxHarvey. [kampfhamster309]
Updated changelog. [kampfhamster309]
Changelog updated. [kampfhamster309]
Updated changelog. [kampfhamster309]
Modified gitchangelog. [kampfhamster309]
Applied black. [kampfhamster309]
Applied basic package structure, versioning and basic test structure. [kampfhamster309]
Initial commit. [kampfhamster309]
FAQs
Big White Rabbit, which can hop wifi channels while sniffing for information
We found that osxharvey demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
The Python Software Foundation has secured a 5-year sponsorship from Fastly that supports PSF's activities and events, most notably the security and reliability of the Python Package Index (PyPI).
Security News
LDAPjs, an LDAP Client and Server API for Node.js, was decommissioned after its maintainer received an abusive email from a user, raising concerns about this form of abuse as a potential attack vector.
Security News
CISA launched a new project called Vulnrichment to enrich CVEs with details that help prioritize patching and mitigation efforts, as the NVD backlog of unenriched CVEs awaiting analysis surpasses 10,000.