darkice(1)

📦
version 1.6 · 2 versions
, in alpine 3.24, debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ darkice — the live audio streamer bestie ✨

okay so you found the darkice(1) page, the one and only DarkIce live audio streamer manual, section 1, and honestly? you're gonna eat this up. sit down, grab a boba, we're streaming audio. 💖

🎀 NAME 🎀

darkice — an icecast / shoutcast live audio streamer. that's the whole vibe. 💅

🦋 SYNOPSIS 🦋

darkice [options] -c config.file

🌸 DESCRIPTION 🌸

so like, DarkIce is literally a live audio streamer. it records audio from an audio interface (a sound card, bestie, like the one in your machine), encodes it, and sends it off to a streaming server. main character behaviour, no cap. 👑

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

okay this next part is important, don't scroll past it. 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. that's just how it is, bestie. 😭

💅 OPTIONS 💅

  • -c config.file — tells DarkIce which configuration file to use. if you don't specify one, /etc/darkice.cfg gets used. the default just pulls up like "i'm here" 🙈
  • -v n — sets the verbosity level, between 0 and 10. 0 is silent (shy era), 10 is loud (yapper era). defaults to 1.
  • -h — prints the help page and exits. iconic behaviour, honestly.

📝 NOTES 📝

when you're using the FLAC encoder with an icecast streamer, make sure to increase the <queue-size> setting. like, make sure. do it. 🫶

💀 BUGS 💀

Lots of bugs.

that's it. that's the bug report. they said it themselves, fr fr. 😭

👀 SEE ALSO 👀

darkice.cfg(5), icecast(1)

💖 AUTHOR 💖

Akos Maroy <darkeye@tyrell.hu> — the founder of the whole situation. 👑

🌈 ACKNOWLEDGEMENTS 🌈

Developed with contributions by:

  • Jim Crilly, <JCrilly@MSA.com>
  • aNa|0Gue, <analogue@glop.org>
  • Robin P. Blanchard, <Robin_Blanchard@gactr.uga.edu>
  • Tom Gray, <tomg@future-i.com>
  • Michael Smith, <msmith@labyrinth.net.au>
  • Julius O. Smith, <jos@ccrma.stanford.edu>
  • the OSALP team, http://osalp.sourceforge.net
  • Kristjan G. Bjarnason <kgb@gangverk.is>
  • Nicu Pavel <npavel@ituner.com>
  • Kai Krakow <kai@kaishome.de>
  • Atsuhiko Yamanaka <ymnk@jcraft.com>
  • Ricardo Galli <gallir@uib.es>
  • John Hay <jhay@icomtek.csir.co.za>
  • Christian Forster <forster@like.e-technik.uni-erlangen.de>
  • John Deeny <taqueso@dilapidated.org>
  • Robert Lunnon <bobl@optushome.com.au>
  • Enrico Ardizzoni <craken@users.sourceforge.net>
  • Deti Fliegl <deti@fliegl.de>
  • Nicholas J. Humfrey <njh@ecs.soton.ac.uk>
  • Joel Ebel <jbebel@ncsu.edu>
  • <jochen2@users.sourceforge.net>
  • Alexander Vlasov <zulu@galaradio.com>
  • Mariusz Mazur <mmazur@kernel.pl>
  • dsk <derrick@csociety.org>
  • Clyde Stubbs <clyde@htsoft.com>
  • Jens Maurer <Jens.Maurer@gmx.net>
  • Elod Horvath <elod@itfais.com>
  • Pierre Souchay <pierre@souchay.net>
  • Daniel Hazelbaker <daniel@highdesertchurch.com>
  • Alessandro Beretta <alessandro.baretta@radiomaria.org>
  • Roland Hermans <roland.hermans@omroepvenray.nl>
  • Rafael Diniz <rafael@riseup.net>

every single one of them ate. periodt. 💅

and that's the page!! 💖✨🦋 this whole thing is the DarkIce manual, and it's dated April 3, 2024 — so if you're reading this way later, hey, it's still giving. mwah, go stream something, bestie. 🎀💜

📦 where this page comes from