{"id":14963342,"url":"https://github.com/mhamidjamil/esp32-s3_work","last_synced_at":"2025-10-25T02:30:32.960Z","repository":{"id":172310963,"uuid":"649100997","full_name":"mhamidjamil/ESP32-S3_work","owner":"mhamidjamil","description":"Project uses BLE/WIFI to configure work sequence to behave like a HID","archived":false,"fork":false,"pushed_at":"2023-11-13T19:29:50.000Z","size":22042,"stargazers_count":4,"open_issues_count":4,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-31T04:51:31.024Z","etag":null,"topics":["cmd","esp32-web-keyboard","esp32s3","hid","web-page","wifi"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mhamidjamil.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-03T19:27:26.000Z","updated_at":"2024-03-21T16:25:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"83c80b8a-6a85-40c8-b436-be4d953ab0e1","html_url":"https://github.com/mhamidjamil/ESP32-S3_work","commit_stats":{"total_commits":40,"total_committers":1,"mean_commits":40.0,"dds":0.0,"last_synced_commit":"279f7e799f3d6e58a16ced7bca9c7429b61a27c3"},"previous_names":["mhamidjamil/esp32-s3_work"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhamidjamil%2FESP32-S3_work","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhamidjamil%2FESP32-S3_work/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhamidjamil%2FESP32-S3_work/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhamidjamil%2FESP32-S3_work/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mhamidjamil","download_url":"https://codeload.github.com/mhamidjamil/ESP32-S3_work/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238059129,"owners_count":19409601,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cmd","esp32-web-keyboard","esp32s3","hid","web-page","wifi"],"created_at":"2024-09-24T13:31:22.685Z","updated_at":"2025-10-25T02:30:30.129Z","avatar_url":"https://github.com/mhamidjamil.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Using ESP32S3 as a HID device.\n\nThis project enables communication between an ESP32-S3 board and a connected BLE device. The ESP32-S3 board acts as a BLE/Web server, receiving commands from the connected device and performing specific actions based on the received commands. Additionally, it functions as an HID, allowing it to act as a keyboard and execute commands on the CMD or run applications.\n\n## Prerequisites\n\n- Arduino IDE\n- ESP32-S3 board\n- BLE device (e.g., smartphone, tablet)\n\n## Getting Started\n\n1. Install the necessary libraries:\n\n   - `BLEDevice`\n   - `BLEServer`\n   - `BLEUtils`\n   - `USB`\n   - `USBHIDKeyboard`\n   - `WiFi`\n   - `esp_now`\n\n2. Upload the code to your ESP32-S3 board using the Arduino IDE.\n\n3. Connect your ESP32-S3 board to a power source.\n\n4. Scan for available Bluetooth devices on your BLE device (e.g., smartphone or tablet), or use web portal (localhost)\n\n5. Connect to the ESP32-S3 BLE device from your BLE device.\n\n6. Send commands to the ESP32-S3 BLE device using the connected BLE device (or use ip address assigned to esp32s3 for web base keyboard). Supported commands include:\n\n   - \"test\" - Print a defined word to the serial monitor.\n   - \"#run\\_[command]\" - Execute a command on the ESP32-S3 board.\n   - \"#cmd\\_[command]\" - Execute a command in the Windows command prompt.\n   - Other keywords and string will be send as it is to usb connected device.\n\n7. The ESP32-S3 board will perform the specified actions based on the received commands. It can act as an HID and execute commands on the CMD or run applications.\n\n## Troubleshooting\n\nIf you encounter any issues or errors, please refer to the documentation or seek support from the ESP32-S3 and BLE community.\n\n**Note:** I implementing new functionalities in this project, so this readme file might be outdated, so you better check completed issues labled with _feature_ to know the latest implemented feature.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmhamidjamil%2Fesp32-s3_work","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmhamidjamil%2Fesp32-s3_work","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmhamidjamil%2Fesp32-s3_work/lists"}