https://github.com/syss-research/bluetooth-keyboard-emulator
Simple proof-of-concept software tool for emulating Bluetooth BR/EDR (a.k.a. Bluetooth Classic) keyboards
https://github.com/syss-research/bluetooth-keyboard-emulator
bluetooth proof-of-concept security security-tools tool
Last synced: 2 months ago
JSON representation
Simple proof-of-concept software tool for emulating Bluetooth BR/EDR (a.k.a. Bluetooth Classic) keyboards
- Host: GitHub
- URL: https://github.com/syss-research/bluetooth-keyboard-emulator
- Owner: SySS-Research
- License: mit
- Created: 2018-06-22T13:26:14.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2018-07-23T09:43:55.000Z (almost 8 years ago)
- Last Synced: 2026-03-27T13:44:21.062Z (2 months ago)
- Topics: bluetooth, proof-of-concept, security, security-tools, tool
- Language: Python
- Size: 2.84 MB
- Stars: 59
- Watchers: 4
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Bluetooth Keyboard Emulator
The SySS Bluetooth Keyboard Emulator is a simple proof-of-concept software
tool for emulating Bluetooth BR/EDR (a.k.a. Bluetooth Classic) keyboards based
on the [BlueZ 5 Bluetooth Keyboard Emulator for Raspberry Pi (YAPTB Bluetooth keyboard emulator)](https://github.com/0xmemphre/BL_keyboard_RPI)
by Thanh Le.
It was developed for modern Linux operating systems like [Arch Linux](https://www.archlinux.org/) with a
modern BlueZ 5 Bluetooth protocol stack and utilities.
So far, the keyboard emulator has only been tested on Arch Linux systems.
**_Caution: The software tool is still work in progress._**
## Requirements
- Modern Linux operating system with BlueZ 5 protocol stack (e. g. [Arch Linux](https://www.archlinux.org/))
- BlueZ 5 utilities [bluez-utils](https://www.archlinux.org/packages/extra/x86_64/bluez-utils/)
- Bluetooth adapter, e.g. Bluetooth dongle with supported chipset (so far only tested CSR8510 and BCM20702A0)
- Python 3
- [https://pypi.org/project/dbus-python/](https://pypi.org/project/dbus-python/)
- [pynput](https://pypi.org/project/pynput/)
## Setup
For setting up the Bluetooth Keyboard Emulator simply run the provided shell
script **setup.sh** with root privileges.
```
sudo ./setup.sh
```
Or manually copy the file **dbus/de.syss.btkbdservice.conf** to **/etc/dbus-1/system.d/**.
```
sudo cp dbus/de.syss.btkbdservice.conf /etc/dbus-1/system.d/
```
## Configuration
Rename or copy the provided sample configuration file **keyboard.conf.example**
to **keyboard.conf** and edit it with your favorite text editor.
## Usage
In order to start the Bluetooth Keyboard Emulator, run the provided shell script
**start.sh** in a terminal with root privileges.
```
sudo ./start.sh
```
Afterwards, you can attach to the created tmux session named **kbdemu**.
```
sudo tmux attach -t kbdemu
```
**_Caution: The client component of the running Bluetooth Keyboard Emulator will register and process all keypresses!_**
For stopping the keyboard emulation, you can simply kill the tmux session.
```
sudo tmux kill-session -t kbdemu
```
The following screenshot illustrates the keyboard emulator usage.
# Disclaimer
Use at your own risk. Do not use without full consent of everyone involved. For educational purposes only.