Skip to content
All devices

Which AWTRIX do you have?

The Hub then shows only what runs on it.

Show

Devices

Sign in

New Share your ideas with the AWTRIX community. Keep your creations together in your account.

Sign in

Which AWTRIX do you have? Choose it once and the Hub shows what runs on it.

ScriptAWTRIX NG

SomaFM Radio

by RumbleInTheJungle5 Nov 2026
On an AWTRIX display
SomaFM Radio shown on an AWTRIX display
SomaFM Radio · by RumbleInTheJungle

On your display

Listen to SomaFM on your TC002's own speaker and see what's playing on the 52×16 display.

Which AWTRIX do you have? See below where it runs, or choose your device.
Topic
Multimedia
Includes
Script

Runs on

  • Does not run on 32×8 (TC001 & DIY) Made for 52×16 (TC002).
  • Runs on 52×16 (TC002)
  • Does not run on 32×8 with AWTRIX 3 (TC001 & DIY) Made for AWTRIX NG.

Choose your display in the next step.

↓ Download script
Send to AWTRIX

Choose your AWTRIX

SomaFM RadioAWTRIX NG script

Install this script on your AWTRIX NG. Its icons and sounds are installed with it.

Your AWTRIX’s local address, for example 192.168.178.39 or awtrix.local.

The name shown in your AWTRIX script list. Use letters, digits, hyphens or underscores.

Connection & device login

Connect your phone or computer to the same network as your AWTRIX. Allow local network access if your browser asks.

Use the device’s IP address, without a page path such as /#/apps.

If your AWTRIX requires a login, the username and password fields will appear when you connect.

Sign in to the Hub to install scripts. Attached files are installed separately.

Script description

Listen to SomaFM on your clock's own speaker and see what's playing. Pick a channel with the knob, then read the channel, artist and title in the normal rotation.

Setup

  1. Install the script. No other scripts or accounts are needed, only a Wi-Fi connection.
  2. Keep it active in the rotation.
  3. When Radio off / turn knob appears, turn the knob to start your first channel.

Controls

Knob What it does
Turn Moves through Radio off → ★ favourites → all channels. What you stop on plays after 0.6 s
Press Turning sets the volume, until you stop for 2 s
Hold Adds or removes the ★ favourite

The knob works while the app is on screen. The left, right and select buttons keep their normal functions.

To stop the radio, turn to Radio off.

Good to know

  • While SomaFM plays, the app takes a normal turn in the rotation.
  • While the radio is off, it takes a 4-second turn so you can start it with the knob. To keep it out of the rotation, turn off Show when radio is off in the script's settings. You can then start it with Show on the Apps tab.
  • While the app is on screen, the knob doesn't change brightness or the clock's volume.
  • If you have version 1, delete the old SomaFM tuner and somafm_lib after updating.
  • To refresh the channel list after SomaFM adds or removes a channel, turn on Update channel list in the script's settings and save. It turns itself off again.
  • You can also save SomaFM channels as stations in the Radio settings. Name them exactly like the channel (for example Groove Salad), or include "SomaFM" in the name, so the app recognises them.

Requirements

An AWTRIX NG Ulanzi TC002 with a 52×16 display. Tested on firmware 1.2.3.

About

Unofficial hobby project, not affiliated with or endorsed by SomaFM but used with their permission. SomaFM is listener-supported, so please support them if you enjoy it.

SomaFM's streams and data are not free to use in other apps, and this permission doesn't carry over to forks. Read their Terms of Service before building on this code. Source code on GitHub

More scripts in Multimedia

Something wrong with this script? Report it.