explaingit

kalykulam/safe-somafm

Analysis updated 2026-05-18

0PythonAudience · generalComplexity · 2/5LicenseSetup · moderate

TLDR

A Home Assistant add-on that streams SomaFM internet radio reliably, with a security-focused, credential-free design.

Mindmap

mindmap
  root((Safe SomaFM))
    What it does
      Streams SomaFM radio
      Fixes stream drop bug
      Adds dashboard card
    Tech stack
      Python
      Home Assistant
      HACS
    Use cases
      Listen to SomaFM at home
      Add radio card to dashboard
      Long uninterrupted listening
    Audience
      Home Assistant users
      Smart home hobbyists
    Security
      No credentials needed
      Validated station URLs
      No shell execution

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Play SomaFM internet radio stations through your Home Assistant dashboard.

USE CASE 2

Add a compact radio player card to a smart home dashboard.

USE CASE 3

Listen to long, uninterrupted radio sessions without the stream dropping.

USE CASE 4

Launch the full radio player from the Home Assistant sidebar in one click.

What is it built with?

PythonHome AssistantHACSJavaScript

How does it compare?

kalykulam/safe-somafm0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity2/52/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an existing Home Assistant setup plus HACS or manual file copying, then a full restart.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Safe SomaFM is a custom add-on for Home Assistant, the popular home automation platform, that lets you listen to SomaFM internet radio stations directly from your smart home dashboard. SomaFM is a well known online radio service with many curated music stations, and this integration brings those stations into your Home Assistant setup. The project exists to solve a specific annoyance: when Home Assistant's built in media browser played SomaFM streams directly, some web browsers would stop the stream after a few minutes. Safe SomaFM instead uses its own local player page with automatic reconnect handling, which the author reports works reliably for long listening sessions. Once installed, you get a full player page showing station artwork, a searchable grid of stations, details like genre and current listeners, and options to pick stream quality. There is also a compact version meant to fit neatly into a dashboard card, and a sidebar shortcut that opens the full player in a new browser tab. The integration is designed to be installed through HACS, a popular community add-on manager for Home Assistant, though manual installation by copying files into the configuration folder is also supported. The README places a strong emphasis on security. It states plainly that the integration does not handle user credentials or secrets, does not run shell commands, does not accept arbitrary stream URLs, and only opens its own local player endpoint. Station IDs and playlist URLs are validated to make sure they actually point to SomaFM. The project has gone through several small version updates focused on fixing packaging and validation issues for HACS and Hassfest, the tools that check whether a Home Assistant integration is set up correctly, rather than changing how playback itself works. Safe SomaFM is released under the MIT license, a permissive license allowing free use, modification, and redistribution, including commercially, as long as the copyright notice is kept. It is not affiliated with SomaFM or Home Assistant.

Copy-paste prompts

Prompt 1
Walk me through installing Safe SomaFM as a custom repository in HACS.
Prompt 2
Explain how to add the Safe SomaFM Lovelace card to my Home Assistant dashboard.
Prompt 3
Show me how this integration avoids needing user credentials or secrets.
Prompt 4
Help me troubleshoot the Safe SomaFM sidebar item not appearing after install.

Frequently asked questions

What is safe-somafm?

A Home Assistant add-on that streams SomaFM internet radio reliably, with a security-focused, credential-free design.

What language is safe-somafm written in?

Mainly Python. The stack also includes Python, Home Assistant, HACS.

What license does safe-somafm use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is safe-somafm to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is safe-somafm for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.