darkice/darkice/trunk
darkeye 7779a8f2a4 finalized OpenBSD port 2004-02-19 06:47:06 +00:00
..
man added link to DarkSnow 2004-02-15 13:26:34 +00:00
rpm for version 0.14 2004-02-15 22:30:08 +00:00
src finalized OpenBSD port 2004-02-19 06:47:06 +00:00
AUTHORS ogg vorbis recording to only a file caused a segfault. now fixed 2004-02-15 13:07:42 +00:00
COPYING removed dependency on locally stored SGI STL header files 2001-09-05 20:11:16 +00:00
ChangeLog finalized OpenBSD port 2004-02-19 06:47:06 +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 for version 0.6 2001-09-18 17:35:15 +00:00
NEWS for version 0.14 2004-02-15 22:30:08 +00:00
README added backtrace reporting description to README 2004-02-15 12:32:47 +00:00
TODO for version 0.14 2004-02-15 22:30:08 +00:00
acinclude.m4 added cross-platform pthread detection 2003-02-12 15:38:26 +00:00
autogen.sh replaced update-conf with autogen.sh 2002-07-21 08:48:33 +00:00
configure.in ported to OpenBSD (real-time scheduling not yet supported) 2004-02-18 21:08:11 +00:00
darkice.cfg added cbr, abr and vbr setting feature with encoding quality 2002-04-13 11:26:00 +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-2004, 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