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