{"repo":"Viktopia/sonar","free":true,"listed":false,"github":"https://github.com/Viktopia/sonar","clone":"git clone https://github.com/Viktopia/sonar.git","description":"Google Analytics for the real world.","language":"Python","stars":84,"topics":["raspberry-pi","people-counter","ble","bluetooth","analytics"],"license":null,"category":"analytics","readme_excerpt":"Sonar - BLE Device Counter A FastAPI-based service for counting and analyzing Bluetooth Low Energy (BLE) devices in proximity. This service provides detailed statistics about nearby BLE devices, including manufacturer identification and device type classification. 📋 Features - Real-time BLE device scanning and counting - Manufacturer identification using Nordic Semiconductor's database - iOS device detection - Time-series data collection and analysis - Historical data persistence - RESTful API endpoints for data access - Docker support with persistent storage 🚀 Quick Start Prerequisites - Python 3.11+ - BlueZ (Linux Bluetooth stack) - Bluetooth hardware with BLE support - Proper permissions to access Bluetooth (usually requires root or special capabilities) Installation 1. Clone the repository: 2. Choose your installation method: Docker (Recommended) Local Installation 3. Verify Installation: Note: This project is primarily designed to run on a Raspberry Pi but works on any BlueZ-compatible Linux device with proper Bluetooth permissions. 🛠️ Development Local Development Setup 1. Install dependencies: 2. Run the development server: Running Tests 📡 API Documentation Endpoints GET /latest Returns the most recent scan results and historical statistics. Response: GET /time-series Get time series data for the last 24 hours. Query Parameters: - interval minutes : Time interval between data points (default: 60, min: 1, max: 1440) Response: GET /health Health check endpoint. Respo","default_branch":null,"files":null,"tree":[],"storefront":"/r/Viktopia","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/Viktopia/sonar/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}