Firmware for the Market Viewer device.
| 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, ... |
- Device: Waveshare ESP32-S3 Touch AMOLED 1.75" Display
- Enclosure: 3D-printed.
- Setup: Plug-and-play. No soldering or hardware modifications are required—simply upload the code to the device.
- Download the .bin file from releases (firmware-merged.bin)
- Open any web app for code flashing eg. here
- Connect the device and the upload the firmware-merged.bin file and flash it
- Unplug and plug back in the device -> i will boot with the market viewer firmware
The device connects to WiFi to fetch real-time market data. Configuration is handled through captive portal.
How to configure:
- Trigger the Wi-Fi portal directly from the device's touch screen.
- 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.
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.
