bazhenov / blendr

The hacker's BLE (bluetooth low energy) browser terminal app

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

blendr

Mood: Blue Crates.io (version) Crates.io

Blendr is a terminal UI app for browsing BLE (Bluetooth Low Energy) devices. It allows you to inspect, search, connect, and analyze data coming from BLE devices directly from your terminal.

It was designed for day-to-day use by BLE engineers so the core features are useful search, direct connection to any characteristic and device with one command, and displaying your custom services names in the UI. Learn more

demo

And it's just perfect to hack your neighbor's toothbrush 😉

Installation

Cargo cli

cargo install blendr

For Unix OS you can run the following, it will install the binary for your system and provide man reference.

curl --proto '=https' --tlsv1.2 -sLSf "https://github.com/dmtrKovalenko/blendr/blob/main/install.sh?raw=true" | sh

For windows, it is required to download and run binary executable directly. Open latest release page and download binary executable for your OS

Prerequisits

MacOS

To use Bluetooth on MacOS Big Sur (11) or later, you need to either package your binary into an application bundle with an Info.plist including NSBluetoothAlwaysUsageDescription, or (for a command-line application such as the examples included with btleplug) enable the Bluetooth permission for your terminal. You can do the latter by going to System Preferences → Security & Privacy → Privacy → Bluetooth, clicking the '+' button, and selecting 'Terminal' (or iTerm or whichever terminal application you use).

Bluetooth settings screenshot

Usage

Get the help information with either man blendr or blendr --help it will print all the available options and characteristics. To get started and learn about the biggest features watch this 2 minutes demo:

video preview

License

This project is licensed under the terms of BSD-3-Clause license

About

The hacker's BLE (bluetooth low energy) browser terminal app

License:BSD 3-Clause "New" or "Revised" License


Languages

Language:Rust 96.8%Language:Shell 3.2%