darkice/darkice/trunk
rafael@riseup.net 288ebc48b1 preparing for the new version 2009-11-05 18:06:35 +00:00
..
etc for 0.19 release, re #39 2008-07-07 14:40:45 +00:00
man branch darkice-aacp merged 2009-06-21 04:36:30 +00:00
src placed a more apropriate fix, following the coding style - closes issue 3 2009-11-05 17:47:44 +00:00
AUTHORS small cosmetic fixes for 0.20 version 2009-11-05 18:01:13 +00:00
COPYING removed dependency on locally stored SGI STL header files 2001-09-05 20:11:16 +00:00
ChangeLog preparing for the new version 2009-11-05 18:06:35 +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 removed doxygen generation because of doxygen segfault, re #15 2007-03-05 20:39:40 +00:00
NEWS preparing for the new version 2009-11-05 18:06:35 +00:00
README updated copyright dates, removed changelogs from the end of source files, 2007-01-14 16:28:42 +00:00
TODO for version 0.14 2004-02-15 22:30:08 +00:00
acinclude.m4 committed serial ulaw patch, provided by Clyde Stubbs, re #13 2007-02-25 17:04:17 +00:00
autogen.sh ported to NetBSD 2004-02-23 19:12:52 +00:00
configure.in preparing for the new version 2009-11-05 18:06:35 +00:00
darkice.cfg small cosmetic fixes for 0.20 version 2009-11-05 18:01:13 +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.tyrell.hu/
Copyright (c) 2000-2007, 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 by Tyrell Corporation, at http://darkice.tyrell.hu/


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.tyrell.hu.
Alternatively you could file a bug report at http://darkice.tyrell.hu/trac
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