Skip to content

Latest commit

 

History

History
45 lines (34 loc) · 1.73 KB

README.md

File metadata and controls

45 lines (34 loc) · 1.73 KB
Raw

RoboRadio

What is this

A Rust implementation of https://radio.pavonz.com (originally built with Elixir and Phoenix, still not open sourced yet). It works like a real radio: you turn it on (well, in this case, you open the web page) and you'll listen what's being played at the exact point. The radio goes on automagically.

How it works

RoboRadio loads a playlist from https://soundcloud.com, shuffles the tracks, for each one it will play the song and notify the connected users through websockets. When the songs in the playlist have been all played, it reloads and shuffle the tracks again.

How to run RoboRadio

Locally

  • clone the repository and run: 
    $ cd frontend && npm install && cd ..
$ cargo make frontend
$ cargo run
  • or use the Dockerfile.default to build a container and run it throught Docker (or Podman). The app will listen on port 8080. There's a .env.dist file with usable ENV settings.

Deploy

Use the Dockerfile included in this repository for a basic deploy, or adjust if needed. After some weeks of testing, I decided to deploy as the official RoboRadio in place of the Elixir one.

Current status

  • add soundcloud API client
    • fetch playlist info
    • fetch track info
    • fetch track stream
  • media player
    • load playlist and randomize its tracks
    • rotate to next track (or reload playlist again)
  • http server
    • wrap app-state
    • serve static assets
    • websockets
      • keep track of current listeners
      • broadcast new track when last one's duration has elapsed
  • logging/tracing
  • improved error handling (anyhow + thiserror ?)
  • auto-update soundcloud's client_id
  • testing (mocks for external API calls)