OpenShock Auto-Flasher 
Automatically flash OpenShock hubs as they are plugged in, verify firmware checksums, and optionally test their WiFi AP and RF transmitter. Terminal colors show progress and pass/fail results.
Install
Requires Python 3.12+, pipx, and a USB connection to your hub. Runs on Linux, macOS, and Windows.
pipx install --force 'git+https://github.com/NanashiTheNameless/OpenShock-AutoFlasher@main'
For PyPI or source installation, see the advanced guide.
Flash hubs
Start with hubs disconnected, run the command, then plug in a hub:
OPSH-AutoFlash --board Wemos-D1-Mini-ESP32
The flasher processes each newly connected hub and waits for the next one. Press Ctrl+C to stop. Replace the board name with yours; list available boards with:
OPSH-AutoFlash --help
Add --erase to clear flash first, --alert for a completion beep, or
--channel beta to use beta firmware.
Test WiFi and RF
- WiFi: the host computer scans for the hub's exact
OpenShock-XX:XX:XX:XX:XX:XXAP using its WiFi adapter. Scanning supports Linux, Windows, and macOS. See platform requirements for WiFi services and permissions. - RF: prepare a separate USB tester with a 433 MHz receiver running CaiXianlinRemoteIDMonitor. Follow the tester setup guide.
Start the command with hubs disconnected. Plug the tester in first, wait for
RF tester detected ...; reserved for testing., then connect hubs one at a time.
Close other serial monitors before testing.
Erase, flash, test, and factory-reset each hub:
OPSH-AutoFlash --board Wemos-D1-Mini-ESP32 --erase --alert \
--test-wifi --test-rf --factory-reset-after-test
Factory reset clears saved hub settings after testing, whether tests pass or fail.
Omit --factory-reset-after-test to keep the settings after testing.
Test existing firmware without flashing:
OPSH-AutoFlash --board Wemos-D1-Mini-ESP32 --test-only --test-wifi --test-rf
No hub port is required: test-only mode detects newly connected hubs and continues after each result. Enable either WiFi or RF alone by omitting the other test flag. RF testing checks Beep, Vibrate, and Stop with different IDs; Light and Shock are not transmitted. Results appear in the terminal.
To process one already-connected hub and exit, add --port /dev/ttyUSB1 (or a
Windows port such as COM3). For an explicit tester port, use
--test-rf-port /dev/ttyUSB0 instead of --test-rf; the hub and tester must use
separate ports.
Session report
One dark-mode HTML file records every hub attempt in the session, including MAC address,
USB serial number when available, flash status, and detailed test results.
The file is updated throughout the run, and its path is printed at startup.
Use --report batch.html to choose a filename, or --no-report to disable it.
See report details.
More information
See README-advanced.md for all flags, firmware versions, custom pins, WiFi scanning, RF validation, Linux permissions, troubleshooting, and development instructions.
For contributions, see CONTRIBUTING.md. Report vulnerabilities using SECURITY.md.
License
Licensed under GNU AGPL-3.0.
Disclaimer
This tool is provided as-is. Use at your own risk. Always ensure you have backups of any important configurations before flashing firmware.
Support My Work
If this project is useful to you, you can support it here:
1 maintainer
Metadata
1 maintainer
Release files for OpenShock-AutoFlasher 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| openshock_autoflasher-0.4.0.tar.gz | 59.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| openshock_autoflasher-0.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 103.7 kB
Release files / openshock_autoflasher-0.4.0.tar.gz
| Download URL | openshock_autoflasher-0.4.0.tar.gz |
|---|---|
| Size | 59.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
71582c47f358fb57e18f777cb6174c2ca2d09c365c3ed0a071e59f761a1046b8
|
|
BLAKE2b-256 checksum How to use checksums |
6c9b950fcaaa76d819c5380dcd18a0ad69d61bd65438cccbcc4ce503d570bda8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.
Transparency logRelease files / openshock_autoflasher-0.4.0-py3-none-any.whl
| Download URL | openshock_autoflasher-0.4.0-py3-none-any.whl |
|---|---|
| Size | 44.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d3abe82fc76fcd557963d46e90bec145734d19b924e7c7b41b9ce030f8c2fdc6
|
|
BLAKE2b-256 checksum How to use checksums |
554373aebb01b27b0f84e64d1fb155e62c792e62a7aa4d378d0eaca61f757fc5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.
Transparency log
