idevicebtlogger(1)

Usage

idevicebtlogger [OPTIONS] <FILE>

Overview

Capture HCI traffic of a connected device. Requires Bluetooth logging profile to be installed on device with iOS 13 or higher. See https://www.bluetooth.com/blog/a-new-way-to-debug-iosbluetooth-applications/ for iOS device configuration.

The HCI traffic can be stored in Apple's native PacketLogger format or converted into PCAP format for live feedback in Wireshark.

Options

-u, --udid UDID: target specific device by UDID

-n, --network: connect to network device

-f, --format FORMAT: set log format: PacketLogger (default), or pcap

-x, --exit: exit when device disconnects

-d, --debug: enable communication debugging

-h, --help: prints usage information

-v, --version: prints version information.

Examples

`idevicebtlogger -u 00008030-0000111ABC000DEF`	Capture HCI traffic of device with UDID 00008030-0000111ABC000DEF.
`idevicebtlogger -x`	Capture HCI traffic of device and exit when the device is unplugged.
`idevicebtlogger -f pcap`	Capture HCI traffic of device in PCAP format.
`idevicebtlogger -f pcap - \| wireshark -k -i -`	Capture HCI traffic and pipe it into Wireshark for live feedback.

On the web

https://libimobiledevice.org

https://github.com/libimobiledevice/libimobiledevice