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.

• 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

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

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

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/

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

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.

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

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

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

Ghost-Key by System00 Security