Skip to content

caranha/radico8

 
 

Repository files navigation

radico8

radico8 is both a youtube stream and web radio that plays pico-8 music.

submitting songs

if you know some good pico-8 music, submit a pull request adding the lexaloffle cart-id and track to the playlist.txt file.

issues

you can submit a github issues for issues with the stream, feature suggestions, and bugfixes.

youtube changes the video url everytime the stream goes down unless you use the link at the top of this document. so make sure you bookmark that link.

giving credit to the actual artist of a song is a manual process. if a song is attributed to the wrong user please submit a pull request with the fix in the playlist.txt file.

how it works

  • a headless instance of pico-8 is running inside a docker container.
  • pico-8 listens on stdin to figure out which carts it should play next.
  • a shell script listens on stdout of pico-8 to produce the youtube video image.
  • ffmpeg listens to any audio produced in the docker container and forwards it to icecast and youtube.
  • a cron job runs every hour to load playlist updates into the radio.
  • carts are downloaded as p8.png images directly from lexaloffle.
  • the pico-8 console is rebooted every monday and whenever i push code updates.

behavior

  • a song will play until it stops or for about 10-15 seconds after it starts repeating.
  • the max length a single song can play is about 7 minutes, before radico8 will end the song.
  • radico8 shuffles the entire playlist then plays songs until every song has been played.

credits

legal stuff

please don't sue me. i'm not that rich anyways, so it's probably not worth it. if you're the author of a song and you'd like it removed from the radio, just submit a pull request to remove that song.

this repo is licensed under CC4-BY-NC-SA because most pico-8 games use that license too.

About

A pico8 web radio.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 62.6%
  • Lua 35.3%
  • Dockerfile 2.1%