Skip to main content

Play radio. Style your App.

Project description

Eisenradio - Web radio DB / Media-player

alt logo of eisenradio Tests


This repository shows the full stack source code of an SVG animated GUI for GhettoRecorder.

  • first internet Radio App that can run a Spectrum Analyser in a Browser (Feb,2022), sketch at page bottom
  • SVG animations in vanilla JavaScript super fast animated and colorized with regex
  • Playlist feature; load and walk through a list of your local sound files
  • REST API Flask endpoints; serve a SQLite database in plain SQL
  • deployment source code for Android Studio , Docker, Snapcraft and Kivy available


The initial design was intended to mimic a hardware store site with multiple items listed. "Eisen" Hardware [iron radios].

Comic style animated internet radio

Inkscape created SVG images are used everywhere in the app. No raster graphics in this project. Except converted from SVG.

  • 90% of the SVG animations run on canvas for reduced CPU load and smooth, up-scaled display
  • a dedicated multi SVG image and SVG group loader class to preload all SVG stuff as super correct tagged SVG images
  • inline SVG groups are loaded into a dictionary of image instances and connected to their canvas
browser android
browser tux at daylight
browser tux at night
  • each instance stores the image, a list of its SVG tags as well as the current transformation status and position, ...
  • SVG path manipulation method with regex

The functional principle can be transferred to Java on Android to create dynamic 2D game backgrounds.


Audio spectrum is used to animate the colors of the speaker symbol waves. Speaker symbol shows customized colors for different levels of audio output strength and dynamic. Unfortunately the display is very CPU hungry. So only one speaker is shown.

Classic and Ambient 🟦🟩 music will often show other colors than Thrash Metal or Hip Hop 🟧🟥.

Master function getAverageVolume() calculates the audio volume level. This function was created by "franks laboratory", link in the Thank-you section at bottom.

The "scaling by rhythm" of frontman Tux and friends 🐧 🐱 🐻 is also driven by


Local audio and shuffled playlists

A local folder with files of different sound file types is called a playlist. AAC and MP3 files are known to run. You can go back and forth in the list.

If AAC is hanging, you can repair the whole folder with "Tools/aacp file repair" menu. Integrated from my aacRepair repo.

Remember, the app runs in a browser. We misuse the upload multi select feature of the browser. Nothing is uploaded, but file objects are caught in a list and played.

Gain - preamp

Bring your earbuds to the limit. EisenRadio owns a Volume Gain slider as well as GhettoRecorder Push the preamp to 300%. This feels like 20% louder.

Works with bluetooth headphones!

Spectrum Analyzer

Spectrum analyzer canvas is now fully integrated and can be switched by the "TV" button. Choose between different spectrum analyzer shows.

This concept can show its strengths if used to present the latest management reports. A background video on canvas one and several statistics shown on separated, animated, or distorted monitors, canvas of course.

Spectrum Analyzer one Spectrum Analyzer two

Customized radio

"Edit" the radio settings. Upload your favorite pictures to the database. Add a comment.

The app page is separated by two areas. A monitor to the left and a display area beside for pictures and comments or the playlist titles.


Energy Saver

Sustainable fun reduction. Some exotic browser and mobiles could be overwhelmed by the fully animated show.

You are compensated by a CPU icon that can change its color.

fun reduction energy saver radio button


Called and terminated GhettoRecorder threads for listen and record.

This version suffers from the initial button press concept. Next version of EisenRadio will use the latest GhettoRecorder for easy-peasy internal switching.

Recorder blacklist feature

Each recorder refuses to write a file, if the title was written to its radio specific blacklist before.

One dedicated thread is responsible to update all radio blacklists. All lists can be dumped into a JSON file and merged with GhettoRecorder blacklists. Uploaded to DB then.

EisenRadio writes temporary lists of known recorded file names in JSON format. The SQLite database is updated with a fresh file name only if a recorder writes a new file. An internet cloud connection count in mind.

Multiple tools menu

  • config with feature selection for animation level
  • enable and maintain blacklists
  • dump the radios or blacklist database to JSON files
  • import a GhettoRecorder settings.ini file to database to add more radio station URLs
tools for blacklist database dump and deletion config show blacklist show


Use the menu bar. About offers a help menu.

There is a "post-it", how to reveal the URL of your beloved radio station, hidden in an advertisement polluted website.


The app is available as

Command line

EisenRadio GUI supported by Flask server.

$ eisenradio  # executable script in Python Path
$ python3 -m eisenradio.gui  # runs package if Python path is defective or the SNAP pkg installer knows eisenradio

Export / Import of GhettoRecorder in- and output files

Eisenradio stores radio names and URLs and blacklists in its database.

You can export for GhettoRecorder settings.ini and blacklist.json from database. Tools/Export/Names and URLs menu.

GhettoRecorder created blacklist.json can be imported into your database.

Eisenradio - the boring details

  • REST API app on blueprints and ApplicationFactory of the Flask microframework with a SQLite database

  • First Internet Radio App that can run a Spectrum Analyser in a Web browser (Feb,2022)

  • A local Python Flask Web Server connects to the radio server in behalf of you. Your browser connects to Flask

    • Backend (server) opens the connection, buffers the radio stream and presents it to localhost IP:
    • Frontend (browser) controls the backend, plays internet and local audio playlists
    • Browser audio element connects http://localhost:5050/sound/classic that streams
    • Closing the browser does not disconnect the server listen (buffer discarded) nor streaming connections
  • Plays and repairs aac plus files; play (1.3), repairs since version (1.4);

  • Backup and restore are easy work with the help of an optional ex/imported human-readable *ini file

  • Blacklist feature for recorded files (titles); delete only once

    • lists can be ex/imported via a json dictionary file to other devices
  • playing local audio uses the web server multiple file upload feature

  • Multithreading allows you an unlimited number of radio connections at the same time, until the ISP Bandwidth limit hits

  • Android APK Package uses Python Kivy for multi touch and promotes the app to "foreground service" (to not get killed)

       """ sketch """
       |B |               |S | Flask web server, Header[Werkzeug/2.0.2 Python/3.10.1]
       |r |listen         |e |-------> starRadio
       |o |------->   <-- |r |
       |w |GhettoRecorder |v |-------> planetRadio
       |s |--->    <----- |e |
       |e |               |r |-------> satelliteRadio
       |r |               |  |
       net: localhost     net: internet
       CORS: accept       CORS: deny
       audioNode: 1,-1    audioNode: 0, 0
       JavaScript,CSS     Python,SQL

    Cross-Origin Resource Sharing mechanism (CORS) i.a. prevents a Browser from analysing audio from internet

pip install

$ pip3 install eisenradio  # Tux
> pip install eisenradio  # M$

Pytest and tox

Part of the test automation with flake8 and tox on GitHub

$ tox


Python user:

find the module location
uninstall and then remove remnants

$ pip3 show eisenradio

$ pip3 uninstall eisenradio

Location: ... /python310/site-packages

Sphinx Documentation

Known issues

Detected problems got a "todo" marker. You can search through the project to see what is going wrong.


Pull requests are welcome. If you want to make a major change, open an issue first to have a short discuss.

Next level could be Blender 3D objects rendered as 2D SVG in JavaScript motion. Replace pure DOM element animation with canvas. Each animation gets its own canvas for more speed and to lower CPU.

Thank you

YouTube franks laboratory



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eisenradio-2.4.2.tar.gz (2.4 MB view hashes)

Uploaded source

Built Distribution

eisenradio-2.4.2-py3-none-any.whl (2.4 MB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page