p
/
bbc-on-ice
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
bbc-on-ice/README.adoc

56 lines
1.7 KiB
Plaintext
Raw Normal View History

Initial commit A half-working prototype.
2016-10-20 13:15:38 +02:00
bbc-on-ice
==========
'bbc-on-ice' is a SHOUTcast (ICY protocol) bridge for BBC radio streams.
Update README
2018-11-03 01:57:59 +01:00
It adds metadata to the stream so that media players can display it. There are
some inherent technical limitations to how accurate the information can be
but it's definitely better to have an approximate title than nothing.
Initial commit A half-working prototype.
2016-10-20 13:15:38 +02:00
Packages
--------
Regular releases are sporadic. git master should be stable enough. You can get
Update README
2018-06-24 03:04:09 +02:00
a package with the latest development version from Archlinux's AUR.
Initial commit A half-working prototype.
2016-10-20 13:15:38 +02:00
Building and Running
--------------------
It's about time to make this work Luckily BBC is /still/ using HLS for their streams, and even the external metadata format hasn't changed.
2018-10-01 00:36:49 +02:00
Build dependencies: go
Initial commit A half-working prototype.
2016-10-20 13:15:38 +02:00
It's about time to make this work Luckily BBC is /still/ using HLS for their streams, and even the external metadata format hasn't changed.
2018-10-01 00:36:49 +02:00
$ git clone https://git.janouch.name/p/bbc-on-ice.git
$ cd bbc-on-ice
$ go build
Initial commit A half-working prototype.
2016-10-20 13:15:38 +02:00
Make this thing work again
2024-02-11 09:06:16 +01:00
or, if you know what you're doing:
$ go install janouch.name/bbc-on-ice@master
It's about time to make this work Luckily BBC is /still/ using HLS for their streams, and even the external metadata format hasn't changed.
2018-10-01 00:36:49 +02:00
To run the local server:
Initial commit A half-working prototype.
2016-10-20 13:15:38 +02:00
It's about time to make this work Luckily BBC is /still/ using HLS for their streams, and even the external metadata format hasn't changed.
2018-10-01 00:36:49 +02:00
$ ./bbc-on-ice :8000
Initial commit A half-working prototype.
2016-10-20 13:15:38 +02:00
Make this thing work again
2024-02-11 09:06:16 +01:00
Streams have URLs in the following form, derived from
https://gist.github.com/bpsib/67089b959e4fa898af69fea59ad74bc3[this list]:
Initial commit A half-working prototype.
2016-10-20 13:15:38 +02:00
Make this thing work again
2024-02-11 09:06:16 +01:00
$ mpv http://localhost:8000/ww/96000/bbc_radio_one
$ mpv http://localhost:8000/uk/320000/bbc_1xtra
It's about time to make this work Luckily BBC is /still/ using HLS for their streams, and even the external metadata format hasn't changed.
2018-10-01 00:36:49 +02:00
Socket activation
-----------------
The provided bbc-on-ice.service and bbc-on-ice.socket should do, just change
the `ExecStart` path as needed and place the files appropriately. Then:
$ systemctl enable bbc-on-ice.socket
$ systemctl start bbc-on-ice.socket
Initial commit A half-working prototype.
2016-10-20 13:15:38 +02:00
Contributing and Support
------------------------
Update README
2017-12-02 13:19:34 +01:00
Use https://git.janouch.name/p/bbc-on-ice to report any bugs, request features,
Update README
2018-06-24 03:04:09 +02:00
or submit pull requests. `git send-email` is tolerated. If you want to discuss
the project, feel free to join me at ircs://irc.janouch.name, channel #dev.
Bitcoin donations are accepted at: 12r5uEWEgcHC46xd64tt3hHt9EUvYYDHe9
Initial commit A half-working prototype.
2016-10-20 13:15:38 +02:00
License
-------
Relicense to 0BSD, update mail address I've come to the conclusion that copyright mostly just stands in the way of software development. In my jurisdiction I cannot give up my own copyright and 0BSD seems to be the closest thing to public domain. The updated mail address, also used in my author/committer lines, is shorter and looks nicer. People rarely interact anyway.
2018-06-24 03:03:51 +02:00
This software is released under the terms of the 0BSD license, the text of which
is included within the package along with the list of authors.