stream internet radio from norns

inspired by @mlogger 's idea from the lines thread - "norns ideas"

* visit llllllll.com/internet-radio for discussion, ideas, and help

requires internet connection and mpv - not installed by default
- disclaimer: this script, unlike most other scripts, internet-radio requires adding not only mpv, but also its dependency packages to your norns. doing so has the potential to cause unforeseen issues down the line with norns updates as your system would deviate from the base norns image.

to install this script, enter the following into maiden:
- ;install https://github.com/tapecanvas/internet-radio
to install mpv on your norns (required), use one of the methods below:
- install mpv from maiden:
  - in maiden,
    - run os.execute('sudo apt -y update') before installing mpv (refreshes package list) - no need to upgrade
    - then enter os.execute('sudo apt -y install mpv')
    - enter 'Y' when prompted and then hit 'enter' to continue the installation
    - will take a minute or so to install
    - if successful, you should see something like true exit 0 and <ok> in the matron window in maiden
- or install mpv over ssh
  - ssh into norns ssh we@norns.local
  - run sudo apt update to refresh package list
  - run sudo apt install mpv
  - press enter when asked if you want to continue with install
  - wait for the install to complete (will return to prompt after successful install)
*the order that you install internet-radio and mpv does not matter
restart your norns after both internet-radio and mpv have been installed

controls:

if you aren't hearing anything, make sure your monitor and input volumes in norns mixer are turned up!

main controls:

e2 - scrolls through list of streams
e3 - favorites/unfavorites a stream
k3 - plays stream
k2 - stops playback

params menu:

stream list - choose a file containing a list of links to internet streams
exit option - how should mpv behave when you select another script?
- close (default) - kill mpv if another script is selected
- open - leave mpv running to run through effects scripts, etc
*pitch - adjust the pitch (and speed) of the stream (requires restarting stream to hear effect)
*speed - adjust the speed of the stream without altering pitch (requires restarting the stream)
- *pitch and speed are not real-time controls, they insert their values into the mpv play command
- *the stream will need to be re-started to hear the effect of changes to pitch and speed
  - the way mpv scaletempo works is weird and the documentation for it is even stranger.. (still trying to wrap my head around it honestly)
  - the pitch param mostly does pitch, but also speed.
  - the speed param works as expected + or - with pitch left untouched
  - *since streams are broadcast in real time, increasing speed or pitch will cause gaps in audio while the stream catches up, you can work around this in creative ways though, experiment

add your own streams:

DO NOT edit /code/internet-radio/lib/ files! This folder only exists to easily package/update the default stream lists with the script changes made to it will prevent updating the script from Maiden

direct your browser of choice to maiden (http://norns.local/maiden/ or yournornsip/maiden)
go to the /data/internet-radio/streams/ directory in the left side pane
copy and rename template.lua or create your own filename.lua list
follow the format:

return {
{name = "stream name", address = "streamurl"},
{name = "stream name", address = "streamurl"},
}

make a m3u stream of your tape folder:

also works for any other folder containing audio on your norns

in the data/internet-radio folder in maiden and make a new file
add the following lines inside that file:

#EXTM3U
/home/we/dust/audio/tape/

if you want to use a folder other than tape, use that folder name instead

save the file as yourfilename.m3u
then go to the "streams" file you want to add your tape stream to (can be one of the default streams lists, or make a new one based off the included template)
add the following line to the streams file:
{name = "tapestream", address = "/home/we/data/internet-radio/yourfilename.m3u"},
reload the script and navigate to your newly updated stream file and listen to an endless stream of your tape folder!

supported stream formats:

MPV uses ffmpeg to decode everything, so any streaming format that ffmpeg supports should work.

you will mainly see .m3u .mp3 and .pls streams

stream sources:

Live ATC - air traffic control streams
SomaFM
NTS + a little dev tools snooping
radio aporee
radio-browser - lil bit of everything
demoscene and video game music stream links
railroadradio.net
all BBC streams
eclectic streams
github.com/mikepierce/internet-radio-streams
streamfinder.com
github.com/junguler/m3u-radio-music-playlists
github.com/mcplayer9999/radio-garden-m3u
gist.github.com/spence-man/internet-radio-streams
internet-radio.com
Broadcastify - emergency, rail, and aviation feeds - these usually have annoying ads when you first tune in..
and countless others if you're interesting in hunting for them

community streams:

if you make a custom list of streams that you want to share, submit a pull request to this repo and I will include it in the project for others to use!

to-do:

favorite selection control needs work still
add loop flag to mpv play call (not needed for typical streams, but for tape stream, or other non-infinite stream sources it would be nice to have)
bug fix: play icons sometimes show when they shouldn't
detach mpv activity from terminal - currently makes glitchy beep sound when switching streams if I try to do this with --no-terminal
look into making this a mod (would be much easier to switch streams when processing audio through other scripts if it was a mod)
beta test phase (currently)
look into radio garden api
demo video
add to norns.community when v1.0.0 is ready

tapecanvas/internet-radio

stream internet radio from norns

* visit llllllll.com/internet-radio for discussion, ideas, and help

controls:

main controls:

params menu:

add your own streams:

make a m3u stream of your tape folder:

supported stream formats:

stream sources:

community streams:

to-do:

archive: