---
name: "idevicebtlogger"
section: "1"
platform: "linux"
package: "libimobiledevice"
version: "1.4.0-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/idevicebtlogger"
---

# idevicebtlogger(1)

Capture HCI traffic of a connected device.

## NAME

idevicebtlogger - Capture HCI traffic of a connected device.

## SYNOPSIS

**idevicebtlogger** \[OPTIONS\] \<FILE\>

## 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.

## 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.

## AUTHORS

Geoffrey Kruse

Matthias Ringwald

## ON THE WEB

https://libimobiledevice.org

https://github.com/libimobiledevice/libimobiledevice