About Ezstream

Ezstream is a command line source client for Icecast media streaming servers. It began as the successor of the old "shout" utility, and has since gained a lot of useful features.

In its basic mode of operation, it streams media files or data from standard input without reencoding and thus requires only very little CPU resources. It can also use various external decoders and encoders to reencode from one format to another, and stream the result to an Icecast server. Additional features include scriptable playlist and metadata handling. All of its features make ezstream a very flexible source client.

Supported media formats for streaming are MP3, Ogg Vorbis and Ogg Theora. Native metadata support includes MP3 (ID3v1 only) and Ogg Vorbis, and many more formats when the optional TagLib support has been compiled in.

Ezstream is free software and licensed under the GNU General Public License.

About | Download | More ... | Release Notes | Support

Download

Latest version: 0.5.4 [ Changes ]

Package	Download Link
Source .tar.gz (all platforms)	ezstream-0.5.4.tar.gz MD5: 7a83c5de8410dbf14144945c267e6580
MS Windows binary (32bit)	ezstream-0.5.4-win32.zip MD5: f46c3aa5c443defe0b9eff5565647a07

Older releases can be found at http://downloads.xiph.org/releases/ezstream/.

About | Download | More ... | Release Notes | Support

Further Information

Dependencies

Ezstream depends on:

• libshout 2.2.x + libshout dependencies
  http://www.icecast.org/download.php
• libxml 2.x
  http://xmlsoft.org

Ezstream optionally uses:

• For reading metadata from Ogg Vorbis files:
  • TagLib 1.x (1.4 or newer recommended)
    http://developer.kde.org/~wheeler/taglib.html
  or:
  • libvorbis 1.x
    http://www.vorbis.com/
• For basic non-ASCII charset support in metadata and filenames:
  • GNU libiconv, if iconv() is not available in the system C library.
    http://www.gnu.org/software/libiconv/

UNIX (Linux, *BSD, Solaris, ...)

On UNIX and UNIX-like systems, such as Linux and *BSD, binary packages for the required libraries are usually available. To compile ezstream, ensure that the respective -devel packages are installed as well, if applicable. Further steps, and more, are explained in the README and INSTALL files inside the distribution package.

It might be a good idea to check whether the operating system vendor provides a binary package of a recent ezstream release and install that one instead of building from source.

Windows

Windows users can simply copy the ezstream.exe file from the binary distribution archive (.ZIP) to any location of their choosing. Users, who wish to be able to run ezstream anywhere on their system, can add the directory that contains ezstream.exe to their PATH environment variable.

The ezstream binary release depends on MSVC 2008 runtime libraries. These libraries can be downloaded from Microsoft as the vcredist_x86.exe file, at no cost, and are easily found via Google.

Even more ...

Comprehensive documentation of ezstream and its configuration is included in the man page ezstream(1).

Those, who are interested in how ezstream development progresses, can stay informed by occasionally looking at the NEWS file. It is kept up-to-date with important changes in ezstream as they happen.

About | Download | More ... | Release Notes | Support

Release Notes

Ezstream 0.5.4 has been released on March 28th 2009.

Version 0.5.4 is a maintenance and bugfix release.

Changes

• compat/sys/tree.*:
  • MISC — Update the tree macros to a newer version. The manual, shipped with ezstream for reference, now has a more friendly 2-clause BSD license.
• various:
  • FIX — Add a missing metadata charset conversion, and add charset conversions for filenames. From Roman Donchenko.
  • FIX — Fix build on MinGW. From Roman Donchenko.
  • MISC — Overhaul and modernize the build system. Ezstream is now expected to build "out of the box" on more systems without configuration tweaks.
  • FIX — Adjust the build system to better handle optional dependencies. It is now possible to choose between TagLib and libvorbis for reading Ogg Vorbis metadata, or no Vorbis metadata support at all. (Ticket #1398)
  • MISC — Miscellaneous code maintenance and a bit of cleaning up.

About | Download | More ... | Release Notes | Support

Support

Reporting Problems

In case of problems with ezstream, please make sure to re-read the documentation first and double-check your configuration. A lot of effort has been put into the ezstream(1) manual, and it should — at least in theory — answer all questions.

Of course, ezstream isn't immune to bugs. After checking if your bug is already known, or a newer ezstream release fixes your problem, it is much appreciated that you file your bug report with the Xiph.org bug tracker.

Please be as specific and verbose as necessary when submitting a problem report. Also, please include a valid e-Mail address when reporting an issue, in case there are follow-up questions.

Your contribution and efforts are very much appreciated. Thank you!

Contact

The current maintainer of ezstream is Moritz Grimm (mdgrimm at gmx dot net).

About | Download | More ... | Release Notes | Support