Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lnbits/bitcoinswitch

Turn things on with bitcoin!
https://github.com/lnbits/bitcoinswitch

Last synced: about 1 month ago
JSON representation

Turn things on with bitcoin!

Host: GitHub
URL: https://github.com/lnbits/bitcoinswitch
Owner: lnbits
License: gpl-3.0
Fork: true (arcbtc/bitcoinSwitch)
Created: 2022-10-08T00:08:15.000Z (about 2 years ago)
Default Branch: main
Last Pushed: 2024-08-28T09:26:10.000Z (4 months ago)
Last Synced: 2024-08-28T10:43:39.407Z (4 months ago)
Language: C++
Homepage: https://bitcoinswitch.lnbits.com/
Size: 27.6 MB
Stars: 75
Watchers: 2
Forks: 22
Open Issues: 5
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-lnbits - bitcoinSwitch - Turn things on with bitcoin. (Uncategorized / Uncategorized)

README

# Clicky, the Bitcoin Switch

👉 An absolutely incredible bitcoinSwitch guide by [Axel](https://github.com/AxelHamburch/) 👈

Also check out our video tutorial.

✅ $8 worth parts / 15min setup

✅ Websockets for blazingly fast turning on the things

✅ Web-installer/config for easy setup

✅ Support for MULTIPLE GPIOS/LNURLs (!)

# Flash and configure via webinstaller https://bitcoinswitch.lnbits.com/

switch_front
switch_back

### Things you can turn on with a switch

There is a broad range of things from lamps, to candy-, claw or even arcade machines that can be turned on by a lightning payment with Clicky.
Have a look at the [LNbits shop](https://shop.lnbits.com/product-category/hardware/fun-things) what we did or check the [LNbits wiki](https://github.com/lnbits/lnbits/wiki/Tooling-&-Building-with-LNbits) on how to build those yourself.

### What you need
- esp32 dev kit
- High level relais
- Female to male and male to male cables
- Data cable
- Optional: a case
- Desktop PC
- LNbits LNURLdevice Extension
- Something to turn on

Snow
Forest
Mountains

Once flashed, press GPIO4 in few seconds of ESP32 booting up to be able to config.

Got questions ? Join us t.me/lnbits, t.me/makerbits

## Complicated install instructions not using browser flashing

- Install Arduino IDE 1.8.19
- Install ESP32 boards, using boards manager
![image](https://user-images.githubusercontent.com/33088785/161862832-1269a12e-16ce-427c-9a92-df3ee573a1fb.png)

- Download this repo
- Copy these libraries into your Arduino install "libraries" folder
- Open this bitcoinSwitch.ino file in the Arduino IDE
- Select the correct ESP32 board from tools>board
- Upload to device

![trigger](https://user-images.githubusercontent.com/33088785/166829947-d0194b32-19fc-4a16-83d3-dc6f9af9337c.gif)

### Development
build with arduino-cli
```console
sh build.sh
```
build webinstaller, fetch main assets from lnbits.github.io
```console
sh build-installer.sh
```
start preview
```console
cd installer
http-server -p 8080
```

### arduino-cli
compiling
```console
arduino-cli compile --build-path build --fqbn esp32:esp32:esp32 bitcoinSwitch
```
monitoring
```console
arduino-cli monitor -p /dev/ttyUSB1 -c baudrate=115200
```
uploading
```console
arduino-cli upload --fqbn esp32:esp32:esp32 --input-dir build -p /dev/ttyUSB1
```