1
0
mirror of https://gitlab.xiph.org/xiph/icecast-server.git synced 2024-12-04 14:46:30 -05:00
Go to file
2024-10-25 23:29:07 +00:00
admin Feature: Report geoip result on admin interface 2024-01-20 00:16:07 +00:00
ci Fix: Remove debuginfo from mingw32-installer spec 2022-03-21 20:11:17 +00:00
conf Update: Added XML markers 2022-03-22 09:28:41 +00:00
doc Update: Release Icecast 2.5 beta3 2022-03-13 18:30:26 +00:00
examples Remove more unnecessary AUTOMAKE_OPTIONS 2018-06-16 15:34:56 +02:00
m4@2c950d5f44 Update: Updated submodules 2022-03-13 15:56:03 +00:00
src Fix: Corrected printf() and scanf() style calls on win* 2024-10-25 23:29:07 +00:00
tests Update: Separate integration and unit tests 2018-08-16 16:24:48 +02:00
web Feature: Support killing a running dumpfile 2022-03-22 15:35:43 +00:00
win32 Update: Release Icecast 2.5 beta3 2022-03-13 18:30:26 +00:00
.gitignore Feature: Build Dist Archives via CI and Upload them to OBS 2022-03-13 18:00:58 +00:00
.gitlab-ci.yml Update: Added rhash-dev to alpine 2023-01-28 22:17:05 +00:00
.gitmodules Changed URLs to be relative in .gitmodules 2014-12-04 10:24:12 +01:00
.travis.yml CI: Make IRC notifications for travis less verbose 2018-08-02 13:51:04 +02:00
AUTHORS Make sure email address is up to date. 2014-11-08 17:13:48 +00:00
autogen.sh Cleanup: Use $() instead of backticks 2018-08-07 19:30:49 +02:00
ChangeLog Update: Release Icecast 2.5 beta3 2022-03-13 18:30:26 +00:00
configure.ac Feature: Added basic geoip lookup 2024-01-20 00:14:51 +00:00
COPYING Updated address of FSF and formatting 2014-12-31 17:37:45 +00:00
HACKING Update: Source code is now in git 2019-04-23 12:45:13 +00:00
Makefile.am Feature: Install a (still empty) report XML database 2020-10-14 11:19:10 +00:00
NEWS NEWS updated for 2.4.0 and 2.4.1 2014-12-14 08:18:24 +00:00
README.md Update git url. 2022-09-05 22:33:12 +00:00
report-db.xml Feature: Install a (still empty) report XML database 2020-10-14 11:19:10 +00:00
tap-driver.sh Fix: Add a copy of tap-driver.sh to the repo 2018-08-15 16:20:49 +02:00

Icecast 2 - README

Build Status

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 in legacy mode, but this is not officially supported.

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.

Icecast is distributed under the GNU GPL, version 2. A copy of this license is included with this software in the COPYING file.

The name of this software is spelled "Icecast" with a leading capital 'I' but with a lower case 'c'. Any other spelling is incorrect.

Prerequisites

Icecast requires the following packages:

NOTE: Icecast may be compiled without curl, however this will disable Stream Directory server interaction (YP) and URL based authentication.

A note about prerequisite packages

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 Icecast from source then the runtime system is not enough. You will also need a development package named something like libxslt-devel

Build/Install

To build Icecast on a Unix platform, perform the following steps:

Run

./configure
make
make install  # as root

This is the typical procedure if you download the tar file.

If you retrive the code from Git, make sure to clone recursively:

git clone --recursive https://gitlab.xiph.org/xiph/icecast-server.git

After that, create the configure script by running: ./autogen.sh. Now you can just follow the steps mentioned above.

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

Documentation for Icecast is available in the doc directory, by 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.

If you have problems with setting up Icecast, please join the Icecast mailing list and then email icecast@xiph.org. In case you have patches or want to discuss development issues, please join the Icecast developer mailing list and then email icecast-dev@xiph.org. Or come and see us on irc.freenode.net, channel #icecast (please be patient, people are not always at their computers).