[{"_1":2,"_155":-5,"_156":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_134":135},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_125":-5,"_126":11,"_127":17,"_128":11,"_129":-5,"_130":11,"_131":-5,"_132":133},"canonicalUrl","https://hub.docker.com/r/flatline69/pybtble/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","flatline69","reponame","pybtble","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2020-12-30T03:44:34.947181Z","description","Linux amd64 Home Assistant Bluetooth BLE","is_private","last_updated","2021-01-01T18:56:33.521124Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",2296,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","Contains Bluez command line tools and Python. Scans for Bluetooth devices and publishes to MQTT with json payload. Does not support encrypted MQTT and requires functional MQTT endpoint. I use this for Home Assistant but included Bluez tools for troubleshooting. Requires functional Bluetooth in the host operating system. Currently only amd64 builds available.
\n
\nBased on the Python script written by Bit-River on Home Assistant Community forums.
\nImage based on HilscherAutomation/netPI-bluetooth
\n
\nBase image is bitnami/minideb:buster
\nPython 3.7.3 (debian package)
\nPahoMQTT 1.5.1 (pip package)
\nPyBluez 0.41 (pip package)
\nBluepy 1.3.0 (pip package)
\ngattlib 0.20201113 (pip package)
\nBluez 5.54 (compiled from source)
\n
\nScript will scan for:
\n

all visible BLE devices and publish to MQTT with as MQTT_CLIENTID/MAC { addrType, location, rssi }
known Bluetooth devices and publish to MQTT as MQTT_CLIENTID/MAC { name, location }

\naddrType can be \"public\" or \"random\"
\nname is device-provided
\nLocation is always \"home\"
\n
\n
\nDocker Requirements
\n
\nRequires --cap-add=SYS_ADMIN, --cap-add=NET_ADMIN and --net=host
\n
\nThere is a shell in this image as /bin/sh and Bluez command line tools located in /usr/bin
\nFor troubleshooting or pairing bluetooth devices, access shell within container: docker exec -it pybtble /bin/sh
\n
\nEntrypoint is Python script /root/pybtble.py
\n
\nEnvironment
\n\n```\nMQTT_SERVER: IP/FQDN of MQTT broker\nMQTT_PORT: port of MQTT broker above\nMQTT_USER: username for MQTT broker\nMQTT_PASS: password for username above\nMQTT_CLIENTID: MQTT client ID or autogenerated pybtble-[5chars] (ie: pybtble-6bd6b)\nBT_KNOWN_MACS: Quoted, comma-separated list of Bluetooth MAC addresses.\nBLE_PUB_RANDOM: Publish randomized BLE addresses to MQTT. True/False. If not set, defaults to True.\n```\nMQTT_SERVER, MQTT_PORT, MQTT_USER and MQTT_PASS are mandatory values.
\n
\nConfiguring Bluetooth (non-BLE) devices
\n
\nBluetooth devices only can be scanned when in pairing mode which is not useful. This container has the required tools to execute the pairing process below. Do not use this for BLE devices which are passively scanned. Once paired with your BT dongle/controller, a direct name lookup to the device will succeed when the device is in range.
\n
\nPut your BT device into pairing mode and then pair it to your BT dongle/controller by executing the following within the container:\n\n```\nNEW METHOD:\n# bluetoothctl\n# power on\n# agent on\n# default-agent\n# scan on\n\n# pair 11:11:11:11:11:11\n\n# scan off\n# exit\n\nOLD METHOD:\n# hcitool cc 11:11:11:11:11:11 \n# hcitool auth 11:11:11:11:11:11 \n# hcitool dc 11:11:11:11:11:11 \n```\nWhere 11:11:11:11:11:11 is the MAC address of the Bluetooth device. On Android devices you'll need to be in Bluetooth Settings to see the pair request. On Apple devices, a dialog should pop up regardless of which screen you're in. Accept the pair request and you can then scan for the device using this container. Device names are encoded/decoded as ASCII to overcome the apparent Unicode strings presented by Apple devices.
\n
\nThe Bluetooth devices configured here should then be added to the BT_KNOWN_MACS docker environment variable.
\n
\nHome Assistant
\n
\nWhile you can use the MQTT data for device_tracker in Home Assistant, in my config, I use it as a binary_sensor instead:
\n\n```\n***NOTE***\n\nNewer versions of Home Assistant have deprecated binary_sensor definition of MQTT sensors and\nnow is placed under the MQTT integration:\n\nmqtt:\n binary_sensor:\n - name: Bluetooth Device\n state_topic: \"pybtble/11:11:11:11:11:11\"\n payload_on: \"home\"\n value_template: '{{ value_json.location }}'\n off_delay: 180\n qos: 0\n\nDEPRECATED USAGE:\n\nbinary_sensor:\n - platform: mqtt\n name: Bluetooth Device\n state_topic: \"pybtble/11:11:11:11:11:11\"\n payload_on: \"home\"\n value_template: '{{ value_json.location }}'\n off_delay: 180\n qos: 0\n```\nDocker Compose
\n\n```\nservices:\n pybtble:\n container_name: pybtble\n image: flatline69/pybtble:latest\n environment:\n MQTT_SERVER: \"172.20.10.100\"\n MQTT_PORT: \"1883\"\n MQTT_USER: \"username\"\n MQTT_PASS: \"password\"\n MQTT_CLIENTID: \"pybtble\"\n BT_KNOWN_MACS: \"11:11:11:11:11:11,22:22:22:22:22:22,33:33:33:33:33:33\"\n BLE_PUB_RANDOM: \"false\"\n restart: unless-stopped\n network_mode: host\n cap_add:\n - SYS_ADMIN\n - NET_ADMIN\n\n```\nLogging Output
\n\n```\nFound BLE device: a4:c1:38:55:d5:c0\nFound BLE device: a4:c1:38:b4:20:2c\nScanning for BT devices...\nFound known BT device: 11:11:11:11:11:11\nFound known BT device: 22:22:22:22:22:22\nFound known BT device: 33:33:33:33:33:33\nFound BLE device: 54:bd:79:0e:90:9b\nFound randomized BLE device: 7f:be:af:b3:de:e3 - not published\nFound BLE device: d0:03:df:ed:ce:1f\nFound BLE device: 68:72:c3:03:9c:6b\nFound randomized BLE device: 53:d5:b3:03:a7:d1 - not published\nFound BLE device: 9c:20:7b:e6:8b:14\n```\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",204089374,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},"content_type","creator",11613643,"full_size",50339914,"id",131620579,"images",[97],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},"architecture","amd64","digest","sha256:4601dd438d2a40389780a990daf423edcc6464d505616f40dd04cb774fde42db","features","","last_pulled","2026-09-23T04:00:06.446095618Z","last_pushed","2021-01-01T18:56:34Z","os","linux","os_features","os_version","size","variant","2021-01-01T18:56:33.229519Z","last_updater","last_updater_username","media_type","latest","repository",10583730,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":136,"_143":144,"_132":153,"_154":11},{"_36":137,"_38":138,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":139,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":140,"_75":11,"_76":142,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":141},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_145":60,"_146":-5,"_147":-5,"_148":149},"count","next","previous","results",[150],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":151,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},[152],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

flatline69/pybtble

Tags for flatline69/pybtble