Skip to content

Linterz/BleScanner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 

Repository files navigation

BleScanner

An Android app for Bluetooth Low Energy (BLE) scanning and sniffing with location capabilities.

Demo Videos

BleScanner Sniffer Demo

a.mp4
untitled.mp4

Features

  • Bluetooth Scanner: Discover and scan nearby BLE devices
  • Bluetooth Sniffer: Capture BLE traffic with location data
  • Apple Continuity Data: Decrypts Apple Bluetooth Protocol
  • Data Export: Export sniffed data for further analysis
  • Integration: Seamless integration with BleMapper web tool

Getting Started

Scanner View (Default)

The app launches in scanner view by default, allowing you to discover nearby BLE devices.

Sniffer View

Switch to sniffer view by tapping the map icon in the top bar. This mode captures BLE addresses with their data and associates it with location data.

Data Export & Analysis

Exporting Data

  1. Navigate to Sniffer view
  2. Tap the gears icon (settings)
  3. Select "Export Data as CBOR"

Importing to BleMapper

For advanced analysis and search capabilities, use the exported data with BleMapper:

  1. Go to BleMapper
  2. Click "Import Data" button (top right)
  3. Select or drag your exported CBOR file

BleMapper provides enhanced search options and controls for analyzing your BLE data.

Installation

  1. Download the APK
  2. Grant precise location and nearby device scan permissions

Requirements

  • Android 12+
  • Location permissions (for BLE scanning)
  • Bluetooth permissions

Data and Privacy concerns

This suite of apps does not collect any of your personal data (e.g., location and Bluetooth), everything is done on the device like exporting and importing CBOR files.

Credits

  • This project is inspired by rfparty, but I was unable to build from source, so I created my own version with quality of life improvements
  • Apple Continuity data decryption based on furiousMAC/continuity

About

Scans and maps Bluetooth devices

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors