BTC Notifier

A small ESP32-based device that fetches the live Bitcoin price from the CoinGecko API and displays it on a TFT screen, refreshing every few seconds.

Features

• Live BTC price (EUR) via the CoinGecko API
• TFT display output with error handling (WiFi and API failures shown on screen)
• Non-blocking update loop using millis() timing
• WiFi credentials kept out of source control via a local secrets file

Hardware

Component	Model
Microcontroller	ESP32 DevKit V1
Display	GERUI 1.8" TFT, 128x160, ST7735 driver, SPI

Wiring diagram coming soon.

Getting Started

Prerequisites

• PlatformIO (VSCode extension or CLI)
• ESP32 board and TFT display wired and configured for TFT_eSPI

Setup

1. Clone the repository

   git clone https://github.com/<your-username>/BTC_Notifier.git
   cd BTC_Notifier

2. Create your secrets file from the template:

   cp include/Secrets.example.h include/Secrets.h

3. Fill in your WiFi credentials and API URL in include/Secrets.h:

   const char *WIFI_SSID = "your-ssid";
   const char *WIFI_PASSWORD = "your-password";
   const char *COINGECKO_API_URL = "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=eur";

4. Build and upload:

   pio run --target upload

5. Open the serial monitor to watch connection and price logs:

   pio device monitor

Project Structure

BTC_Notifier/
├── include/
│   ├── Secrets.example.h   # Template for WiFi credentials & API URL
│   └── Secrets.h           # Your actual credentials (gitignored, not committed)
├── src/
│   └── main.cpp             # Main application logic
├── platformio.ini           # PlatformIO project configuration
└── README.md

Roadmap

• Alternative crypto tracking alongside BTC
• Button-based toggle between assets
• Price change indicator (colour-coded)
• Wiring diagram

License

MIT