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

49 lines
1.4 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.
It adds metadata to the stream so that media players can display it.
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
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
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
Streams have URLs in the following form:
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
$ mpv http://localhost:8000/nonuk/sbr_low/bbc_radio_one
$ mpv http://localhost:8000/uk/sbr_high/bbc_1xtra
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.