Skip to main content

Quick start

Five minutes from plug-in to first useful commands.

If you have not installed the CLI yet:

# Linux / macOS
curl -fsSL https://cdn.infishark.com/install.sh | sh
# Windows (PowerShell)
irm https://cdn.infishark.com/install.ps1 | iex

Details: Install.

1. Plug in and find the device

infishark ports
infishark device info
infishark device status

2. Scan the air

infishark wifi scan
infishark wifi list # last scan cache

infishark ble scan
infishark ble list
infishark ble show 1 # detail for row # from last scan

Add --json when scripting.

3. Capture a handshake (host files)

infishark wifi handshake --ssid "YourLabAP"
# writes hs_....pcap (+ .22000 unless --pcap-only)

# optional: hand off to hashcat on the host
infishark wifi handshake --ssid "YourLabAP" --crack --wordlist /path/to/list.txt

4. Monitor into Wireshark (Linux example)

# Channel-locked sniff
infishark wifi monitor --channel 6 | wireshark -k -i -

# Or join a network first, then sniffer on that BSS channel
infishark wifi monitor --ssid "YourLabAP" --pass 'secret' --out bss.pcap

5. Host-streamed captive portal

mkdir -p ./pages && echo '<html><body>hello</body></html>' > ./pages/index.html
infishark wifi portal --dir ./pages --ssid LabPortal --random-mac

Connect a phone to LabPortal and open a captive page. The CLI prints request metadata (including User-Agent) and streams HTML from your disk.

6. BLE GATT peek

infishark ble gatt connect # pick from scan, or pass an address
infishark ble gatt enum
infishark ble gatt read <uuid>
infishark ble gatt write <uuid> deadbeef

7. Files

infishark files ls
infishark files pull hs_something.pcap --out ./hs.pcap

When you are done

Long-running tools stop with Ctrl-C and send a device-side stop where applicable. You can also run other commands after the session ends; the OLED returns to normal menus when the host releases the task.

Continue with Wi-Fi, BLE, Portal, IR, or Files.