Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (wos) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

wos

Monitor traffic for unencrypted data (using tshark) and display a dashboard in terminal.

Install

npm install -g wos

Usage

$ wos --help

  Monitor traffic for unencrypted data and display a dashboard.

    Usage
  $ wos -i <interface> [options]

    Info
      Capture interface is required. Use ifconfig command to find interfaces.

      SSID and password are required if using secured wifi such as WPA or WEP in order to decrypt packets.

      Wrap SSID and password in single quotes in order to escape special characters.

      After running wos, devices must send perform the EAPOL handshake in order for wos to decrypt their traffic. The handshake is initiated when the device connects or reconnects to the network.

    Options
      -i, --interface Capture interface
      -s, --ssid Wifi SSID
      -p, --pass Wifi password
      -n, --no-monitor Disable monitor mode
      -f, --format Format: dash (default), text
      -o, --outfile Output file

    Examples
      $ wos -i en0 --ssid='HomeWifi' --pass='d4Pazsw0rD' -o data.txt

You can simply just run wos command and it'll set up the options based on your current wifi connection.

$ wos

You can manually set the network capture interface card, as well as the SSID and password of the network. Those are required in order to decrypt packets on a secured network such as WPA.
Remember, you can only capture on the same network you are connected to.

$ wos -i en0 --ssid='HomeWifi' --pass='d4Pazsw0rD'

WOS supports:

Retrieving logins from unencrypted HTTP pages
Retrieving credentials from unencrypted FTP logins
Retrieving credentials from unencrypted SMTP logins
Retrieving credentials from unencrypted POP logins
Retrieving credentials from unencrypted IMAP logins

Requirements

Wireshark
tshark (comes with Wireshark)
Wireless interface card that supports monitor mode

FAQ

Q. My wireless card is stuck in monitor mode!
- A. Kill tshark processes and toggle off and on the wireless card.
```
pkill tshark
```
Q. What does WOS mean?
- A. It means "Wall of Shetland"
  
  _{^{Wall of Sheep is a trademark and couldn't use it.}}

License

MIT