https://github.com/akurtz87/bluetooth-data-scanner-analyzer
https://github.com/akurtz87/bluetooth-data-scanner-analyzer
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/akurtz87/bluetooth-data-scanner-analyzer
- Owner: AKurtz87
- Created: 2023-06-12T19:55:02.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-06-24T13:33:34.000Z (almost 2 years ago)
- Last Synced: 2025-02-13T19:39:19.296Z (4 months ago)
- Language: JavaScript
- Size: 63.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Bluetooth Data Scanner & Analyzer
Bluetooth Data Scanner & Analyzer is a solution designed to detect, log, and perform operations on Bluetooth devices data collected.
## Features
+ **Bluetooth Scanning:** The application can scan all Bluetooth devices in the area using the `02.1_scan.js` script.
+ **Data Collection & Storage:** The application saves all the scanned data in a single-line JSON file, which is suitable for big data operations.
+ **Data Import to SQLite Database:** You can run the `02.2_fromJsonToDB.js` script to import this single-line JSON data into a SQLite database.
+ **HTTP Server and Data Visualization:** By launching the `01_main.js` script, you can start an HTTP server and visualize and perform operations on the collected
## Installation
To install and get the Bluetooth Data Scanner & Analyzer up and running, follow these steps:
1. Clone the repository from GitHub:
>`https://github.com/AKurtz87/Bluetooth-Data-Scanner-Analyzer.git`
2. Navigate to the project's directory and install the required dependencies by running:
>`npm install`
3. Run the following script to capture Bluetooth devices data and create the single-line JSON data:
>`02.1_scan.js`
4. Run the following script to import the single-line JSON data into your SQLite database:
>`node 02.2_fromJsonToDB.js`
5. To start the application server, use:
>`node 01_main.js`
You can then access the application by navigating to http://localhost:3000 (or whichever port you've set) in your web browser.
## Usage
Once the application is installed and running, the following steps outline the typical workflow:
1. The application begins scanning for all Bluetooth devices in the area and collects data.
2. All the collected data gets stored in a single-line JSON file, optimized for big data operations.
4. You can then run the `02.2_fromJsonToDB` script to import the data from the JSON file into a SQLite database.
5. With the HTTP server running (triggered by `01_main.js`), you can visualize and perform operations on the collected Bluetooth data through the web interface.
+ **Owner Association:** On the main page, you can associate the UUID of a Bluetooth device with its owner (which could be a person, piece of equipment, or any other entity with a Bluetooth device).
+ **Owner-Specific Data Page:** A separate page allows you to view only the data associated with a specific owner.
+ **Comprehensive Data List Page:** Another page lists all the collected data in a single, accessible format.
## Contributing
We welcome contributions to the Bluetooth Data Scanner & Analyzer! If you encounter any issues or have suggestions for improvements, please submit them as GitHub issues in the repository. You may also fork the repository, make your changes, and submit a pull request for review. Please ensure that your contributions align with the project's coding conventions and follow the established guidelines.