Skip to content

market-viewer/firmware

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Market Viewer

Firmware for the Market Viewer device.

readme-showcase

all_screens_cut.webm

Features

Screen Type Description
Crypto screen Displays any crypto ticker with chart and percentage change for specified time frame
Stock screen Displays any stock ticker with chart and percentage change for specified time frame
Clock Analog or digital clock, with any time zone
Stopwatch & timer Stopwatch and timer (up to 24h)
Home/settings Change brightness, volume, manage screens, set up Wi-Fi, reboot device, ...

Hardware & Setup

Setup device

  1. Download the .bin file from releases (firmware-merged.bin)
  2. Open any web app for code flashing eg. here
  3. Connect the device and the upload the firmware-merged.bin file and flash it
  4. Unplug and plug back in the device -> i will boot with the market viewer firmware

Connectivity & Configuration

The device connects to WiFi to fetch real-time market data. Configuration is handled through captive portal.

How to configure:

  1. Trigger the Wi-Fi portal directly from the device's touch screen.
  2. Connect to the portal and define the following parameters:
    • Wi-Fi Credentials: Your network SSID and password.
    • Backend URL: The address where your API is hosted (can be local ip or a custom domain).
    • Device Hash: A unique identifier generated by the API when you register the device.

Backend API Dependency

This firmware requires the Market Viewer API to get the data.

Hosting Options:

  • Self-Hosted (Recommended): The API is completely open-source. You can run it locally on your machine or host it your VPS.
  • Public Instance: You can connect to the public API at https://market-viewer.jotalac.dev/api/ (Note: Uptime and future availability are not guaranteed).

Bring Your Own Key (BYOK): The backend relies on third-party data providers (CoinGecko and TwelveData). You will need to create your own API keys for these services, both of which are free suitable for personal use.

About

Frirmware for market viewer device (esp32) - display crypto and stock prices

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages