Repository navigation
Releases
Paperclip Flasher 0.1.2
Paperclip Flasher 0.1.2
Reliability update for the original Goldshell KDBox (MCB_V5_4). This remains an experimental prerelease.
Improvements
- More time for SSH greetings, bounded connection retries, and clearer connection errors and progress.
- Wrong passwords and changed device identities stop immediately. Writes and login requests are never blindly retried.
- Verified backups and uploads, followed by dashboard and telemetry checks before installation reports success.
- Recovery resumes the existing mining algorithm, and original safety-stop details survive controller restarts.
- Transient read-only controller failures get one retry. An active safety stop blocks installation before files are changed.
- Better handling of busy windows and password redaction in errors.
Downloads
- Windows x64: extract the ZIP and run
PaperclipFlasher.exe. - Linux x64: extract the tar.gz and run
./PaperclipFlasherfrom a graphical desktop. A modern Linux distribution is required. - Verify the downloaded archive against
SHA256SUMS.txt.
Enter the miner IP, SSH root password, and dashboard password. Confirm its fingerprint and choose Back up & install Paperclip. Keep the private recovery backup. Existing pools are preserved; configure or rearrange pools in the miner's web UI after installation.
Compatibility and validation
Firmware support is unchanged: 2.0.5, 2.0.6, 2.0.7q, 2.0.8, 2.0.9, 2.1.0, 2.1.1, 2.1.3, 2.2.0, 2.2.1, and 2.2.3 on the original KDBox / MCB_V5_4. Firmware 2.2.4 is unsupported. No automatic stock firmware upgrade or downgrade is performed.
Windows and Linux CI passed controller tests, Go vet, and 30 Python tests. Both builds contain an identical ARM controller. Installation and mining recovery were tested on original KDBox hardware running 2.2.3. The Windows installer and miner dashboard were visually checked; Linux desktop GUI operation has not been manually tested. Earlier firmware compatibility results are documented in the repository and were not all repeated for this release.
Built from commit 7fac921362c8e67671377b1b71b890742bf4ad60 in CI run 41330874760.
Use at your own risk. Firmware-related changes can brick a device or cause lost mining income or hardware damage. Backups, rollback, and safety checks reduce risk but cannot guarantee recovery. No warranty is provided.
Paperclip Flasher 0.1.1 — Expanded Firmware Support
Expanded firmware compatibility for the original Goldshell KDBox (MCB_V5_4, ARMv7).
Downloads
- Windows x64: extract the ZIP and run
PaperclipFlasher.exe. - Linux x64: extract the tar.gz and run
./PaperclipFlasherfrom a graphical desktop on a compatible modern distribution. - Verify the archive against
SHA256SUMS.txtbefore installing.
Enter the miner IP, SSH root password, and dashboard password. Keep the recovery backup. Configure pools and the payout address in the miner’s Mining tab after installation.
What changed
- Supports firmware 2.0.5, 2.0.6, 2.0.7q, 2.0.8, 2.0.9, 2.1.0, 2.1.1, 2.1.3, 2.2.0, 2.2.1, and 2.2.3.
- Handles older board-identification APIs and 2.2.3 SSH setup, read-only filesystem, and fan control.
- Authenticates chip-temperature readings and diagnostics on newer firmware; missing chip temperatures trigger a safety stop after startup grace.
- Checks available storage before installation and rejects recovery backups from a different firmware version.
- Rejects expired tuning confirmations and starts fans at full output during initialization.
2.2.4 remains unsupported: its stock firmware removed the SSH-enable mechanism. The installer rejects it and does not upgrade or downgrade stock firmware.
Testing
Installation, accepted shares, pool display, and reboot tests covered the supported versions. On 2.0.6, a staged test followed by ten minutes at 740 MHz reached about 709 GH/s with a maximum observed chip temperature of 83°C; its tighter 80°C average / 85°C chip shutdown limits remain enabled. This is a short test, not a long-term thermal guarantee.
On 2.2.3, fan tuning, reboot during an unconfirmed tuning trial, read-only boot, and restoration of the stock interface passed. The final build was installed on 2.2.1 and verified with accepted shares after reboot, chip diagnostics, pool display, and hashrate history.
Go tests, go vet, and all 18 Python tests passed on Windows and Linux. Linux GUI installation has not been tested on hardware.
The executables are unchanged from successful build 41095285287, commit 65c646a80fe6e5d692c93601f93972354414e5f9. The release tag adds only updated download documentation. See the compatibility table.
Before installing
Experimental prerelease — use at your own risk. Firmware-related changes can brick a device or cause permanent hardware damage. Backups, thermal checks, and automatic rollback cannot guarantee recovery. Use a trusted LAN: the stock dashboard API uses unencrypted HTTP. The installer requires your own SSH and dashboard credentials. It installs files over SSH, not a full firmware image or bootloader.
Paperclip Flasher 0.1.0 — Experimental Preview
First experimental preview of Paperclip Flasher: a local installer and replacement dashboard for the original Goldshell KDBox.
Downloads
- Windows x64: extract the ZIP and run
PaperclipFlasher.exe. - Linux x64: extract the tar.gz and run
./PaperclipFlasher. Requires a graphical desktop and a compatible modern Linux distribution. SHA256SUMS.txtcontains archive checksums.
Enter the miner IP, SSH root password, and dashboard password. The installer verifies the supported device, creates a recovery backup, and opens its dashboard. Configure the pool and payout address in the Mining tab after installation. Existing pools and the selected algorithm are preserved.
Included
- BLAKE2b(XBT) and BLAKE2s(KDA) algorithm selection.
- Light/dark dashboard on the miner's normal web address.
- Saved pools, priority controls, and live “Mining here” status; visible while locked, editable after unlocking.
- Hashrate history, shares, temperatures, and hardware-error reporting.
- Fan controls and bounded clock/voltage trials with rollback safeguards.
- Network settings, diagnostics, and recovery backups.
Compatibility and testing
Only original Goldshell KDBox, firmware 2.2.1, MCB_V5_4, ARMv7 is supported. Other hardware/firmware is rejected. This installer does not flash a complete firmware image or downgrade firmware.
Windows packaged installation from restored stock configuration was tested on one supported KDBox. A subsequent fan-startup fix was verified through reboot and resumed accepted shares. Latest pool visibility and Overview changes were verified on that device. Windows/Linux automated tests and packaging passed; Linux GUI installation has not yet been tested on hardware.
These are the binaries from successful build 41006913498, commit 9027c0479364e07fcc79d8daff1cc07745c09303, repackaged without changing their contents.
Before installing
Use at your own risk. Firmware-related changes, including startup-file changes, can brick a device or cause permanent hardware damage. Backups and automatic rollback cannot guarantee recovery. Keep your recovery backup, and use only a trusted LAN: the stock dashboard authentication API uses unencrypted HTTP. No device passwords are bundled. This is an experimental prerelease, not a production-stability guarantee.