{"id":28892827,"url":"https://github.com/cybernilsen/cyberble","last_synced_at":"2026-05-14T13:36:09.341Z","repository":{"id":300294305,"uuid":"1005690164","full_name":"CyberNilsen/CyberBLE","owner":"CyberNilsen","description":"CyberBLE is a comprehensive Bluetooth Low Energy (BLE) scanning and analysis tool with an intuitive GUI. It discovers nearby BLE devices and provides detailed information about their characteristics, including vendor identification, device types, services, and manufacturer data.","archived":false,"fork":false,"pushed_at":"2025-06-20T21:49:37.000Z","size":34,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-20T22:32:02.713Z","etag":null,"topics":["ble","bluetooth-low-energy","gui","json","mac-address","python","scanner"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CyberNilsen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-20T16:34:43.000Z","updated_at":"2025-06-20T21:49:40.000Z","dependencies_parsed_at":"2025-06-20T22:32:04.809Z","dependency_job_id":"8c17b3e2-98c2-4731-9622-69dfef91a982","html_url":"https://github.com/CyberNilsen/CyberBLE","commit_stats":null,"previous_names":["cybernilsen/cyberble"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CyberNilsen/CyberBLE","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyberNilsen%2FCyberBLE","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyberNilsen%2FCyberBLE/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyberNilsen%2FCyberBLE/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyberNilsen%2FCyberBLE/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CyberNilsen","download_url":"https://codeload.github.com/CyberNilsen/CyberBLE/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyberNilsen%2FCyberBLE/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261050697,"owners_count":23102556,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ble","bluetooth-low-energy","gui","json","mac-address","python","scanner"],"created_at":"2025-06-21T02:06:44.931Z","updated_at":"2025-10-27T17:10:38.589Z","avatar_url":"https://github.com/CyberNilsen.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CyberBLE\n\nAdvanced BLE Device Profiler \u0026 Analyzer\n\n## Overview\n\nCyberBLE is a comprehensive Bluetooth Low Energy (BLE) scanning and analysis tool with an intuitive GUI. It discovers nearby BLE devices and provides detailed information about their characteristics, including vendor identification, device types, services, and manufacturer data.\n\n![CyberBLE](https://github.com/user-attachments/assets/928c643b-1a2e-43d6-b8ef-e5ffc999f722)\n\nMac adresses are hid for privacy reasons\n\n\n## Features\n\n- **Quick Offline Scan** - Fast BLE device discovery using local databases\n- **Deep Online Scan** - Enhanced scanning with online vendor lookup\n- **Continuous Monitoring** - Real-time device tracking with live updates\n- **Device Profiling** - Automatic device type detection and classification\n- **Vendor Identification** - MAC address to vendor mapping\n- **Service Analysis** - BLE service UUID identification and parsing\n- **Manufacturer Data** - Detailed manufacturer-specific data analysis\n- **Export Functionality** - Save scan results to JSON format\n- **User-Friendly Interface** - Clean, professional GUI with detailed device information\n\n## Requirements\n\n### Data Files (Optional)\n- `mac_vendors.json` - MAC address to vendor mapping\n- `manufacturer_ids.json` - BLE manufacturer ID database\n- `service_uuids.json` - BLE service UUID definitions\n\n## Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/CyberNilsen/CyberBLE\ncd CyberBLE\n```\n\n2. Install required dependencies:\n```bash\npip install -r requirements.txt\n```\n\n3. Run the application:\n```bash\npython main.py\n```\n\n## Usage\n\n### Basic Scanning\n1. **Quick Scan (Offline)** - Uses local databases for fast device identification\n2. **Deep Scan (Online)** - Performs online vendor lookups for enhanced accuracy\n3. **Continuous Scan** - Monitors devices in real-time with automatic updates\n\n### Features\n- **Double-click** any device in the list to view detailed information\n- **Click column headers** to get explanations of each data field\n- **Enhance Vendors** button performs online lookups for unknown vendors\n- **Export Results** saves all discovered devices to a timestamped JSON file\n- **Clear Results** removes all devices from the current view\n\n### Device Information Displayed\n- **MAC Address** - Hardware identifier\n- **Name** - Device name or detected identifier\n- **Type** - Classified device category\n- **Vendor** - Manufacturer based on MAC lookup\n- **Manufacturer ID** - BLE advertisement manufacturer data\n- **Services** - Available BLE services\n- **RSSI** - Signal strength indicator\n- **Last Seen** - Time of last detection\n\n## Device Types Detected\n\nThe tool automatically classifies devices into categories:\n- Apple devices (iPhone, iPad, AirPods, etc.)\n- Samsung devices (Galaxy series, etc.)\n- Fitness trackers (Fitbit, Garmin, etc.)\n- Audio devices (Beats, JBL, Sony, Bose, etc.)\n- Gaming devices (Nintendo, Xbox, etc.)\n- Smart home devices (Google, Tesla, etc.)\n- Input devices (keyboards, mice, etc.)\n\n## Data Files Format\n\n### mac_vendors.json\n```json\n{\n  \"001122\": \"Apple, Inc.\",\n  \"AABBCC\": \"Samsung Electronics Co.,Ltd\"\n}\n```\n\n### manufacturer_ids.json\n```json\n{\n  \"004C\": \"Apple, Inc.\",\n  \"0075\": \"Samsung Electronics Co. Ltd.\"\n}\n```\n\n### service_uuids.json\n```json\n{\n  \"180d\": \"Heart Rate\",\n  \"180f\": \"Battery Service\"\n}\n```\n\n## Export Format\n\nResults are exported as JSON with the following structure:\n```json\n{\n  \"scan_info\": {\n    \"timestamp\": \"2025-01-15T10:30:00\",\n    \"device_count\": 5,\n    \"tool\": \"CyberBLE\"\n  },\n  \"devices\": [\n    {\n      \"mac\": \"AA:BB:CC:DD:EE:FF\",\n      \"name\": \"iPhone\",\n      \"type\": \"Apple\",\n      \"vendor\": \"Apple, Inc.\",\n      \"manufacturer_id\": \"0x004C (Apple, Inc.)\",\n      \"services\": \"Generic Access (1800)\",\n      \"rssi\": \"-45\",\n      \"last_seen\": \"10:30:15\"\n    }\n  ]\n}\n```\n\n## System Requirements\n\n- **Operating System**: Windows, macOS, or Linux\n- **Python**: 3.7 or higher\n- **Bluetooth**: BLE-capable Bluetooth adapter\n- **Permissions**: May require administrator/root privileges on some systems\n\n## Troubleshooting\n\n### Common Issues\n- **No devices found**: Check if Bluetooth is enabled and BLE adapter is working\n- **Permission errors**: Run as administrator/root if required\n- **Slow scanning**: Move closer to target devices or check for interference\n- **Online lookup fails**: Check internet connection\n\n### Platform-Specific Notes\n- **Linux**: May need to run with `sudo` for BLE access\n- **Windows**: Ensure Windows 10 version 1903 or later for best BLE support\n- **macOS**: Grant Bluetooth permissions when prompted\n\n## Contributing\n\nContributions are welcome! Please feel free to submit pull requests or open issues for bugs and feature requests.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n## Disclaimer\n\nThis tool is intended for educational and authorized testing purposes only. Users are responsible for complying with local laws and regulations regarding wireless device scanning and analysis.\n\n## Author\n\nCyberBLE © 2025 by CyberNilsen  \nEnhanced BLE Analysis \u0026 Device Profiling\n\n---\n\n**Note**: This tool performs passive BLE scanning and does not connect to or interact with discovered devices.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcybernilsen%2Fcyberble","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcybernilsen%2Fcyberble","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcybernilsen%2Fcyberble/lists"}