darkice/darkice/trunk
darkeye 0ca88976b9 changed the order of shoutcast metadata 2006-07-16 16:46:40 +00:00
..
etc renamed new ebuild from 0.18 to 0.17.1 2006-05-19 13:40:37 +00:00
man for release 0.17 2006-01-26 22:14:08 +00:00
src changed the order of shoutcast metadata 2006-07-16 16:46:40 +00:00
AUTHORS for release 0.17 2006-01-26 22:14:08 +00:00
COPYING removed dependency on locally stored SGI STL header files 2001-09-05 20:11:16 +00:00
ChangeLog replaced TABs with spaces 2006-05-19 13:35:41 +00:00
FAQ added FAQ 2006-05-18 07:05:37 +00:00
INSTALL created configure options to compile with or without lame / Ogg Vorbis 2001-10-19 12:39:42 +00:00
INSTALL.lame updated version number from 3.89beta to 3.91 2002-02-20 15:07:59 +00:00
INSTALL.vorbis changed references to 1.0 final from 10.rc3 2002-08-26 07:23:14 +00:00
Makefile.am added FAQ to document file list 2006-05-19 12:40:59 +00:00
NEWS renamed new version from 0.18 to 0.17.1 2006-05-19 13:11:33 +00:00
README added mpeg2 support, thanks to Nicholas J Humfrey 2006-01-25 22:47:15 +00:00
TODO for version 0.14 2004-02-15 22:30:08 +00:00
acinclude.m4 newer update of ACX_PTHREAD 2004-02-23 20:03:09 +00:00
autogen.sh ported to NetBSD 2004-02-23 19:12:52 +00:00
configure.in renamed new version from 0.18 to 0.17.1 2006-05-19 13:11:33 +00:00
darkice.cfg added option to turn off automatic reconnect feature 2005-04-11 19:27:43 +00:00
install-sh changed builting to an automake / autoconf environment 2000-11-05 14:08:28 +00:00
missing changed builting to an automake / autoconf environment 2000-11-05 14:08:28 +00:00
mkinstalldirs changed builting to an automake / autoconf environment 2000-11-05 14:08:28 +00:00
stamp-h.in changed builting to an automake / autoconf environment 2000-11-05 14:08:28 +00:00

README

DarkIce live audio streamer, http://darkice.sourceforge.net
Copyright (c) 2000-2006, Tyrell Hungary, http://tyrell.hu


Contents
--------

1. What is DarkIce?
2. Compiling and installing
3. Reporting crashes


1. What is DarkIce?
-------------------

DarkIce is an IceCast, IceCast2 and ShoutCast live audio streamer. It
takes audio input from a sound card, encodes it into mp3 and/or Ogg Vorbis,
and sends the mp3 stream to one or more IceCast and/or ShoutCast servers,
the Ogg Vorbis stream to one or more IceCast2 servers.

DarkIce is hosted on SourceForge, at http://darkice.sourceforge.net/


2. Compiling and installing
---------------------------

On how to compile and install, please read the file INSTALL. If you're
impatient, try:

./configure
make

The executable built is src/darkice.
To install, try as root:

make install


For documentation, try:

man darkice


3. Reporting crashes
--------------------

When DarkIce core dumps, please send the backtrace along with your error
report to the darkice mailing list: darkice-list@lists.sourceforge.net
To get the backtrace information, you need gdb, the GNU debugger:

1. configure and compile using the --with-debug option:

./configure --with-debug=yes
make clean all

2. run darkice from within gdb:

gdb src/darkice

3. set parameters within gdb:

(gdb) set args -c darkice.cfg

4. run:

(gdb) run

5. after coredump, print the backtrace:

(gdb) bt