faq.md 6.01 KB
Newer Older
Marvin Scholz's avatar
Marvin Scholz committed
1
2
3
4
---
title: FAQ
permalink: /faq/
---
5
6
7
8
9
10
<div class="article" id="toc" markdown="1">
# Table of Content
* [General Questions](#general-questions)
* [Setup](#setup)
* [Administration](#administration)
* [Interoperability](#interoperability)
11
* [Configuration](#configuration)
12
13
</div>

14
<div class="article" id="general-questions" markdown="1">
Marvin Scholz's avatar
Marvin Scholz committed
15
16
17
18
19
20
# General Questions

## What is Icecast.org?
Icecast.org, the project, is a collection of programs and libraries for streaming audio over the Internet.
This includes:

21
- Icecast, a program that streams audio and video data to listeners
Marvin Scholz's avatar
Marvin Scholz committed
22
23
24
25
- libshout, a library for communicating with Icecast servers
- IceS, a program that sends audio data to Icecast servers

## What is Icecast, the program?
26
27
28
29
Icecast is a streaming server, which can stream audio (and video) to listeners/viewers.
It supports Ogg (Vorbis, Theora), Opus, FLAC and WebM (VP8/VP9), nonfree codecs/formats
like MP4 (H.264, MPEG4), M4A, NSV, AAC and MP3 might work, but we do not officially support
those.
Marvin Scholz's avatar
Marvin Scholz committed
30
31
32
33
34
35
36
37
38
39
40

## What is libshout?
libshout is a library for communicating with and sending data to an Icecast server.
It handles the socket connection, the timing of the data, and prevents bad data
from getting to the Icecast server.

## What is IceS?
IceS is a program that sends audio data to an icecast server to broadcast to clients.
IceS can either read audio data from disk, such as from Ogg Vorbis files, or sample
live audio from a sound card and encode it on the fly.

41
42
43
44
45
46
47
48
49
50
51
52
## Can I use Icecast to stream like Spotify/Rdio/Pandora?
No. This kind of "streaming" is very different from what Icecast does. In Icecast you
usually have a "station" (mountpoint) sourced by a source client like IceS and streamed
by Icecast to a large amount of listeners. This implies that all listeners of that mountpoint
get the same stream, so an individual listener can't pause the stream or add different tracks
without affecting all other users.

As already mentioned, Spotify and co. do not really "stream" in the classic meaning of the term.
Actually what they in most cases do is provide the client with the individual songs and the client
takes care of all the other things, like play/pause and playing the tracks in the desired order.
It's basically just simple file serving, which webservers like nginx or Apache do.

53
</div>
Marvin Scholz's avatar
Marvin Scholz committed
54

55
<div class="article" id="setup" markdown="1">
Marvin Scholz's avatar
Marvin Scholz committed
56
57
58
59
60
61
62
# Setup

## What platforms are supported?
Icecast is being developed on Linux and Windows, and is being tested with major Unices.

## How do I set up Icecast?
Go to the Icecast [Documentation]({{ "/docs" | prepend: site.baseurl }}) Page and follow
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
the instructions for your Icecast version there.

## I have copied a config from some website, but it's not working!
We strongly advise you to not copy a config from some website, it's likely
outdated or wrong. Please read the next question for more advise.

## How do I get started with the Icecast configuration?
You should start with the default config and only change the passwords. If you
need more things, carefully read the documentation and only add/change what you
really need.  
Most problems occur when over-configuring Icecast.

## What happened to the Windows GUI? I only see a black window with some text.
Icecast used to have a graphical user interface on Windows, but that was deprecated in 2.3.3
as it wasn't frequently used and hard to maintain. Considering that most of the things the GUI
could do now are possible using the Icecast web interface, it's not needed anymore.  
The black window with text you see is the command line running the Icecast server, just keep that
window open. When you want to quit Icecast, hit Ctrl+C and confirm that you want to quit.

## How can I run Icecast as a Service on Windows?
We do not have service capabilities in Icecast anymore, currently. Please see
[this Wiki page](https://wiki.xiph.org/Icecast_Server/Setup_Windows_Service)
for instruction how to set up Icecast as a service using a third party service
manager.
Marvin Scholz's avatar
Marvin Scholz committed
87

88
</div>
Marvin Scholz's avatar
Marvin Scholz committed
89

90
<div class="article" id="administration" markdown="1">
Marvin Scholz's avatar
Marvin Scholz committed
91
92
93
# Administration

## How can I view the stream status page?
94
95
96
Just navigate your web browser to host/port the Icecast server is listening on.

If you are a Windows user, make sure you started the Icecast server and then click on the
Philipp Schafft's avatar
Philipp Schafft committed
97
shortcut in the Startmenu, it will open the Icecast status page in your browser.
Marvin Scholz's avatar
Marvin Scholz committed
98

99
</div>
Marvin Scholz's avatar
Marvin Scholz committed
100

101
<div class="article" id="interoperability" markdown="1">
Marvin Scholz's avatar
Marvin Scholz committed
102
103
104
# Interoperability

## What can I use to listen to an Icecast stream?
105
106
Most mordern audio players should be able to play Icecast streams without problems, depending
on the format you are streaming in.  
Marvin Scholz's avatar
Marvin Scholz committed
107
108
We maintain a list of Icecast-compatible audio players [here]({{ "/apps" | prepend: site.baseurl }}).

109
</div>
Marvin Scholz's avatar
Marvin Scholz committed
110

111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
<div class="article" id="configuration" markdown="1">
# Configuration

## What should I set `<location>` to?
The `<location>` tag sets free form string that is listed publically as the server's location.
(This is not the location of your station/studio.)
The value should include at least the nation, and city.

A good example would be "`Datacentre 4, OurSuperCompany GmbH, Frankfurt am Main, Germany`".
A bad example would be "`Frankfurt`" (which one?) or "`rack4.2`".

## What should I set `<admin>` to?
The `<admin>`tag sets a free form string that is listed publically as the server's contact.
This is normally an e-mail address, but could also be a phone number.
(If you use a phone number please use the international format starting with "`+`".)

## What should I set `<hostname>` to?
This is the public hostname of your Icecast. Your server is reachable by this domain name.
It is used in a few cases Icecast needs to know how it is reachable from the outside.
One such case is for yp / directory submission.

You should set this to a DNS name that has at least a `A`, or `AAAA` resource record pointing to
this instance. Using of IP addresses, or (website) URIs is invalid.

## Does setting `<server-id>`, or `<fileserve>` make my server more secure?
No. Altering this settings does not improve security. However setting those values can easily
break your server. It is best not to touch those options at all.

</div>