TVRaiser turns idle TV screens into ambient dashboards for the smart devices in your home or office. Check your coffee machine's brewing status, the weather, the time, notifications and charts at a glance, on a screen that would otherwise sit dark.
An ESP32 (or any device that can send an HTTP request) posts sensor data to a PHP backend. You design modular "cards" in a web admin UI, and a dashboard page renders them full-screen on the TV.
Project write-up: TV Raiser on Hackster.io
ESP32 / sensor --HTTP POST--> PHP backend (CodeIgniter) <--> Database
^
|
Admin frontend (create/edit cards) Dashboard (shown on the TV)
| Folder | Role |
|---|---|
Admin-frontend/ |
Web UI for creating and customizing cards |
Dashboard/ |
Full-screen display page that runs on the TV |
Database/ |
Database schema |
TVR4/ |
|
postdata.ino |
Example ESP32 firmware that POSTs sensor values to the backend |
- Modular, customizable cards
- Each card has: automatic ID, header, content, size, icon, animation and function
- Built-in functions:
- CoffeeStatus: machine status, description, level, temperature
- WeatherStatus: weather info, temperature, longitude, latitude
- TimeStatus: current time and date
- UpdateNotifications: notifications with timestamps
- CreateChart: charts with description, type, labels and values
- Tizen-compatible dashboard for Samsung smart TVs
- A web server with PHP (CodeIgniter-based backend) and a MySQL/MariaDB database
- Node.js and npm, if the frontend needs a build or dev server
- An ESP32 board and the Arduino IDE or PlatformIO, for the sensor side
- A TV or any screen with a browser
git clone https://github.com/migit/TVRaiser.git
cd TVRaiser- Create an empty database and a dedicated user.
- Import the schema from
Database/. - Put the connection details in the backend configuration.
npm install
npm startThen open http://localhost:3000.
- Open the admin frontend.
- Click Create New Card.
- Fill in the fields: header, content, size, icon, animation and function.
- Save, then open the dashboard URL in the TV's browser.
postdata.ino is a minimal example that POSTs a reading to the backend when a button is pressed.
- Copy the sketch and create a
secrets.hfile (do not commit it) containing your Wi-Fi name, password and the backend URL. - Set
post_urlto your server's sensor endpoint, for examplehttp://<server>/sensor.php. - Flash the ESP32 and press the button on pin 32 to send a test reading.
The example currently sends fixed values (temp=160&level=100%). Replace them with real sensor readings for your device.
- Never commit Wi-Fi credentials, API keys or database dumps containing real data.
- Use HTTPS and a per-device key for anything exposed beyond your local network.
- The example firmware uses plain HTTP and no authentication. It is meant for local testing only.
| Problem | Fix |
|---|---|
| Frontend fails to start | Run npm install again and check your Node.js version |
| Cards show wrong or stale data | Check the card's function settings and that the device is posting to the right URL |
| ESP32 can't reach the server | Check Wi-Fi credentials, that the server is reachable from the ESP32's network, and the URL scheme (http vs https) |
- Integration with more smart devices (thermostats, security systems)
- Custom functions and parameters
- Better data visualization (charts, graphs)
- MQTT support for device data
- Docker Compose setup for one-command installation
Bug reports and feature requests are welcome through GitHub issues. Please read CONTRIBUTING.md first, and submit changes as pull requests with a clear description.
To report a vulnerability, see SECURITY.md.
TVRaiser is licensed under the GNU General Public License v3.0. See License.md for details.