Utility to submit listens to ListenBrainz done with a dumb radio receiver
LB Radio is a utility to submit your radio listening activity to ListenBrainz.
Since most dedicated radio receivers (i'm not talking about web radio applications or Websites for listening to Internet radio streams) are dumb devices without internet connection there is no good way to submit listens done with them.
This is where this project kicks in: When turning on the radio receiver, you can search for the radio station on here and click "Start listening". All songs this radio station is playing are now submitted to ListenBrainz until you click "Stop listening" again.
The project is not yet finished, it's a WIP. It also isn't hosted somewhere to try it out (yet).
When i have time and feel like working on the project i will continue with it, otherwise it may never get finished and hosted somewhere.
- report issues and missing features
- help fixing reported issues via pull requests
- help adding new features via pull requests
Project consists of a front-end in plain HTML and JS and a back-End NodeJS Server (mostly due to the fact that most internet radio streams don't implement CORS or don't allow every site).
The Back-End Server's Job is to query the web radio Stream URL for Metadata and deliver what was found to the front-end.
The front-end does everything else: Look up radio stations and their Stream URLs in the RadioBrowser API, process the metadata string from the stream server to split it up into an artist and title part, periodically query the Back-end server for metadata, ...
Prerequisite to the following steps is a working NodeJS setup on your machine.
To start the development on this project, clone this repository to your machine first.
After that, cd into the repository's root directory and install the dependencies by
npm installAfter that you can modify the source files of the project, compile it and start the server to see if the changes you made had the desired effect.
The project is using Webpack to bundle the front-end. After modifying the source files, you can compile by running
npm run buildTo start the NodeJS server, run
npm run serveLicenses of third party packages can be obtained with the help of the NPM package license-checker as follows:
npx license-checkerAdditionally, a modified copy of the npm package icecast-metadata-stats (Licensed under LGPL 3.0 or later license, © 2021 Ethan Halsall) is used.
The modifications include, but may not be limited to:
- make the package work on NodeJS rather than on browser
- add support for another stream service: StreaMonkey
To view all modifications that were made, compare this file with the original file, either by downloading both and comparing locally, or by using an online service like DiffNow.