Getting started with Facedancer
Install the Facedancer library
You can install the Facedancer library from the Python Package Index (PyPI), a release archive or directly from source.
Install From PyPI
You can use the pip tool to install the Facedancer library from PyPI using the following command:
pip install facedancer
For more information on installing Python packages from PyPI please refer to the “Installing Packages” section of the Python Packaging User Guide.
Install From Source
git clone https://github.com/greatscottgadgets/facedancer.git
cd facedancer/
Once you have the source code downloaded you can install the Facedancer library with:
pip install .
Run a Facedancer example
Create a new Python file called rubber-ducky.py with the following content:
import asyncio
import logging
from facedancer import main
from facedancer.devices.keyboard import USBKeyboardDevice
from facedancer.classes.hid.keyboard import KeyboardModifiers
device = USBKeyboardDevice()
async def type_letters():
# Wait for device to connect
await asyncio.sleep(2)
# Type a string with the device
await device.type_string("echo hello, facedancer\n")
main(device, type_letters())
Open a terminal and run:
python ./rubber-ducky.py