{"id":21573709,"url":"https://github.com/syss-research/bluetooth-keyboard-emulator","last_synced_at":"2026-04-01T21:50:31.246Z","repository":{"id":119356824,"uuid":"138305807","full_name":"SySS-Research/bluetooth-keyboard-emulator","owner":"SySS-Research","description":"Simple proof-of-concept software tool for emulating Bluetooth BR/EDR (a.k.a. Bluetooth Classic) keyboards","archived":false,"fork":false,"pushed_at":"2018-07-23T09:43:55.000Z","size":2979,"stargazers_count":59,"open_issues_count":1,"forks_count":9,"subscribers_count":4,"default_branch":"master","last_synced_at":"2026-03-27T13:44:21.062Z","etag":null,"topics":["bluetooth","proof-of-concept","security","security-tools","tool"],"latest_commit_sha":null,"homepage":null,"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/SySS-Research.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}},"created_at":"2018-06-22T13:26:14.000Z","updated_at":"2026-01-13T11:19:21.000Z","dependencies_parsed_at":null,"dependency_job_id":"ed3f930d-6d1e-4ea9-8926-0c6343beeccc","html_url":"https://github.com/SySS-Research/bluetooth-keyboard-emulator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/SySS-Research/bluetooth-keyboard-emulator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SySS-Research%2Fbluetooth-keyboard-emulator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SySS-Research%2Fbluetooth-keyboard-emulator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SySS-Research%2Fbluetooth-keyboard-emulator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SySS-Research%2Fbluetooth-keyboard-emulator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SySS-Research","download_url":"https://codeload.github.com/SySS-Research/bluetooth-keyboard-emulator/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SySS-Research%2Fbluetooth-keyboard-emulator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31046899,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-27T09:35:52.079Z","status":"ssl_error","status_checked_at":"2026-03-27T09:35:20.916Z","response_time":164,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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","proof-of-concept","security","security-tools","tool"],"created_at":"2024-11-24T12:07:45.871Z","updated_at":"2026-04-01T21:50:31.239Z","avatar_url":"https://github.com/SySS-Research.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bluetooth Keyboard Emulator\n\nThe SySS Bluetooth Keyboard Emulator is a simple proof-of-concept software\ntool for emulating Bluetooth BR/EDR (a.k.a. Bluetooth Classic) keyboards based\non the [BlueZ 5 Bluetooth Keyboard Emulator for Raspberry Pi (YAPTB Bluetooth keyboard emulator)](https://github.com/0xmemphre/BL_keyboard_RPI)\nby Thanh Le.\n\nIt was developed for modern Linux operating systems like [Arch Linux](https://www.archlinux.org/) with a\nmodern BlueZ 5 Bluetooth protocol stack and utilities.\n\nSo far, the keyboard emulator has only been tested on Arch Linux systems.\n\n**_Caution: The software tool is still work in progress._**\n\n## Requirements\n\n- Modern Linux operating system with BlueZ 5 protocol stack (e. g. [Arch Linux](https://www.archlinux.org/))\n- BlueZ 5 utilities [bluez-utils](https://www.archlinux.org/packages/extra/x86_64/bluez-utils/)\n- Bluetooth adapter, e.g. Bluetooth dongle with supported chipset (so far only tested CSR8510 and BCM20702A0)\n- Python 3\n- [https://pypi.org/project/dbus-python/](https://pypi.org/project/dbus-python/)\n- [pynput](https://pypi.org/project/pynput/)\n\n\n## Setup\n\nFor setting up the Bluetooth Keyboard Emulator simply run the provided shell\nscript **setup.sh** with root privileges.\n\n```\nsudo ./setup.sh\n```\n\nOr manually copy the file **dbus/de.syss.btkbdservice.conf** to **/etc/dbus-1/system.d/**.\n\n```\nsudo cp dbus/de.syss.btkbdservice.conf /etc/dbus-1/system.d/\n```\n\n## Configuration\n\nRename or copy the provided sample configuration file **keyboard.conf.example**\nto **keyboard.conf** and edit it with your favorite text editor.\n\n## Usage\n\nIn order to start the Bluetooth Keyboard Emulator, run the provided shell script\n**start.sh** in a terminal with root privileges.\n\n```\nsudo ./start.sh\n```\n\nAfterwards, you can attach to the created tmux session named **kbdemu**.\n\n```\nsudo tmux attach -t kbdemu\n```\n\n**_Caution: The client component of the running Bluetooth Keyboard Emulator will register and process all keypresses!_**\n\nFor stopping the keyboard emulation, you can simply kill the tmux session.\n\n```\nsudo tmux kill-session -t kbdemu\n```\n\nThe following screenshot illustrates the keyboard emulator usage.\n\n![Screenshot of a Bluetooth Keyboard Emulator tmux session](https://github.com/SySS-Research/bluetooth-keyboard-emulator/blob/master/images/bluetooth_keyboard_emulator.png)\n\n# Disclaimer\n\nUse at your own risk. Do not use without full consent of everyone involved. For educational purposes only.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyss-research%2Fbluetooth-keyboard-emulator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsyss-research%2Fbluetooth-keyboard-emulator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyss-research%2Fbluetooth-keyboard-emulator/lists"}