{"id":24382938,"url":"https://github.com/magcode/mqtt-bluetooth-remote","last_synced_at":"2026-04-20T08:32:34.906Z","repository":{"id":263870132,"uuid":"891644857","full_name":"magcode/mqtt-bluetooth-remote","owner":"magcode","description":null,"archived":false,"fork":false,"pushed_at":"2026-01-04T20:05:33.000Z","size":18,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-09T10:54:36.368Z","etag":null,"topics":["bluetooth","home-automation","mqtt","rmf-tx621e"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/magcode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-11-20T17:41:55.000Z","updated_at":"2026-01-04T20:05:37.000Z","dependencies_parsed_at":"2024-11-20T23:00:13.789Z","dependency_job_id":null,"html_url":"https://github.com/magcode/mqtt-bluetooth-remote","commit_stats":null,"previous_names":["magcode/mqtt-bluetooth-remote"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/magcode/mqtt-bluetooth-remote","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magcode%2Fmqtt-bluetooth-remote","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magcode%2Fmqtt-bluetooth-remote/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magcode%2Fmqtt-bluetooth-remote/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magcode%2Fmqtt-bluetooth-remote/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/magcode","download_url":"https://codeload.github.com/magcode/mqtt-bluetooth-remote/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magcode%2Fmqtt-bluetooth-remote/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32040058,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"online","status_checked_at":"2026-04-20T02:00:06.527Z","response_time":94,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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","home-automation","mqtt","rmf-tx621e"],"created_at":"2025-01-19T10:10:59.219Z","updated_at":"2026-04-20T08:32:34.871Z","avatar_url":"https://github.com/magcode.png","language":"Python","readme":"# WORK IN PROGRESS\n\n# Bluetooth remote MQTT gateway\n\nThis tool allows you to use a Bluetooth remote controls as an universal input for your home automation.\n\nCurrently supported:\n\n[\"Sony RMF-TX621E remote control\"](https://www.google.com/search?q=RMF-TX621E)\n\nYou need a linux machine. It is verified working with Debian 10.\n\n# What it does\n* Once running you will receive MQTT messages if you press buttons on the remote.\n* On a regular schedule the status of the remote is published.\n* On a regular schedule the battery level of the remote is published.\n\n# Step 2: Configure\nYou need to configure the tool in the file `config.yaml`.\n\n```\ntodo\n\n```\n\n## Auto repeat\nFor some keys (e.g. `KEY_VOLUMEUP`) you may want auto-repeat. If you hold the key multiple MQTT messages will be triggered.\n\n\n## Get Bluetooth remote connected\nYou need to pair and connect your Bluetooth remote before you can use it with this tool.\n\nBest is to use Linux' `bluetoothctl` tool.\n\n\n# Step 3: Install\n```\nTODO\n```\n\n# Start/stop\n```\nsudo service mqblre start\nsudo service mqblre stop\n```\n\n# Uninstall\n```\nsudo service mqblre stop\nTODO\n```\n\n# Using it\n\n## Normal key press\nIf you press a button you will find the following MQTT message triggered:\n\n```\nhome/room/remote/KEY_MUTE trigger\n```\n## Long press with \"autoRepeat\"\nIf you keep pressing one of the supported \"autoRepeat\" buttons you will trigger multiple MQTT messages\n\n```\nhome/room/remote/KEY_VOLUMEUP trigger\nhome/room/remote/KEY_VOLUMEUP trigger\nhome/room/remote/KEY_VOLUMEUP trigger\n```\n\n\n# Notes\n* None\n\n\n# Openhab integration\n\nExample things file\n```\nThing mqtt:topic:RoomRemote \"Room Remote\" (mqtt:broker:mosquitto) {\n    Channels:\n        Type string : KEY_UP \"KEY_UP\" [ stateTopic=\"home/room/remote/KEY_UP\", trigger=true]\n        Type string : KEY_DOWN \"KEY_DOWN\" [ stateTopic=\"home/room/remote/KEY_DOWN\", trigger=true]\n        Type string : KEY_ENTER \"KEY_ENTER\" [ stateTopic=\"home/room/remote/KEY_ENTER\", trigger=true]\n        Type string : KEY_LEFT \"KEY_LEFT\" [ stateTopic=\"home/room/remote/KEY_LEFT\", trigger=true]\n        Type string : KEY_RIGHT \"KEY_RIGHT\" [ stateTopic=\"home/room/remote/KEY_RIGHT\", trigger=true]\n        Type string : KEY_HOMEPAGE \"KEY_HOMEPAGE\" [ stateTopic=\"home/room/remote/KEY_HOMEPAGE\", trigger=true]\n        Type string : KEY_VOLUMEUP \"KEY_VOLUMEUP\" [ stateTopic=\"home/room/remote/KEY_VOLUMEUP\", trigger=true]\n        Type string : KEY_VOLUMEDOWN \"KEY_VOLUMEDOWN\" [ stateTopic=\"home/room/remote/KEY_VOLUMEDOWN\", trigger=true]\n        Type string : KEY_BACK \"KEY_BACK\" [ stateTopic=\"home/room/remote/KEY_BACK\", trigger=true]\n        Type string : KEY_PREVIOUSSONG \"KEY_PREVIOUSSONG\" [ stateTopic=\"home/room/remote/KEY_PREVIOUSSONG\", trigger=true]\n        Type string : KEY_NEXTSONG \"KEY_NEXTSONG\" [ stateTopic=\"home/room/remote/KEY_NEXTSONG\", trigger=true]\n        Type string : KEY_POWER \"KEY_POWER\" [ stateTopic=\"home/room/remote/KEY_POWER\", trigger=true]\n        Type string : KEY_PLAYPAUSE \"KEY_PLAYPAUSE\" [ stateTopic=\"home/room/remote/KEY_PLAYPAUSE\", trigger=true]\n        Type string : KEY_MUTE \"KEY_MUTE\" [ stateTopic=\"home/room/remote/KEY_MUTE\", trigger=true]\n        Type string : KEY_MUTE-LONG \"KEY_MUTE-LONG\" [ stateTopic=\"home/room/remote/KEY_MUTE-LONG\", trigger=true]\n        Type string : KEY_BACKSPACE \"KEY_BACKSPACE\" [ stateTopic=\"home/room/remote/KEY_BACKSPACE\", trigger=true]\n        Type string : KEY_COMPOSE \"KEY_COMPOSE\" [ stateTopic=\"home/room/remote/KEY_COMPOSE\", trigger=true]        \n}\n```\n\nExample rules file\n```\nrule \"KEY_BACK\"\n    when\n        Channel \"mqtt:topic:RoomRemote:KEY_BACK\" triggered\n    then\n        // what you want\nend\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmagcode%2Fmqtt-bluetooth-remote","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmagcode%2Fmqtt-bluetooth-remote","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmagcode%2Fmqtt-bluetooth-remote/lists"}