https://github.com/intothevoid/daysync
A project that displays weather information, crypto prices, news and MotoGP calendar information on a ESP32 with a TFT display
https://github.com/intothevoid/daysync
c cheap-yellow-display cyd esp32 esp32-2432s028r golang iot platformio
Last synced: 2 months ago
JSON representation
A project that displays weather information, crypto prices, news and MotoGP calendar information on a ESP32 with a TFT display
- Host: GitHub
- URL: https://github.com/intothevoid/daysync
- Owner: intothevoid
- Created: 2025-04-07T11:56:15.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-17T01:39:01.000Z (about 1 year ago)
- Last Synced: 2025-04-17T13:31:30.157Z (about 1 year ago)
- Topics: c, cheap-yellow-display, cyd, esp32, esp32-2432s028r, golang, iot, platformio
- Language: Go
- Homepage:
- Size: 4.32 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Daysync
A project that displays weather information, news, cryptocurrency prices, MotoGP / Formula1 calendars and stock market data on an ESP32 with a TFT display. The ESP32-2432S028 is a 2.4" TFT display with a resolution of 240x320 pixels which is perfect for this project.
```mermaid
graph LR
subgraph ESP32["ESP32 Display"]
E[ESP32 Board]
T[TFT Display]
E --> T
end
subgraph Backend["Go Backend"]
B[API Server]
W[Weather API]
M[MotoGP API]
F[F1 API]
C[Crypto API]
N[News API]
S[Stock API]
end
E <-->|HTTP Requests| B
B <-->|Data Fetch| W
B <-->|Data Fetch| M
B <-->|Data Fetch| F
B <-->|Data Fetch| C
B <-->|Data Fetch| N
B <-->|Data Fetch| S
```
## Project Structure
- `backend/`: Go API backend
- `esp32/`: ESP32 display code
## Backend Setup
1. Navigate to the backend directory:
```bash
cd backend
```
2. Install dependencies:
```bash
go mod tidy
```
3. Run the server:
```bash
go run main.go
```
The API will be available at `http://localhost:5173/api` with the following endpoints:
- `GET /api/motogp` - Get MotoGP season data
- `GET /api/motogpnextrace` - Get next MotoGP race
- `GET /api/formula1` - Get Formula 1 season data
- `GET /api/formula1nextrace` - Get next Formula 1 race
- `GET /api/weather` - Get weather data for a location
- `GET /api/crypto` - Get cryptocurrency price data
- `GET /api/news` - Get top news headlines
- `GET /api/finance` - Get stock market data
## API Documentation
The API documentation is available at `http://localhost:5173/docs/` and provides:
- Interactive Swagger UI interface
- Detailed API endpoint documentation
- Request/response schemas
- Try-it-out functionality for testing endpoints
The documentation is automatically generated from the OpenAPI specification and includes:
- All available endpoints
- Required parameters
- Response formats
- Example requests and responses
## ESP32 Setup
1. Install required libraries in Arduino IDE:
- TFT_eSPI
- ArduinoJson
- HTTPClient
- LVGL
2. Configure TFT_eSPI:
- Edit the `User_Setup.h` file in the TFT_eSPI library
- Uncomment the correct display configuration for your ESP32 board
3. Update the following in `esp32/src/main.cpp`:
- WiFi credentials (`ssid` and `password`)
- API endpoint URL (`BASE_URL`)
- Location and timezone settings
4. Upload the code to your ESP32
## Hardware Requirements
- ESP32 development board
- TFT display compatible with TFT_eSPI library
- USB cable for programming
- Power supply
## Display Features
The display automatically switches between screens every 10 seconds, showing:
1. Weather Information
- Location
- Current date and time
- Temperature
- Humidity
- Weather conditions
2. MotoGP Calendar
- Race name
- Circuit
- Date
- Next race information
3. Formula 1 Calendar
- Race name
- Circuit
- Date
- Next race information
4. Stock Market
- Multiple stock symbols
- Current price
- Price change
- Market data
5. Cryptocurrency
- Multiple crypto symbols
- Current price
- 24h change
- Market cap
6. News Headlines
- News title
- Source
- Multiple headlines across two screens
7. About Screen
- Version information
- Author details
- GitHub repository link
## Data Refresh
- Weather data: Every 60 minutes
- MotoGP data: Every 60 minutes
- Formula 1 data: Every 60 minutes
- Cryptocurrency data: Every 60 minutes
- News data: Every 60 minutes
- Stock market data: Every 60 minutes
## Configuration
The project can be configured through:
- Backend configuration file (`config.yaml`)
- Environment variables (`api.env`)
- ESP32 source code settings
## Development
The project supports:
- Test mode for development
- ICS to JSON conversion for calendar data
- CORS support for API endpoints
- HTTP caching for improved performance