# BLE Scanner Library
[![Build and Publish to PyPI](https://github.com/oashaikh/ble-scanner/actions/workflows/python-publish.yml/badge.svg)](https://github.com/oashaikh/ble-scanner/actions/workflows/python-publish.yml)
## Description
This is a Python library for scanning BLE beacon devices. It is built on top of the Bleak library and provides an easy-to-use API for BLE scanning.
## Installation
You can install the package directly from the source code:
python setup.py install
Or, you can use pip for installation:
pip install ble_scanner
## Usage
Here's a quick example:
import asyncio
from ble_scanner.BLEScanner import BLEScanner
def main():
# Create a BLEScanner instance
scanner = BLEScanner(target_mac="E2:15") # Replace the MAC
scanner.initialize()
if __name__ == "__main__":
main()
For more advanced usage, refer to the documentation.
## Requirements
- Python 3.7+
- Bleak
## License
MIT License
## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Raw data
{
"_id": null,
"home_page": "https://github.com/oashaikh/ble-scanner",
"name": "ble-scanner",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "pypi,BLE,python,scanner,beacon",
"author": "Osama Ashaikh",
"author_email": "oashaikh@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/bf/37/a87d888c246bdabd6e4efeab07114fcab833926cd097f7735afbde230064/ble_scanner-1.0.7.tar.gz",
"platform": null,
"description": "\n\n# BLE Scanner Library\n[![Build and Publish to PyPI](https://github.com/oashaikh/ble-scanner/actions/workflows/python-publish.yml/badge.svg)](https://github.com/oashaikh/ble-scanner/actions/workflows/python-publish.yml)\n## Description\n\nThis is a Python library for scanning BLE beacon devices. It is built on top of the Bleak library and provides an easy-to-use API for BLE scanning.\n\n## Installation\n\nYou can install the package directly from the source code:\n\n\n python setup.py install\n\n\nOr, you can use pip for installation:\n\n\n pip install ble_scanner\n\n\n## Usage\n\nHere's a quick example:\n\n\n import asyncio\n from ble_scanner.BLEScanner import BLEScanner\n\n def main():\n # Create a BLEScanner instance\n scanner = BLEScanner(target_mac=\"E2:15\") # Replace the MAC\n scanner.initialize()\n\n if __name__ == \"__main__\":\n main()\n\n\nFor more advanced usage, refer to the documentation.\n\n## Requirements\n\n- Python 3.7+\n- Bleak\n\n## License\n\nMIT License\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n\n",
"bugtrack_url": null,
"license": "",
"summary": "BLE Beacon scanner",
"version": "1.0.7",
"project_urls": {
"Homepage": "https://github.com/oashaikh/ble-scanner"
},
"split_keywords": [
"pypi",
"ble",
"python",
"scanner",
"beacon"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "65051f6b1451c79ac4e5505ce7d42b430b3fe6e7773923be46904a84a3a292f3",
"md5": "1f57a0fff992471b5c362c8dc4d1453c",
"sha256": "33a9d021b3fcf982964f126bda290103d691c4dad225c10bce6553acf51b78ae"
},
"downloads": -1,
"filename": "ble_scanner-1.0.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1f57a0fff992471b5c362c8dc4d1453c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 3310,
"upload_time": "2023-09-11T22:28:53",
"upload_time_iso_8601": "2023-09-11T22:28:53.778533Z",
"url": "https://files.pythonhosted.org/packages/65/05/1f6b1451c79ac4e5505ce7d42b430b3fe6e7773923be46904a84a3a292f3/ble_scanner-1.0.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bf37a87d888c246bdabd6e4efeab07114fcab833926cd097f7735afbde230064",
"md5": "66375cadb69d2df7667567d0ce94caf4",
"sha256": "352dec58777270c9739a666f0d63264dcd4693bb425084c93c5398de525996ec"
},
"downloads": -1,
"filename": "ble_scanner-1.0.7.tar.gz",
"has_sig": false,
"md5_digest": "66375cadb69d2df7667567d0ce94caf4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 2934,
"upload_time": "2023-09-11T22:28:54",
"upload_time_iso_8601": "2023-09-11T22:28:54.772848Z",
"url": "https://files.pythonhosted.org/packages/bf/37/a87d888c246bdabd6e4efeab07114fcab833926cd097f7735afbde230064/ble_scanner-1.0.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-11 22:28:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "oashaikh",
"github_project": "ble-scanner",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ble-scanner"
}