aboutsummaryrefslogtreecommitdiff
path: root/README.adoc
diff options
context:
space:
mode:
authorPřemysl Janouch <p.janouch@gmail.com>2016-10-20 13:15:38 +0200
committerPřemysl Janouch <p@janouch.name>2018-10-11 16:30:28 +0200
commit42a430345f8fd14e6aaa70cc2c6afd774dc85cfe (patch)
treed6e01446989187edebbea9f16f8947bad091f8aa /README.adoc
downloadbbc-on-ice-42a430345f8fd14e6aaa70cc2c6afd774dc85cfe.tar.gz
bbc-on-ice-42a430345f8fd14e6aaa70cc2c6afd774dc85cfe.tar.xz
bbc-on-ice-42a430345f8fd14e6aaa70cc2c6afd774dc85cfe.zip
Initial commit
A half-working prototype.
Diffstat (limited to 'README.adoc')
-rw-r--r--README.adoc49
1 files changed, 49 insertions, 0 deletions
diff --git a/README.adoc b/README.adoc
new file mode 100644
index 0000000..93aa54b
--- /dev/null
+++ b/README.adoc
@@ -0,0 +1,49 @@
+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
+a package with the latest development version from Archlinux's AUR, or from
+openSUSE Build Service for the rest of mainstream distributions. Consult the
+list of repositories and their respective links at:
+
+https://build.opensuse.org/project/repositories/home:pjanouch:git
+
+Building and Running
+--------------------
+Build dependencies: CMake, go
+
+ $ git clone --recursive https://github.com/pjanouch/bbc-on-ice.git
+ $ mkdir bbc-on-ice/build
+ $ cd bbc-on-ice/build
+ $ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug
+ $ make
+
+To install the application, you can do either the usual:
+
+ # make install
+
+Or you can try telling CMake to make a package for you. For Debian it is:
+
+ $ cpack -G DEB
+ # dpkg -i bbc-on-ice-*.deb
+
+Contributing and Support
+------------------------
+Use this project's GitHub to report any bugs, request features, or submit pull
+requests. If you want to discuss this project, or maybe just hang out with
+the developer, feel free to join me at irc://irc.janouch.name, channel #dev.
+
+License
+-------
+'bbc-on-ice' is written by Přemysl Janouch <p.janouch@gmail.com>.
+
+You may use the software under the terms of the ISC license, the text of which
+is included within the package, or, at your option, you may relicense the work
+under the MIT or the Modified BSD License, as listed at the following site:
+
+http://www.gnu.org/licenses/license-list.html