darkice(1)

darkice1

An icecast / shoutcast live audio streamer

Usage

darkice [options] -c config.file

Overview

DarkIce as a live audio streamer. It records audio from an audio interface (e.g. sound card), encodes it and sends it to a streaming server.

DarkIce can record from:

* OSS audio devices
* ALSA audio devices
* Solaris audio interface
* Jack sources
* PulseAudio sources

DarkIce can encode in the following formats:

* mp3 - using the lame library
* mp2 - using the twolame library
* Ogg Vorbis
* Ogg Opus
* Ogg FLAC
* AAC - using the faac library
* AAC HEv2 - using the libaacplus (3GPP reference code)

DarkIce can send the encoded stream to the following streaming servers:

* ShoutCast
* IceCast 1.3.x and 2.x
* Darwin Streaming Server

Darkice runs on the following operating systems:

* FreeBSD
* Linux on intel and PowerPC
* MacOS X
* NetBSD / OpenBSD
* SUN Solaris

DarkIce uses POSIX real-time scheduling to keep up with sound card input. POSIX real-time scheduling is only available if the program is run as root. Therefore it is recommended that DarkIce is run as root.

Options

-c config.file

Specifies what configuration file to use. If not specified, /etc/darkice.cfg will be used.

-v n

Sets the verbosity level, between 0 and 10. 0 is silent, 10 is loud. Defaults to 1.

-h

Prints the help page and exits.

Notes

When using the FLAC encoder with an icecast streamer, make sure to increase the <queue-size> setting.

Acknowledgements

Developed with contributions by

Jim Crilly, <[email protected]>
aNa|0Gue, <[email protected]>
Robin P. Blanchard, <[email protected]>
Tom Gray, <[email protected]>
Michael Smith, <[email protected]>
Julius O. Smith, <[email protected]>
the OSALP team, http://osalp.sourceforge.net
Kristjan G. Bjarnason <[email protected]>
Nicu Pavel <[email protected]>
Kai Krakow <[email protected]>
Atsuhiko Yamanaka <[email protected]>
Ricardo Galli <[email protected]>
John Hay <[email protected]>
Christian Forster <[email protected]>
John Deeny <[email protected]>
Robert Lunnon <[email protected]>
Enrico Ardizzoni <[email protected]>
Deti Fliegl <[email protected]>
Nicholas J. Humfrey <[email protected]>
Joel Ebel <[email protected]>
<[email protected]>
Alexander Vlasov <[email protected]>
Mariusz Mazur <[email protected]>
dsk <[email protected]>
Clyde Stubbs <[email protected]>
Jens Maurer <[email protected]>
Elod Horvath <[email protected]>
Pierre Souchay <[email protected]>
Daniel Hazelbaker <[email protected]>
Alessandro Beretta <[email protected]>
Roland Hermans <[email protected]>
Rafael Diniz <[email protected]>

Releases

11 releases since Debian 3.1 (Sarge); the text changed 6 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 6.0
  5. 7
  6. 8–12
  7. 13

Bugs

Lots of bugs.

Author

Akos Maroy <[email protected]>

From darkice 1.5-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.