melihkoray.com

Projects

Phosphor: retro desk gadget firmware for the Waveshare ESP32-S3 bar display

Phosphor is free, open-source ESP32 desk clock firmware (GPL-3.0) for the Waveshare ESP32-S3-Touch-LCD-3.49, a 640×172 bar display. It adds a clock, weather, internet radio, timers, pixel scenes, three games and four retro looks. You install it from Chrome or Edge over a USB cable.

A 3D render of the Waveshare ESP32-S3-Touch-LCD-3.49 bar display board with a pink and purple clock on its long screen, running Phosphor firmware
Install
From the browser, over USB (Chrome or Edge)
Price
Free, open source (GPL-3.0)
Version
2.0.0
Contents 11 sections
  1. What Phosphor does
  2. Four looks: VFD, C64, Amiga and 2600
  3. Internet radio and alarm clock
  4. Weather and timers
  5. Pixel scenes to leave running
  6. Three games: 21, Lighthouse Keeper and Runner
  7. Small tools and settings on the board
  8. Install it from your browser
  9. The hardware: Waveshare ESP32-S3-Touch-LCD-3.49
  10. Open source and how it is built
  11. Frequently asked questions
The real board in my hand. Tilting it tilts the sea under the liner. open video

What Phosphor does

Phosphor turns the Waveshare ESP32-S3-Touch-LCD-3.49, a 640×172 bar display, into a retro desk gadget. It is a clock, weather, internet radio, timers, pixel scenes to leave running, three games and a few small tools.

Every page is drawn four times: as an old vacuum-fluorescent display (VFD), and in C64-style, Amiga-style and 2600-style looks. The current version is 2.0.0, under the GPL-3.0 license.

I bought this board to have a display on my desk, then ended up writing a whole piece of software for it. Phosphor is that software. If you want the full story of the hardware, I wrote it up in my Waveshare ESP32-S3-Touch-LCD-3.49 review.

  • Phosphor clock page in the VFD look on the Waveshare ESP32-S3 bar display: large cyan segment digits, the date, battery level and a pink alarm time.

    VFD clock

  • Phosphor fireplace scene in the C64-style look on the Waveshare ESP32-S3 bar display: a brick fireplace, a bookshelf, a window and a cat asleep on a rug.

    C64-style fireplace

  • Phosphor snowy cabin scene in the Amiga-style look on the Waveshare ESP32-S3 bar display: a log cabin with a lit window under a full moon and snowy mountains.

    Amiga-style snowy cabin

  • Phosphor lighthouse scene in the 2600-style look on the Waveshare ESP32-S3 bar display: a lighthouse on a rocky shore sending a checkered beam over a purple sea.

    2600-style lighthouse

Four of the looks on the real screen size (640×172) · open larger

Four looks: VFD, C64, Amiga and 2600

The scenes are redrawn in each machine’s resolution and colors, not just recolored. That means 16 colors on the C64, 32 out of 4096 on the Amiga and 4 per line on the 2600. You change the look in Settings > Theme on the board.

A grid of the snowy cabin, the fireplace and the weather page on the Waveshare ESP32-S3 bar display, each in four rows: VFD, C64-style, Amiga-style and 2600-style.
Same three pages, four machines. Look at how the cabin changes from the cyan VFD to the 4-colors-per-line 2600 row.Image: Melih Koray
The snowy cabin in the C64-style look. Tap or shake the board to stir the snow. open video

Internet radio and alarm clock

The radio page has up to seven genre buttons. Tap one to play, tap it again for the next station. The dancers and the equalizer move with the music, and you can hold them for another look.

You find stations on the settings page through Radio Browser, or paste your own stream (MP3 and AAC). If a station does not play, use Test on the settings page.

The radio page in the VFD look. open video
The same radio in the Amiga-style look, with a tracker pattern that runs with the music. open video

The clock page has big segment digits, the date, the battery level and a 12 or 24 hour display. The alarm wakes you with the radio. Tap the bell to switch it on or off, and tap the alarm hours (+1) or minutes (+5) to set it. So it works as an ESP32 alarm clock that plays your own station.

Weather and timers

The weather page shows now and the next three days for your city, from Open-Meteo (no key). Tap it for the days after.

The weather page in the C64-style look on the Waveshare ESP32-S3 bar display: 16 degrees, partly cloudy, 73 percent humidity, 14 km/h wind, big pixel clouds and a three-day forecast along the bottom.
Weather in the C64-style look: now, plus Monday to Wednesday along the bottom.Image: Melih Koray

The timer adds or removes 1, 5 or 10 minutes by touch, up to 99, and rings at the end. The focus timer runs Pomodoro rounds in a little study room.

