Package: osxharvey
OsxHarveyTheBig White RabbitOsxHarvey 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 constructionRequirements: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 osxharveyUsage:OsxHarvey can either be used in code or from the command line.CLI:osxharveyCode:fromosxharveyimportOsxHarvey# Following params are default valuesbwr=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 dataresults=bwr.start_scanning()# Updates oui lookup data:bwr.update_ouilookup_data()TODO:Enable installation as command line toolExpand testingSetup automated testing through githubExtend functionalityGenerate proper documentationThink about GUIThink about portabilityChangelog0.0.11 (2021-08-27)NewAdded signal strength indicator and supported crypto algorithms to Beacon-Frame scans. [kampfhamster309]OtherAdded docstrings to observer and handler. [kampfhamster309]0.0.10 (2021-08-15)ChangesAdded CodeQL workflow. [kampfhamster309]OtherSome more refactoring. [kampfhamster309]Started some refactoring. [kampfhamster309]Update README.md. [Felix Harenbrock]Create codeql-analysis.yml. [Felix Harenbrock]0.0.9 (2021-06-08)NewAdded function to update the oui lookup data. [kampfhamster309]ChangesUpdated changelog. [kampfhamster309]OtherFixed markdown mistake. [kampfhamster309]0.0.8 (2021-06-07)NewOsxHarvey can now be used from the CLI. [kampfhamster309]ChangesUpdated changelog. [kampfhamster309]Minor changes to Readme. [kampfhamster309]Small fixes/additions to Changelog and Readme. [kampfhamster309]OtherCreate FUNDING.yml. [Felix Harenbrock]Delete custom.md. [Felix Harenbrock]Update issue templates. [Felix Harenbrock]0.0.7 (2021-06-06)NewAdded tests for packet parser. [kampfhamster309]Added actually useful info to README. [kampfhamster309]Added automated changelog. [kampfhamster309]ChangesMinor 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]FixMore 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]OtherMerge branch 'main' ofhttps://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]