xref: /libbtbb/python/pcaptools/README (revision e25b118a40ed6b5c2ea76bae29e388cfbc2f6e92)
1This directory contains supplemental tools for working with pcap files produced
2by libbtbb.  (Actually libbtbb doesn't produce such files by itself at this
3time, but you can produce them with the Ubertooth tools.
4
5These tools are not automatically installed as part of the libbtbb
6installation but can be used right out of this directory or manually installed.
7
8pcapdump: a Python module for pcap
9
10Pcapdump us used by btaptap to read and write pcap files.  It should work with
11python 2.4 and above (python 3 support requires using the 2to3 tool).
12
13
14btaptap: a Bluetooth keyboard sniffer
15
16Many Bluetooth keyboards operate by default in "boot mode" which features
17simplified HID messaging that can be interpreted, for example, by a PC BIOS.
18Some of those keyboards also transmit these messages over unencrypted
19Bluetooth.  This tool can be used to extract keystrokes from such
20transmissions.
21