.TH "idevicebtlogger" 1
.SH NAME
idevicebtlogger \- Capture HCI traffic of a connected device.
.SH SYNOPSIS
.B idevicebtlogger
[OPTIONS]
<FILE>

.SH DESCRIPTION

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. 

.SH OPTIONS
.TP
.B \-u, \-\-udid UDID
target specific device by UDID
.TP
.B \-n, \-\-network
connect to network device
.TP
.B \-f, \-\-format FORMAT
set log format: PacketLoggger (default), or pcap
.TP
.B \-x, \-\-exit
exit when device disconnects
.TP
.B \-d, \-\-debug
enable communication debugging
.TP
.B \-h, \-\-help
prints usage information
.TP
.B \-v, \-\-version
prints version information.

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

.SH AUTHORS
Geoffrey Kruse
Matthias Ringwald

.SH ON THE WEB
https://libimobiledevice.org

https://github.com/libimobiledevice/libimobiledevice