{"id":28240,"library":"spotled","title":"SPOTLED","description":"Unofficial Python library for controlling SPOTLED Bluetooth LED displays. Supports text, images, animations, and real-time updates. Current version: 1.3.0, release cadence: irregular.","status":"active","version":"1.3.0","language":"python","source_language":"en","source_url":"https://github.com/iwalton3/python-spotled","tags":["spotled","bluetooth","led-display","iot"],"install":[{"cmd":"pip install spotled","lang":"bash","label":"pip install"}],"dependencies":[],"imports":[{"note":"","wrong":"","symbol":"SpotledClient","correct":"from spotled import SpotledClient"},{"note":"","wrong":"","symbol":"SpotledDiscovery","correct":"from spotled import SpotledDiscovery"}],"quickstart":{"code":"from spotled import SpotledDiscovery, SpotledClient\n\n# Discover devices\ndiscovery = SpotledDiscovery()\ndevices = discovery.discover(timeout=3)\nif not devices:\n    print('No devices found')\nelse:\n    # Connect to first device\n    device = devices[0]\n    client = SpotledClient(device.address, device.name)\n    client.connect()\n    client.send_text('Hello SPOTLED!')\n    client.disconnect()","lang":"python","description":"Discover a SPOTLED device and send text."},"warnings":[{"fix":"Install bluez (sudo apt install bluez) and add user to bluetooth group (sudo usermod -a -G bluetooth $USER).","message":"Bluetooth adapter must support BLE (Bluetooth Low Energy). On Linux, ensure bluez is installed and user has permissions.","severity":"gotcha","affected_versions":"all"},{"fix":"Disconnect any other Bluetooth connections to the device before running discovery.","message":"Device discovery may fail if the device is already connected to another host (e.g., mobile app). Ensure device is disconnected before scanning.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Ensure system has BLE-capable Bluetooth adapter and necessary drivers (e.g., bluez on Linux).","cause":"No Bluetooth adapter or BLE not supported/available.","error":"bleak.exc.BleakError: No BLE adapter found"},{"fix":"Move closer to device and ensure no other app is connected to the SPOTLED display.","cause":"Device not in range or already connected to another client.","error":"spotled.exceptions.SpotledException: Failed to connect: Connection refused"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}