The focus timer in the Amiga-style look on the Waveshare ESP32-S3 bar display: a person with headphones working at a laptop in a study room, and a 25:00 FOCUS timer with four round markers.
The focus timer page: a 25:00 round, with four markers for the rounds.Image: Melih Koray

Pixel scenes to leave running

These are the pages meant to be left running on the desk. Most of them react to touch or to the board’s motion sensor.

  • Fish tank: tap to feed, hold for night. Once a day a rare visitor.
  • Snowy cabin: tap or shake to stir the snow, hold for a snow globe. Holiday lights in winter.
  • Fireplace: a cat sleeps by the fire. Tap to wake it, tilt the board for a ball of yarn, hold to add a log.
  • Lighthouse: follows the time of day. Tap for a big wave, hold for a storm.
  • Ship: an ocean liner that tilts with the board. Hold for the fog horn. Now and then a whale.
  • Lava lamp (tap for new colors) and an hourglass you turn over by tilting the board.
The fish tank. Tap to feed them, hold for night. open video
The ocean liner. Hold for the fog horn. open video
The lighthouse follows the time of day. Hold for a storm. open video
The fireplace scene in the 2600-style look on the Waveshare ESP32-S3 bar display: a brick fireplace with a glowing fire, a window, a low shelf and a cat curled up on a round rug.
The fireplace in the 2600-style look. The cat is on the rug.Image: Melih Koray
Twelve Phosphor pages from the Waveshare ESP32-S3 bar display in a grid: fish tank, lighthouse, ocean liner, focus timer, clock and alarm, play menu, snowy cabin, hourglass, runner, tools, coin flip and settings.
Twelve of the pages, each with its gesture under it.Image: Melih Koray

Three games: 21, Lighthouse Keeper and Runner

21 is blackjack against a cartoon dealer, ten hands a match. You do not have to touch the screen. The board’s motion sensor feels your knuckles on the table: knock once to stand, twice to hit (or tap HIT and STAND).

21 against the dealer. Knock on the table to play. open video

Lighthouse Keeper is my own game in the style of the 1980s handheld LCD games. Ships head for the rocks in three lanes. Tap a lane to light it and turn the ship away. It has fixed segments with their faint ghosts, Game A and a faster Game B with more ships. Three misses and the night is over.

Lighthouse Keeper in its handheld LCD style. open video

Runner: tap the top of the screen to jump, the bottom to duck. There are archers, bugs, pits and ledges, and the scenery changes every 400 m. High scores are kept on the board.

Runner on the Waveshare ESP32-S3 bar display in the Amiga-style look: a white pixel runner on a desert at sunset with the score 00012 and a high score of 00688.
Runner in the Amiga-style look, score 00012, high score 00688.Image: Melih Koray

Small tools and settings on the board

The Tools menu has a spirit level (tap sets zero), a coin flip (tap or shake), box breathing (4-4-4-4), a scoreboard (tap +1, hold −1) and a screen lamp (tap for a color, swipe up or down for brightness). In any app or game, swipe sideways to go back to its menu. In a game, do that from the pause or title screen.

The Tools menu in the VFD look on the Waveshare ESP32-S3 bar display: five cyan tiles named LEVEL, COIN, BREATHE, SCORE and LAMP.
The Tools menu in the VFD look.Image: Melih Koray

Settings live on the board itself, on the last page. You get look, clock style, temperature unit, language (English or Turkish), brightness, city, auto page turn, holiday lights, night dimming and which pages show. There are help pages for every gesture, Wi-Fi (with a QR code that opens the settings page on your phone) and About, which shows the version and a note when a newer one is out.

The Settings page in the Amiga-style look on the Waveshare ESP32-S3 bar display: a menu with Theme, Clock, Units, Language and Brightness on the left, and AMIGA-STYLE selected on a blue background with arrows.
Settings on the board: here the Theme row, set to AMIGA-STYLE.Image: Melih Koray

Install it from your browser

You need the Waveshare ESP32-S3-Touch-LCD-3.49 and a USB-C data cable. The installer is a web page, so there is nothing to download and no toolchain to set up. It works in Chrome or Edge.

  1. Open the installer page, connect the board with a USB-C data cable, press Install Phosphor and pick USB JTAG/serial debug unit from the port list. It is cu.usbmodem… on a Mac, COMx on Windows and ttyACM0 on Linux. Not sure? Unplug the board and plug it back in: the entry that comes back is the board.
  2. The board restarts and shows a Wi-Fi name like Phosphor-Setup-1A2B and a QR code. Join it from your phone (no password) and a setup page opens. Pick your home Wi-Fi (2.4 GHz), type its password and set a short Device name such as desk. Tap Save and write the name down.
  3. With the phone back on your home Wi-Fi, open http://desk.local/settings, using your device name. There you set the city, the language, 12 or 24 hour, the focus timer minutes and the radio stations.

