2023-11-10 22:33:24 +00:00
# BTClock v3
2024-11-26 20:48:28 +00:00
[](https://git.btclock.dev/btclock/btclock_v3/releases/latest)
[](https://git.btclock.dev/btclock/btclock_v3/actions?workflow=push.yaml& actor=0& status=0)
2023-11-10 22:33:24 +00:00
2023-11-19 17:13:44 +00:00
Software for the BTClock project.
Biggest differences with v2 are:
2023-11-10 22:33:24 +00:00
- Uses WebSockets for all data
- Built on the ESP-IDF with Arduino as a library
- Makes better use of native timers and interrupts
- Able to be flashed over-the-air (using ESP OTA)
- Added market capitalization screen
- LED flash on new block (and focus to block height screen on new block)
2024-09-11 01:23:41 +00:00
New features:
- BitAxe integration
- Zap notifier
2024-12-18 23:08:32 +00:00
- Braiins Pool and Ocean mining stats integration
2024-09-11 01:23:41 +00:00
2023-11-12 13:27:08 +00:00
"Steal focus on new block" means that when a new block is mined, the display will switch to the block height screen if it's not on it already.
2023-11-10 22:33:24 +00:00
Most [information ](https://github.com/btclock/btclock_v2/wiki ) about BTClock v2 is still valid for this version.
2024-09-11 01:23:41 +00:00
**NOTE**: The software assumes that the hardware is run in a controlled private network. ~~The Web UI and the OTA update mechanism are not password protected and accessible to anyone in the network. Also, since the device only fetches numbers through WebSockets it will skip server certificate verification to save resources.~~ Since 3.2.0 the WebUI is password protectable and all certificates are verified. OTA update mechanism is not password-protected.
2023-11-10 22:33:24 +00:00
2023-11-19 17:13:44 +00:00
## Building
2024-12-18 23:08:32 +00:00
Use PlatformIO to build it yourself. Make sure you fetch the [WebUI ](https://github.com/btclock/webui ) submodule.
## Braiins Pool and Ocean integration
Enable mining pool stats by accessing your btclock's web UI (point a web browser at the device's IP address).
Under Settings -> Extra Features: toggle Enable Mining Pool Stats.
New options will appear. Select your mining pool and enter your pool username (Ocean) or api key (Braiins).
### Braiins Pool integration
Create an API key based on the steps [here ](https://academy.braiins.com/en/braiins-pool/monitoring/#api-configuration ).
The key's permissions should be:
* Web Access: no
* API Access: yes
* Access Permissions: Read-only
Copy the token that is created for the new key. Enter this as your "Mining Pool username or api key" in the btclock web UI.
### Ocean integration
Your "Mining Pool username" is just the onchain withdrawal address that you specify when pointing your miners at Ocean.
