A feature-rich ESP32 project for the LilyGo T-Display AMOLED board, featuring interactive widgets for stock tracking and Clockify time management using LVGL.

• Stock price tracking using Financial Modeling Prep API
• 30-day price history chart with visual trends
• Percentage and dollar change indicators
• Color-coded price movements (green for gains, red for losses)
• Currently configured for Tesla (TSLA) stock

• Integration with Clockify time tracking API
• Start/stop timers directly from the device
• View your time entry history
• Live timer display for in-progress tasks
• Quick-start timers from previous entries
• Automatic data synchronization

• Board: LilyGo T-Display S3 AMOLED (1.91 inch, with touch)

• PlatformIO installed
• Clockify API Free key (get from Clockify)
• Financial Modeling Prep API Free key (get from FMP)
• WiFi credentials

git clone https://github.com/KerteszRoland/ESP32-lvgl-widgets cd ESP32-lvgl-widgets

Create a private_config.ini file in the root directory based on the example:

cp "private_config example.ini" private_config.ini

Edit private_config.ini and add your credentials:

PlatformIO will automatically install the required dependencies listed in platformio.ini:

• LVGL v9.3
• TFT_eSPI
• ArduinoJson
• XPowersLib
• And more...

# Build the project pio run # Upload to the board pio run --target upload # Monitor serial output pio device monitor

Or use PlatformIO IDE's built-in buttons.

The interface uses a tileview with swipe navigation:

• Home Screen (Tile 0): Stock widget - swipe left to access Clockify
• Clockify Screen (Tile 1): Time tracking widget - swipe right to return

The stock widget automatically:

• Fetches the latest price data on startup
• Displays current price with trend indicators
• Shows 30-day price history chart
• Show price movements (percentage and dollar change)

To track a different stock, modify the STOCK_TICKER constant in files/stock_widget.cpp:

const std::string STOCK_TICKER = "TSLA"; // Change to your preferred ticker

• View Active Timer: If a timer is running, it displays at the top with a stop button
• Timer History: Scroll through your recent time entries
• Start Timer: Tap the play button on any previous entry to start a new timer based on that entry
• Stop Timer: Tap the stop button to end the current timer

ESP32-lvgl-widgets/ ├── boards/ │ └── T-Display-AMOLED.json # Board definition ├── files/ # Main source directory │ ├── main.ino # Main application entry point │ ├── config.h # Configuration validation │ ├── stock_widget.cpp/.h # Stock widget implementation │ ├── clockify_widget.cpp/.h # Clockify widget implementation │ └── src/ │ ├── arial_20.c # Custom font │ └── arial_26.c # Custom font ├── src/ # Library source files │ ├── LilyGo_AMOLED.cpp/.h # Board-specific driver │ ├── LV_Helper.cpp/.h # LVGL helper functions │ ├── lv_conf.h # LVGL configuration │ └── ... ├── platformio.ini # PlatformIO configuration ├── private_config.ini # Your private credentials (gitignored) └── private_config example.ini # Template for credentials 

1. Create widget header and implementation files in files/
2. Include the widget in main.ino
3. Add a new tile to the tileview:

lv_obj_t * tile_new = lv_tileview_add_tile(tileview, x, y, direction); render_your_widget(tile_new);

Edit STOCK_TICKER in files/stock_widget.cpp:

const std::string STOCK_TICKER = "AAPL"; // Apple // or const std::string STOCK_TICKER = "GOOGL"; // Google

In files/clockify_widget.cpp:

const int REFRESH_CLOCKIFY_WIDGET_TIMER_FREQ_MS = 500; // Timer update frequency const int REFRESH_CLOCKIFY_WIDGET_POLLING_FREQ_MS = 5000; // API polling frequency

Enable debug output by setting in files/stock_widget.cpp and files/clockify_widget.cpp:

const bool DEBUG_API_REQUESTS = true;

Monitor serial output at 115200 baud.

MIT License

• LilyGo for the T-Display AMOLED hardware and git repo
• LVGL team for the graphics library
• Financial Modeling Prep for stock data API
• Clockify for time tracking API