idevicebtlogger(1)

📦 version 1.4.0, in alpine 3.24, arch rolling, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

💖 idevicebtlogger — bestie edition 💖

okay so this is idevicebtlogger, from the General Commands Manual (section 1, commands, you know the drill). she's a little command-line icon and she is here to catch your device's HCI traffic. yes queen. let's go ✨

🌸 NAME 🌸

idevicebtlogger — Capture HCI traffic of a connected device. that's it, that's the job, and she does it flawlessly 💅

🎀 SYNOPSIS 🎀

idevicebtlogger [OPTIONS] <FILE>

🦋 DESCRIPTION 🦋

Capture HCI traffic of a connected device. 🫶

⚠️ real talk though: this requires the Bluetooth logging profile to be installed on device with iOS 13 or higher. no profile, no vibes, no traffic. and for the iOS device configuration situation, go read this:

https://www.bluetooth.com/blog/a-new-way-to-debug-iosbluetooth-applications/

(no cap, that link is literally in the manpage, go check it 👀)

The HCI traffic can be stored in Apple's native PacketLogger format or converted into PCAP format for live feedback in Wireshark. so you can either save it for later or watch it scroll by in real time like it's a group chat you're lurking in 😭

✨ OPTIONS ✨

  • -u, --udid UDID — target specific device by UDID. like @-ing one specific person in the group chat 💜
  • -n, --network — connect to network device. no cable required, we're going wireless bestie 🌈
  • -f, --format FORMAT — set log format: PacketLogger (default), or pcap. pick your aesthetic 🎀
  • -x, --exit — exit when device disconnects. she knows when to leave the party, iconic behavior 👑
  • -d, --debug — enable communication debugging. for when you need to see everything that's being said 💀
  • -h, --help — prints usage information. always read the instructions, bestie 🙈
  • -v, --version — prints version information. gotta know which era we're in ⭐

🧚 EXAMPLES 🧚

Capture HCI traffic of device with UDID 00008030-0000111ABC000DEF:

idevicebtlogger -u 00008030-0000111ABC000DEF

Capture HCI traffic of device and exit when the device is unplugged:

idevicebtlogger -x

Capture HCI traffic of device in PCAP format:

idevicebtlogger -f pcap

Capture HCI traffic and pipe it into Wireshark for live feedback:

idevicebtlogger -f pcap - | wireshark -k -i -

that last one?? the way she pipes straight into Wireshark with -f pcap - | wireshark -k -i -?? literal main character energy, ate, no crumbs 🔥

💜 AUTHORS 💜

  • Geoffrey Kruse
  • Matthias Ringwald

shoutout to the legends, we stan 🫶

🌈 ON THE WEB 🌈

https://libimobiledevice.org

https://github.com/libimobiledevice/libimobiledevice

okay and that's the whole page bestie!! this was the idevicebtlogger(1) page from the General Commands Manual — the footer just says idevicebtlogger(1) again, so consider this your official sign-off: go log some Bluetooth traffic, stay hydrated, and remember that the profile requirement is iOS 13 or higher, periodt 💅💖✨

📦 where this page comes from