BBRF - Barebones radio with a fader

BBRF radio is a lightweight self-hosted service and frontend to interface with the open radio-browser api - a hosted service that serves metadata on all openly available online radios. To get started, Start up the server, or better yet host it on your network's raspberry pi or set it up as a systemd/launchd service. The app is served on port 3335 to be accessed on your browser.

Note about 0.6.0+ (breaking)

One of the query endpoints is broken upstream. This results in the favorites feature not working. Upgrading from 0.5.0 and prior releases will result in a backup of your old favorites and a new file with a compatible schema being created instead. You can find the backup file in XDG_CONFIG_HOME/bbrf-radio. You can reinstate your favorites manually if you want.

Quick start

• Build the app npm run build
• Start the service npm run start
• Run the development server npm run dev
• Optionaly add some radio stations to your favs list npm run defaults
• Default port to access the application is on localhost:3335
• You can also alias the bbrf server for easy scripting npm link
• You can change the binding port, or the fader value by updating/creating your $XDG_CONFIG_HOME/bbrf-radio/settings file.

{ "FADER_VALUE": 25, "PORT": 5555, "ITEM_PER_PAGE": 2000 }

Try out the project

Usage with nixos

This repo exposes a nix module as part of a flake. You can import it as one of your inputs if you use flakes to configure your system (systemd module on NixOs or launchd module on Mac). Otherwise you can just use the package exported as a standalone script that you can invoke in your own systemd module or however else.

{
  # your inputs
  #...
  inputs =
    {
      #...
      bbrf = "github:vhsconnect/bbrf-radio/master";
    };

  # then import it as one your modules
  outputs = inputs: {
    nixosConfigurations = {
      mySystem = inputs.nixpkgs.lib.nixosSystem {
        #...
        modules = [
          #...
          inputs.bbrf.nixosModules.${builtins.currentSystem}.bbrf
        ];
      };
    };
  };
}

then in your configuration activate it with the settings you prefer

{
  services.bbrf =  {
    enable = true;
    port = 3111;
    user = "username";
    fadeValue = 40; # how fast to fade between radios
    itemsPerPage = 2000; #Upper limit is 100000
  };

}

Contributing

You can run the application in development mode.

npm run dev