Skip to content

v1.0.1

Choose a tag to compare

View all tags
@dfyR433 dfyR433 released this 19 Aug 21:14
· 68 commits to main since this release
v1.0.1
666937a
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

USB_Ware

This project uses an ESP32-S2/S3 (or other ESP board with native USB HID support) to inject a Python script via USB HID keyboard emulation. The Python script encrypts or decrypts files in a specified folder on a Windows PC.

Features

  • USB HID injection via ESP32-S2/S3 or similar ESP with native USB.
  • Automatically types and runs a Python script on Windows.
  • Encrypts or decrypts all files in a chosen folder (e.g., Desktop, Documents).
  • Auto-installs required Python library (cryptography) if missing.
  • Saves encryption key with backup.
  • Displays progress during operation.
  • Saves the Python script as a hidden file on the target PC.
  • Configurable mode: Encrypt ("e") or Decrypt ("d").
  • Adjustable typing speed for injection.

Supported Hardware

  • ESP32-S2 or ESP32-S3 development boards with native USB HID capability.
  • Any ESP board capable of USB HID keyboard emulation.

Supported Operating System

  • Windows (with Python installed and accessible from command line).

Usage

  1. Set MODE to "e" or "d" in the source code.
  2. Set speed to control typing delay (minimum recommended: 10.0).
  3. Specify the target folder name (e.g., "Desktop", "Documents").
  4. Compile and upload the firmware to your ESP device.
  5. Connect the ESP device to the Windows PC; it will auto-inject the script and run it.

Requirements

  • Python 3 installed on the target Windows PC.
  • cryptography Python library will be installed automatically if missing.

Disclaimer

This tool is for educational and authorized testing only. Unauthorized use is prohibited and may be illegal.

License

MIT License.

Contact

Created by dfyR433

For questions or contributions, please open an issue or pull request.

Assets 3
Loading