Ezstream is a command line source client for media streams, primarily for streaming to Icecast servers.
It allows the creation of media streams based on input from files or standard input that is piped through an optional external de- and encoder. As every part of this chain is highly configurable, ezstream can be useful in a large number of streaming setups.
It uses libshout to communicate with streaming servers and currently supports Ogg, MP3, WebM, and Matroska streams using the HTTP, ICY, and RoarAudio protocols. It uses TagLib to read and manage metadata in numerous media files.
Ezstream is free software and licensed under the GNU General Public License.
Older releases, including version 0.x, can be found at downloads.xiph.org/releases/ezstream.
Ezstream 1.0.1 has been released on February 22nd 2020.
This is a bugfix release.
This is a major feature release with a new configuration file structure.
Further changes include:
@b@placeholder for separate album metadata
-phas been added, causing ezstream to write a locked PID file to a given location
-nhave been removed, and new configuration file settings have been added accordingly
-scommand line argument was changed: To shuffle lines from standard input, the special file name “
-” needs to be provided.
Ezstream depends on:
Ezstream optionally uses:
iconv()is not available in libc, for basic non-ASCII charset support in metadata and filenames
Building ezstream depends on:
Most current UNIX-like operating system, such as Linux (including Windows Subsystem for Linux) and *BSD, either provide prebuilt binary packages of ezstream, or the necessary tools to build it manually.
To find out whether ezstream is available as a prebuilt package and in which version, please refer to your operating system documentation for more information.
When building manually from source, the preferred way to build ezstream is to rely on prebuilt binary packages for the dependencies as much as possible. This may require the installation of the respective -devel packages, if applicable.
The ezstream source code ships with a
file that provides information on all further steps.
Ezstream ships with a comprehensive manual and example configurations. Type
man ezstream to get started.
In case of issues that are not answered by the documentation, please report them in the ezstream issue tracker.
Please include as much information as possible in your reports. Most importantly: information how to reproduce the issue independently, what behavior is expected, and what behavior is observed instead.
The current maintainer of ezstream is Moritz Grimm
mgrimm at mrsserver dot net).