mac-snoop v1.0.2

MAC-SNOOP

An NPM module useful for WiFi password cracking. Useful to use with hashcat.

This package is only for macOS, I wrote it because a lot of alternatives seemed overly complicated or unavailable on Mac.

• MAC-SNOOP
• Requirements
• Installation
  • Node.js
  • Snoop
  • Homebrew
  • Wireshark and Hcxtools

• Usage

  • Options
  • Problems

Requirements

1. Homebrew
2. Node.js
3. TCPDUMP (preinstalled on macOS AFAIK)
4. Wireshark. If you do not have Wireshark, it will be installed on first use.
5. Hcxtools. If you do not have these, they will also be installed on first use.

Note: Please make sure these tools are accessible from your command line and added to your path. This is how the CLI detects their installation. Make sure

which mergecap

and

which hcxpcapngtool

both work.

Installation

Node.js

Snoop

npm i -g mac-snoop

Homebrew

From brew.sh

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

or

snoop --install

Wireshark and Hcxtools

Once you are sure Homebrew has been installed (check with which brew):

brew install wireshark hcxtools

or run the snoop command. It will automatically install wireshark and hcxtools.

Usage

Example Usage:

snoop -o wifihash.hc22000

If you haven't installed Wireshark or hcxtools, the CLI will attempt to install them for you with brew. This will print a list of available networks to stdout. You then select them with their ID.

After you select the network, it will capture the network beacon, then start listening for the network handshake.

Once it has collected the handshake packets (i.e, someone has connected to the network). It will then merge the captured files and transform them into a form that hashcat can crack.

To crack with hashcat, use hashcat -m 22000

Options

• snoop -v - gets version number
• snoop -h - displays help
• snoop --list - will list availible network interfaces.
  • Essentially an alias for networksetup -listallhardwareports
• snoop -p - specifies password for commands (some of them must be run as sudo). If left blank, will prompt user for password.
• snoop -o sets the final output file.
• snoop -H sets the handshake file name. Note: this file is deleted after the merge.
• snoop -b sets the beacon file name. Note: this file is deleted after the merge.

• snoop -i sets the network interface to be used. To see a list of interfaces, type:

  networksetup -listallhardwareports

  The default interface is en0. On most MacBooks this is the wifi card.

  Due to limitations with recent macOS versions and hardware, this tool cannot be used with an external WiFi card on many new mac devices.

Problems

On ocassion, macOS will seem to be "stuck" in monitor mode. This can usually be fixed with a simple reboot. But I have added:

snoop --enable

as an alternative. It should also work to re-enable managed mode.

Written with StackEdit.