{"id":25321431,"url":"https://github.com/dev-diaries41/bluetracker","last_synced_at":"2025-04-07T21:35:53.786Z","repository":{"id":277057379,"uuid":"930896545","full_name":"dev-diaries41/bluetracker","owner":"dev-diaries41","description":"The BlueTracker CLI tool allows users to scan for Bluetooth devices, connect to them, track their location, and retrieve history data. ","archived":false,"fork":false,"pushed_at":"2025-02-20T12:20:01.000Z","size":93,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-20T13:27:05.371Z","etag":null,"topics":["bluetooth","cli","iot","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/dev-diaries41.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}},"created_at":"2025-02-11T11:46:59.000Z","updated_at":"2025-02-20T12:20:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"443c3012-3c94-4500-a8cb-dfbd0d91b82d","html_url":"https://github.com/dev-diaries41/bluetracker","commit_stats":null,"previous_names":["dev-diaries41/bluetracker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dev-diaries41%2Fbluetracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dev-diaries41%2Fbluetracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dev-diaries41%2Fbluetracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dev-diaries41%2Fbluetracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dev-diaries41","download_url":"https://codeload.github.com/dev-diaries41/bluetracker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247733114,"owners_count":20986999,"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":["bluetooth","cli","iot","rust"],"created_at":"2025-02-13T22:53:43.066Z","updated_at":"2025-04-07T21:35:53.774Z","avatar_url":"https://github.com/dev-diaries41.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BlueTracker CLI Tool\n\n## Table of Contents\n1. [Introduction](#introduction)\n2. [Installation](#installation)\n3. [Usage](#usage)\n4. [Global Tracking \u0026 GPS Integration](#global-tracking--gps-integration)\n5. [Database](#database)\n6. [License](#license)\n\n## Introduction\nThe BlueTracker CLI tool allows users to scan for Bluetooth devices, connect to them, track their location, and retrieve history data. The tool integrates SQLite for persistent storage of Bluetooth device detections.\nHere's the updated **Installation** section with the quick installation method included:\n\n---\n\n## Installation\n\n### Option 1: Manual Installation\n1. Clone the repository:\n   ```sh\n   git clone https://github.com/dev-diaries41/bluetracker.git\n   cd bluetracker\n   ```\n2. Install dependencies:\n   ```sh\n   cargo build --release\n   ```\n3. Run the tool:\n   ```sh\n   ./target/release/bluetracker --help\n   ```\n\n### Option 2: Quick Installation (Using Install Script)\n1. Clone the repository:\n   ```sh\n   git clone https://github.com/dev-diaries41/bluetracker.git\n   cd bluetracker\n   ```\n2. Make the install script executable:\n   ```sh\n   chmod 755 install.sh\n   ```\n3. Run the install script:\n   ```sh\n   ./install.sh\n   ```\n4. Run the tool:\n   ```sh\n   blet --help\n   ```\n\n---\n\n## Usage\n\n**`blet \u003cCOMMAND\u003e`**\n\n### Commands:\n- **scan**: Scan for Bluetooth devices\n- **connect**: Connect to a Bluetooth device by address\n- **location**: Get the last known location of a device\n- **nearby**: Find nearby devices within a given radius\n- **history**: Get the detection history of a device\n- **devices**: Get the detection history of a device\n- **brand**: Find the manufacturer name\n- **help**: Print this message or the help of the given subcommand(s)\n\n### Options:\n- `-h`, `--help`: Print help\n- `-V`, `--version`: Print version\n\n---\n\n## Global Tracking \u0026 GPS Integration\nTo enable **global tracking**, BlueTracker includes **GPS coordinates** with each scan, allowing:\n\n✅ Tracking **where** devices were detected.  \n✅ Identifying **movement patterns** of frequent devices.  \n✅ Implementing **geo-fencing** for businesses or security use cases.  \n\n---\n\n### Example Use Cases\n🔵 **Retail Stores** → Track the number of new vs. returning customers.  \n🔵 **Traffic Analytics** → Monitor Bluetooth signals from cars \u0026 phones to analyze congestion.  \n🔵 **Security** → Identify unknown devices in **restricted areas**.  \n🔵 **Lost \u0026 Found** → Track last seen **locations** of devices over time.  \n\n---\n\n\n## Database\nThe tool uses an SQLite database to store scan results and history.\n\n## License\nThis project is licensed under the MIT License.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdev-diaries41%2Fbluetracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdev-diaries41%2Fbluetracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdev-diaries41%2Fbluetracker/lists"}