BTSCANNER(1)

📦 version 2.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ btscanner(1) — the General Commands Manual glow-up ✨

okay so bestie, welcome to btscanner, the ncurses-based scanner for Bluetooth devices 🦋 this is a real manual page, section 1 of the General Commands Manual, and we're gonna walk through it together like it's a group chat at 2am. stay with me, it's giving iconic 👑

🌸 NAME 🌸

btscanner — an ncurses-based scanner for Bluetooth devices. that's the whole vibe. she scans, she's in your terminal, she's text-mode and unbothered 💅

✨ SYNOPSIS ✨

btscanner [--help] [--cfg <file>] [--no-reset]

that's it. that's the whole summoning ritual 🎀

💖 DESCRIPTION 💖

okay first things first, some lore 📖 this manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page. not me writing a whole manpage for someone else's program, no cap 😭

so what does btscanner actually do? she's a tool designed specifically to extract as much information as possible from a Bluetooth device without the requirement to pair 🔥 read that again. no pairing. she just shows up, gets the tea, and leaves. main character energy fr fr.

there's a detailed information screen that extracts HCI and SDP information, and she keeps an open connection going so she can monitor the RSSI and the link quality in real time. it's giving surveillance but make it cute 🙈

under the hood she's based on the BlueZ Bluetooth stack (which is included with recent Linux kernels) plus the BlueZ toolset. and because she's extra, she also contains a complete listing of the IEEE OUI numbers and class lookup tables ⭐

so, using all the info she gathers from these sources, it is possible to make educated guesses as to the host device type. educated guesses!! she's smart, she's guessing, she's usually right 💅

🎀 OPTIONS 🎀

  • --help — shows a help text and then exits. the classic. she's helping and she's leaving 🫶
  • --cfg <file> — use <file> as the config file. tell her which config to read, bestie 📄
  • --no-reset — do not reset the Bluetooth adapter before scanning. you're telling her to skip the reset, so be aware of what you're asking for 💀

😭 BUGS 😭

found a bug? please report any bugs to Tim Hurman <tim.hurman@pentest.co.uk>. he wants to know. tell him. respectfully 🍓

👑 LICENCE 👑

btscanner is covered by the GNU General Public License (GPL). free software, iconic behaviour, periodt ✨

🦋 SEE ALSO 🦋

kismet(1) — another one. go read her too, she's also that girl 🌈

💜 AUTHORS 💜

Tim Hurman <tim.hurman@pentest.co.uk>

this manual page was written by Uwe Hermann <uwe@hermann-uwe.de>, for the Debian GNU/Linux system (but may be used by others). okay so not gatekept, we love that 🫶

quick reminder bestie: every flag, every file, every email, every license line stays exactly where it is. the vibe is new, the facts are untouched 💖

and that's the whole page!! this beauty is from April 22, 2006, part of the General Commands Manual, filed under btscanner(1) — mwah, slay, go scan something 💅✨

📦 where this page comes from