# NeoSmartBlue Python Library
A Python library for controlling Neo Smart Blinds via BlueLink Bluetooth connection.
## Installation
```bash
pip install neosmartblue.py
```
## Usage
### Scanning for devices and reading status from advertisements
```python
import asyncio
from neosmartblue.py import scan_for_devices
async def main():
# Scan for nearby Neo Smart Blinds devices
devices = await scan_for_devices(timeout=15.0)
if not devices:
print("No devices found.")
return
for device in devices:
print(f"Device Address: {device['address']}")
print(f"Device Name: {device['name']}")
print("Status:")
for key, value in device['status'].items():
print(f" {key}: {value}")
print()
asyncio.run(main())
```
### Controlling a device
```python
import asyncio
from neosmartblue.py import BlueLinkDevice
async def main():
# Replace with your device's MAC address
device = BlueLinkDevice("XX:XX:XX:XX:XX:XX")
# Connect to the device
await device.connect()
try:
# Move blinds to 50% closed position
await device.move_to_position(50)
# Stop movement if needed
# await device.stop()
finally:
# Disconnect from device
await device.disconnect()
asyncio.run(main())
```
Raw data
{
"_id": null,
"home_page": null,
"name": "neosmartblue.py",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.14,>=3.13",
"maintainer_email": null,
"keywords": "bluetooth, ble, smart blinds, neo, home automation",
"author": "ikifar2012",
"author_email": "ikifar2012@users.noreply.github.com",
"download_url": "https://files.pythonhosted.org/packages/a0/13/15287fa0db00d56682e8f34fa085afbd6df9e97bace7c63e5e7e7a84093a/neosmartblue_py-0.1.3.tar.gz",
"platform": null,
"description": "# NeoSmartBlue Python Library\n\nA Python library for controlling Neo Smart Blinds via BlueLink Bluetooth connection.\n\n## Installation\n\n```bash\npip install neosmartblue.py\n```\n\n## Usage\n\n### Scanning for devices and reading status from advertisements\n\n```python\nimport asyncio\nfrom neosmartblue.py import scan_for_devices\n\nasync def main():\n # Scan for nearby Neo Smart Blinds devices\n devices = await scan_for_devices(timeout=15.0)\n if not devices:\n print(\"No devices found.\")\n return\n \n for device in devices:\n print(f\"Device Address: {device['address']}\")\n print(f\"Device Name: {device['name']}\")\n print(\"Status:\")\n for key, value in device['status'].items():\n print(f\" {key}: {value}\")\n print()\n\n\nasyncio.run(main())\n```\n\n### Controlling a device\n\n```python\nimport asyncio\nfrom neosmartblue.py import BlueLinkDevice\n\nasync def main():\n # Replace with your device's MAC address\n device = BlueLinkDevice(\"XX:XX:XX:XX:XX:XX\")\n \n # Connect to the device\n await device.connect()\n \n try:\n # Move blinds to 50% closed position\n await device.move_to_position(50)\n \n # Stop movement if needed\n # await device.stop()\n \n finally:\n # Disconnect from device\n await device.disconnect()\n\nasyncio.run(main())\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "A Python library for controlling Neo Smart Blinds via BlueLink Bluetooth connection",
"version": "0.1.3",
"project_urls": {
"Homepage": "https://github.com/ikifar2012/neosmartblue.py",
"Issues": "https://github.com/ikifar2012/neosmartblue.py/issues",
"Repository": "https://github.com/ikifar2012/neosmartblue.py"
},
"split_keywords": [
"bluetooth",
" ble",
" smart blinds",
" neo",
" home automation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "517b1e2eb3128fb8a8280fc8d3c4df4a19601b14fc7ecbe34d60def05f23b5ed",
"md5": "6f19d754dc0529c2aa540e9a0a55e883",
"sha256": "bc151a02d404c042c2c9c5bdf51d2cb8eeead4dbb5bedc7e6158bcddc0939a28"
},
"downloads": -1,
"filename": "neosmartblue_py-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6f19d754dc0529c2aa540e9a0a55e883",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.14,>=3.13",
"size": 6886,
"upload_time": "2025-08-14T21:08:27",
"upload_time_iso_8601": "2025-08-14T21:08:27.113762Z",
"url": "https://files.pythonhosted.org/packages/51/7b/1e2eb3128fb8a8280fc8d3c4df4a19601b14fc7ecbe34d60def05f23b5ed/neosmartblue_py-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a01315287fa0db00d56682e8f34fa085afbd6df9e97bace7c63e5e7e7a84093a",
"md5": "a5c9a7faa225491a0c05968fe26ee994",
"sha256": "3e82a637d28513f5f3c966a46cff49bcacff8f848b5f349b40a00a2c976f083d"
},
"downloads": -1,
"filename": "neosmartblue_py-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "a5c9a7faa225491a0c05968fe26ee994",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.14,>=3.13",
"size": 4889,
"upload_time": "2025-08-14T21:08:28",
"upload_time_iso_8601": "2025-08-14T21:08:28.222677Z",
"url": "https://files.pythonhosted.org/packages/a0/13/15287fa0db00d56682e8f34fa085afbd6df9e97bace7c63e5e7e7a84093a/neosmartblue_py-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-14 21:08:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ikifar2012",
"github_project": "neosmartblue.py",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "neosmartblue.py"
}