{"id":20474368,"url":"https://github.com/axelhamburch/offlinelnswitch","last_synced_at":"2026-04-17T22:08:13.461Z","repository":{"id":185926309,"uuid":"674333001","full_name":"AxelHamburch/offlineLNSwitch","owner":"AxelHamburch","description":"The offline bitcoinSwitch","archived":false,"fork":false,"pushed_at":"2024-03-16T18:45:27.000Z","size":37452,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-16T02:45:30.949Z","etag":null,"topics":["bitcoin","bitcoinswitch","lightning","offline","payment"],"latest_commit_sha":null,"homepage":"https://ereignishorizont.xyz/offlinelnswitch/en/","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AxelHamburch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-08-03T17:27:50.000Z","updated_at":"2024-05-06T06:53:55.000Z","dependencies_parsed_at":"2024-11-15T14:41:12.086Z","dependency_job_id":null,"html_url":"https://github.com/AxelHamburch/offlineLNSwitch","commit_stats":null,"previous_names":["axelhamburch/testtouchdisplay","axelhamburch/offlinelnswitch"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AxelHamburch%2FofflineLNSwitch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AxelHamburch%2FofflineLNSwitch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AxelHamburch%2FofflineLNSwitch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AxelHamburch%2FofflineLNSwitch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AxelHamburch","download_url":"https://codeload.github.com/AxelHamburch/offlineLNSwitch/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242039717,"owners_count":20061928,"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":["bitcoin","bitcoinswitch","lightning","offline","payment"],"created_at":"2024-11-15T14:29:17.560Z","updated_at":"2026-04-17T22:08:08.433Z","avatar_url":"https://github.com/AxelHamburch.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# offline⚡️Switch\n\n\u003c!--- ![offline⚡️Switch](./doc/main.jpg)---\u003e\n\n\u003cimg src=\"./doc/main.jpg\" width=\"700\"\u003e\n\n## Short description\n\nThe offline⚡️Switch is a bitcoinSwitch with an ESP32-based smart display (made by Sunton). It is based on the offline payment functionality of bitcoinVend or LNPoS. The offline⚡️Switch itself does not need to be online, only the payer. The offline⚡️Switch can display a QR code (LNURL) on the display. The user's wallet scans the QR code and connects online to the LNbits server. If the Invoice has been paid, the user is shown a \"secret\" as a four-digit PIN. If this PIN is entered via the touch panel into the offline⚡️Switch, then the condition is fulfilled for him and the switch is switched. The configuration can be done exclusively via the display, which considerably reduces the technical requirements. As a basis for this smart display project I could use the BliksemBier from Pieter.\n\n## Requirements\n\n- Sunton 3.5\" 320\\*480 Smart Display ESP32-3248S035 (with R for Resistive or C for Capacitive (recommended) Touch Screen [e.g.](https://de.aliexpress.com/item/1005004632953455.html)\n- 5V Relay (High-Level-Triggered) [e.g](https://www.az-delivery.de/products/relais-modul)\n\n## Relay connection\n\nThe connection of a relay is quite simple. The supplied cable is sufficient. The classic 5V relays usually have three connections. Supply (5V), Ground (GND) and Signal (Sig). The ESP32 delivers only 3.3V, but for most 5V relays this should be enough. Connect `3,3V` (red), `GND` (black) and the signal `IO21` (yellow) as shown in the picture. The blue line for IO22 remains unused here.\n\n\u003cimg src=\"./doc/relay.jpg\" width=\"400\"\u003e\n\n## How do I set up the offline⚡️Switch?\n\n1. Flash the firmware on the ESP32\n2. Create and set up a LNbits wallet\n3. Configure the offline⚡️Switch via the touch display (PIN: 123456)\n\nFor a detailed description see my website: [ereignishorizont.xyz/offlinelnswitch](https://ereignishorizont.xyz/offlinelnswitch/en/)\n\nDirect access to the web installer can be found here: [web installer](https://ereignishorizont.xyz/installer/offlineLNSwitch/index.html)\n\n## License\n\nThis is FOSS according to MIT license. For those who want to clone and edit it themselves, here is some information:\n\nThe backend is an [LNbits](https://lnbits.com/) server with a wallet account. The interface for processing the payment is provided by the [LNURLdevice](https://github.com/lnbits/lnurldevice) extension. You can select this in your LNbits account.\n\nAs development environment (**I**ntegrated **D**evelopment **E**nvironment) I would recommend [PlatformIO](https://platformio.org/platformio-ide) on [VSCode](https://code.visualstudio.com/). As a graphical user interface [LVGL](https://lvgl.io/) (**L**ight and **V**ersatile Embedded **G**raphics **L**ibrary) was used and mostly created by the application [SquareLine Studio](https://squareline.io/).\n\n## Aknowledgement\n\nThis project use bits from\n[BliksemBier](https://github.com/pieterjm/BliksemBier) from Pieter and\n[bitcoinVend](https://github.com/arcbtc/bitcoinVend) from Ben Arc\n\n## Donations/contributions\n\nDonations and contributions are welcome.\n\nLightning⚡Address: \u003caxelhamburch@ereignishorizont.xyz\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faxelhamburch%2Fofflinelnswitch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faxelhamburch%2Fofflinelnswitch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faxelhamburch%2Fofflinelnswitch/lists"}