A round knob remote for Music Assistant, on the CrowPanel 1.46″

I wanted a small, dedicated controller for Music Assistant: something on the shelf that shows what is playing, turns the volume with a real knob, and starts a radio station without reaching for the phone. The Elecrow CrowPanel 1.46″ round display turned out to be a perfect fit, so I wrote an ESPHome firmware for it. The configs are now public in anabolyc/esphome-configs.

The hardware

The CrowPanel 1.46″ (SKU DHR55146D) is an ESP32-S3R8 with 16 MB flash and 8 MB octal PSRAM, a 360×360 round LCD, a rotary encoder with a push switch around it, and a capacitive touch panel. It is a ready-made, USB-powered device, so there is no soldering involved: flash it and put it on a shelf.

What it does

The remote joins Music Assistant as a Sendspin client. It plays no audio itself; it follows the group it belongs to, shows what is playing and controls it.

  • Now playing with full-screen 360 px cover art and a cross-fade between tracks, and a clock when nothing is playing
  • Browsable lists: 46 SomaFM channels with their logos, BBC shows from the Music Assistant library, and a list of ambient scene automations. Selecting one starts it through Home Assistant
  • A lights screen with a 16-colour grid, on/off and brightness
  • Back to the player after 60 seconds without input

Knob and touch

The knob and the touch panel drive the same actions, so you can use whichever is closer to hand:

InputPlayerListLights
Turn knobvolumemove the selectionprevious / next colour
Press knobplay / pauseplay the selected itemlights on / off
Hold knobnext screennext screennext screen
Swipe left / rightprevious / next screenprevious / next screenprevious / next screen
Swipe up / downvolumevolumebrightness

Screens form a cycle: player, each list, the lights screen, and back to the player. Swiping wraps at both ends, so one swipe back from the player opens the last screen directly.

Under the hood

  • The panel needed its own init sequence. The display is a JD9855 driven with the ST77961 register set, which ESPHome has no model for. The init_sequence is converted from LovyanGFX’s Panel_ST77961.
  • Pins come from the schematic, not the example sketch. The comment on the touch controller in Elecrow’s sketch has the reset and interrupt lines swapped.
  • The list is virtual. Five fixed LVGL rows are refilled as the selection moves, so a 46-station list costs no extra display memory.
  • Gestures come from raw touch events rather than LVGL’s swipe handlers, so they work on every page without changing any page definition. All thresholds are substitutions.
  • It is a port of the square 240×240 Sendspin remote from esp8266-radio-box, with four buttons mapped onto one knob.

Not there yet

  • Previous / next track and seek. On the button remote these were a double click and a long press, which a single knob can’t offer. A spare touch gesture is the obvious home for them.
  • Deep sleep. None of the knob pins can wake an ESP32-S3, so only the backlight switches off. Waking on touch is possible, since the touch interrupt is on an RTC pin.
  • The 8-LED ring and the spare I²C connector are on the board but not used yet.

Make it your own

A starting point, not a finished product. These configs are written for my own home, so expect to adjust them for yours. Each feature is a separate package, so if something doesn’t apply to you, you can drop it. The station and scene lists go with just their !include line. The lights screen needs one more step: its swipe bindings in touch-actions.yaml have to go too. Every package lists what it depends on at the top of the file. The goal is to give you a solid base to build your own remote on, not a ready-made device.

You need ESPHome 2026.9.0 or newer. For the packages you keep, change at least the player the knob resumes (sendspin_resume_entity), the lights, and the scene automation IDs. The README lists them all.

One thing that will save you some head-scratching: in Home Assistant, enable “Allow the device to perform Home Assistant actions” for the remote. Without it, selecting a station looks like it does nothing at all: the action is never sent, and the loading spinner just times out.

More from the same repository

The knob remote isn’t the first device in my house to get this treatment. The same repository holds two earlier ones:

  • A Logitech Pure-Fi dock with its electronics replaced by an ESP32 and a small TFT screen. It is now a Sendspin network speaker that shows the cover art and the weather forecast, and it still works with the original IR remote.
  • The ESP8266 LED matrix clock, now on ESPHome and connected to Home Assistant. Between the time it shows the date and the outside temperature with a weather icon, and a “kids mode” switch shows a sleeping face at night as a stay-in-bed signal.

Everything is open source under GPL-3.0. If you build one, or port it to another round display, I would love to see it on Discord.


Comments

Leave a Reply