Ghost-Key

Android Bluetooth HID Emulation Framework

Features • Requirements • Installation • Usage • Contributing • License

---

Ghost-Key transforms your Android device into a Bluetooth HID (Human Interface Device) that can emulate keyboards and mice. Built for security professionals and penetration testers, it supports DuckyScript execution and includes a comprehensive payload arsenal.

Screenshots

Features

• Bluetooth HID Emulation - Appear as a trusted keyboard/mouse to target systems
• DuckyScript Support - Execute Hak5 Rubber Ducky compatible scripts
• Payload Arsenal - 50+ pre-built offensive security payloads
• Custom Script Editor - Create and save your own DuckyScript payloads
• Profile Masquerade - Impersonate popular Bluetooth peripherals
• Cross-Platform Targets - Payloads for Windows, Linux, and macOS

Requirements

• Android 9.0 (API 28) or higher
• Bluetooth HID Device profile support
• Device must support Bluetooth Classic (not just BLE)

Installation

From Releases

1. Download the latest APK from Releases
2. Enable installation from unknown sources
3. Install the APK

Build from Source

git clone https://github.com/System00-Security/Ghost-Key.git
cd Ghost-Key
./gradlew assembleRelease

The APK will be generated at app/build/outputs/apk/release/

Usage

1. Enable Bluetooth on your Android device
2. Register HID Service from the CONN tab
3. Pair with the target device from its Bluetooth settings
4. Connect to the target from Ghost-Key
5. Execute payloads or type commands via HID

Architecture

Component	Description
BluetoothHidService	Core HID device registration and communication
DuckyScriptParser	Parses DuckyScript syntax into HID commands
PayloadLibrary	Pre-built offensive security scripts
GhostKeyDatabase	SQLite storage for custom scripts

Disclaimer

This tool is intended for authorized security testing and educational purposes only. Unauthorized access to computer systems is illegal. Always obtain proper authorization before testing.

Contributing

Contributions are welcome and appreciated. Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/new-payload)
3. Commit your changes (git commit -m 'Add new payload')
4. Push to the branch (git push origin feature/new-payload)
5. Open a Pull Request

Areas for Contribution

• New DuckyScript payloads
• UI/UX improvements
• Documentation
• Bug fixes
• Platform-specific optimizations

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Ghost-Key by System00 Security