2014-12-04 06:41:53 -05:00
|
|
|
Icecast 2 - README
|
2003-12-18 12:01:31 -05:00
|
|
|
---------------------------------------------------------------------
|
2002-10-01 12:26:18 -04:00
|
|
|
|
2017-11-11 17:57:35 -05:00
|
|
|
[](https://travis-ci.org/xiph/Icecast-Server)
|
|
|
|
|
|
2015-05-25 09:12:08 -04:00
|
|
|
Icecast is a streaming media server which currently supports _WebM_ and
|
|
|
|
|
_Ogg_ streaming including the _Opus_, _Vorbis_ and _Theora_ codecs.
|
|
|
|
|
Also Icecast can handle other streams like MP3/AAC/NSV
|
2014-12-14 03:25:16 -05:00
|
|
|
in legacy mode, but this is not officially supported.
|
2014-12-04 06:41:53 -05:00
|
|
|
|
2008-06-01 22:57:47 -04:00
|
|
|
It can be used to create an Internet radio station or a privately
|
|
|
|
|
running jukebox and many things in between. It is very versatile in
|
|
|
|
|
that new formats can be added relatively easily and supports open
|
|
|
|
|
standards for communication and interaction.
|
2002-10-01 12:26:18 -04:00
|
|
|
|
2004-01-28 20:02:40 -05:00
|
|
|
Icecast is distributed under the GNU GPL, version 2. A copy of this
|
|
|
|
|
license is included with this software in the COPYING file.
|
2003-12-18 12:01:31 -05:00
|
|
|
|
2015-05-25 09:12:08 -04:00
|
|
|
The name of this software is spelled __"Icecast"__ with a leading capital 'I' but with a lower case 'c'. Any other spelling is _incorrect_.
|
|
|
|
|
|
2003-12-18 12:01:31 -05:00
|
|
|
Prerequisites
|
|
|
|
|
---------------------------------------------------------------------
|
2014-12-04 06:41:53 -05:00
|
|
|
Icecast requires the following packages:
|
|
|
|
|
|
|
|
|
|
- [libxml2][1]
|
|
|
|
|
- [libxslt][2]
|
|
|
|
|
- [curl][3] (>= version 7.10 required)
|
|
|
|
|
- [ogg/vorbis][4] (>= version 1.0 required)
|
2003-12-18 12:01:31 -05:00
|
|
|
|
2014-12-04 06:41:53 -05:00
|
|
|
__NOTE__: Icecast may be compiled without curl, however this will
|
|
|
|
|
disable Stream Directory server interaction (YP) and URL based
|
|
|
|
|
authentication.
|
2003-12-18 12:01:31 -05:00
|
|
|
|
2008-06-01 22:57:47 -04:00
|
|
|
A note about prerequisite packages
|
2003-12-18 12:01:31 -05:00
|
|
|
---------------------------------------------------------------------
|
2008-06-01 22:57:47 -04:00
|
|
|
Most distributions have some sort of package management repository for
|
|
|
|
|
pre-built packages (eg rpm, deb etc). These setups often have a runtime
|
|
|
|
|
package, which is usually installed for you by default, and enables you
|
|
|
|
|
to run applications that depend on them. However if you are building
|
2014-12-04 06:41:53 -05:00
|
|
|
Icecast from source then the runtime system is not enough. You will also
|
2008-06-01 22:57:47 -04:00
|
|
|
need a development package named something like libxslt-devel
|
2003-12-18 12:01:31 -05:00
|
|
|
|
|
|
|
|
Build/Install
|
|
|
|
|
---------------------------------------------------------------------
|
2014-12-14 05:14:25 -05:00
|
|
|
To build Icecast on a Unix platform, perform the following steps:
|
2002-10-01 12:26:18 -04:00
|
|
|
|
|
|
|
|
Run
|
2014-12-04 06:41:53 -05:00
|
|
|
|
|
|
|
|
./configure
|
|
|
|
|
make
|
2014-12-14 05:14:25 -05:00
|
|
|
make install # as root
|
2002-10-01 12:26:18 -04:00
|
|
|
|
2017-11-11 18:01:33 -05:00
|
|
|
This is the typical procedure if you download the tar file.
|
|
|
|
|
|
2017-11-11 18:06:16 -05:00
|
|
|
If you retrive the code from Git, make sure to clone recursively:
|
2017-11-11 18:01:33 -05:00
|
|
|
|
|
|
|
|
git clone --recursive https://git.xiph.org/icecast-server.git
|
|
|
|
|
|
|
|
|
|
After that, create the configure script by running: `./autogen.sh`.
|
|
|
|
|
Now you can just follow the steps mentioned above.
|
2002-10-01 12:26:18 -04:00
|
|
|
|
2014-12-14 03:41:04 -05:00
|
|
|
A sample config file will be placed in `/usr/local/etc` (on UNIX,
|
|
|
|
|
also depends on path PREFIX) or in the current working directory
|
|
|
|
|
(on Win32) and is called `icecast.xml`
|
2003-11-17 17:41:16 -05:00
|
|
|
|
2014-12-04 06:41:53 -05:00
|
|
|
Documentation for Icecast is available in the doc directory, by
|
2014-12-14 03:48:52 -05:00
|
|
|
viewing `doc/index.html` in a browser. It's also installed to
|
|
|
|
|
`$PREFIX/share/doc/icecast/`. Online documentation can be found
|
|
|
|
|
on the [Icecast Website][5].
|
2002-10-01 12:26:18 -04:00
|
|
|
|
2014-12-14 04:20:03 -05:00
|
|
|
If you have problems with setting up Icecast, please join the
|
|
|
|
|
[Icecast mailing list][6] and then email icecast@xiph.org.
|
|
|
|
|
In case you have patches or want to discuss development issues,
|
|
|
|
|
please join the [Icecast developer mailing list][7] and then
|
|
|
|
|
email icecast-dev@xiph.org.
|
|
|
|
|
Or come and see us on irc.freenode.net, channel [#icecast][8]
|
|
|
|
|
(please be patient, people are not always at their computers).
|
2002-10-01 12:26:18 -04:00
|
|
|
|
2014-12-04 06:41:53 -05:00
|
|
|
[1]: http://xmlsoft.org/downloads.html
|
|
|
|
|
[2]: http://xmlsoft.org/XSLT/downloads.html
|
|
|
|
|
[3]: http://curl.haxx.se/download.html
|
|
|
|
|
[4]: http://www.vorbis.com/files
|
|
|
|
|
[5]: http://icecast.org/docs/
|
2014-12-14 04:27:59 -05:00
|
|
|
[6]: http://lists.xiph.org/mailman/listinfo/icecast
|
2014-12-14 04:50:55 -05:00
|
|
|
[7]: http://lists.xiph.org/mailman/listinfo/icecast-dev
|
2014-12-14 04:27:59 -05:00
|
|
|
[8]: https://webchat.freenode.net/?channels=#icecast
|