If the setup page does not open, or the browser shows normal websites, turn off mobile data and type http://192.168.4.1 in the browser. If your phone cannot open .local addresses (some Android phones do not), use the board’s IP address from Settings > Wi-Fi. The README’s troubleshooting section covers the rest, from cables that only charge to a forgotten device name.

Touch is simple. Swipe left for the next page and right for the previous one, up or down for the volume. Taps work the page’s own buttons. On the back edge there are three buttons: PWR turns the screen off and on (hold 3 s on battery to power off), BOOT changes brightness (hold 5 s to forget Wi-Fi and open the setup again), and RESET restarts.

The side of the Waveshare ESP32-S3-Touch-LCD-3.49 in its blue case, labelled BOOT, PWR and RESET for the three buttons, with the speaker grille and the dual microphone array.
The BOOT, PWR and RESET buttons, the speaker and the two microphone holes.Image: Melih Koray (3D model render)

The hardware: Waveshare ESP32-S3-Touch-LCD-3.49

Phosphor runs on one board only, the Waveshare ESP32-S3-Touch-LCD-3.49. It is a long, thin ESP32 touch display with audio, microphones, a motion sensor and a clock chip already on it. Phosphor uses the motion sensor for the knock-to-play 21 and the tilting scenes.

The board turning, with Phosphor cycling through its pages (3D render). open video

For the specs, the V1 and V2 difference, the pitfalls and how to program it yourself, read my Waveshare ESP32-S3-Touch-LCD-3.49 review.

Open source and how it is built

Phosphor is GPL-3.0 and the code is on GitHub. The v2.0.0 release notes list what changed in 2.0.0, with the fixes: four looks, a Play menu with three games, a Tools menu, settings on the board, scenes you can touch and a daily update notice.

The installer and the release files are built by GitHub Actions on GitHub’s servers, not on anyone’s computer. Since 22 Nov 2026 every build also gets a SHA256SUMS.txt and a signed build provenance attestation. To check that a .bin came from the repository, run this with the GitHub CLI:

gh attestation verify phosphor.bin -R melihkoray/phosphor

The v2.0.0 phosphor.bin scans clean on VirusTotal (0 of 61 engines).

There is no microphone code and no cloud account. The board talks to only these:

  • Open-Meteo for the weather.
  • NTP servers for the time.
  • The radio streams you choose.
  • The installer page, once a day, to read the latest version number.

To build it yourself you need arduino-cli and the ESP32 core, and ./build.sh compiles it. The README has the exact commands.

The pictures behind the scenes in the C64-style, Amiga-style and 2600-style looks were generated with an AI image model, then cut down to each machine’s resolution, palette and color limits by a script in the repository. The 8×8 fonts are drawn for this project, with no ROM fonts copied. The looks are only in the style of those machines, and Phosphor is not affiliated with Waveshare.

Frequently asked questions

Which board does Phosphor run on?

The Waveshare ESP32-S3-Touch-LCD-3.49, a 640×172 bar display. It is the only board Phosphor is written for.

How do I install Phosphor?

Open the installer page in Chrome or Edge, connect the board with a USB-C data cable, press Install Phosphor and pick the USB JTAG/serial debug unit port. No other tools are needed.

Do I need an account or a cloud service?

No. There is no cloud account and no microphone code. The board talks to Open-Meteo for weather, NTP servers for the time and the radio streams you choose, and once a day it reads the latest version number from the installer page.

Where does the weather come from?

From Open-Meteo, which needs no key. You search for your city on the settings page, and weather and the time zone follow it.

Which radio streams does it play?

MP3 and AAC streams. You can search stations through Radio Browser on the settings page or paste your own stream URL, and test it on the device.

Is it open source and safe to flash?

It is GPL-3.0 and the code is on GitHub. The installer and release files are built by GitHub Actions with a signed build provenance attestation, and the v2.0.0 phosphor.bin scans clean on VirusTotal (0 of 61 engines).

Does installing erase the Waveshare factory demo?

Yes. Installing replaces whatever runs on the board, the factory demo included. It is not backed up and Phosphor cannot restore it.

How do I update from v1.0.x?

Install once more from the installer page over USB and leave Erase device unticked. The flash layout changed, so this step cannot happen over Wi-Fi. Your Wi-Fi, city, stations and other settings are kept.

Which languages does the board speak?

The screen texts come in English or Turkish. You choose the language in the settings on the board or on the settings page.

Sources

Written by

Melih Koray

Started with an Atari 2600 in 1984 and has worked in design and tech for forty years. Eight years as Senior Graphic Specialist at McKinsey & Company, now design and web optimization at Firefly. Has taught SEO, software and design in more than a hundred classes.