ezstream-file.sh - script to stream files from the command line

EZSTREAM-FILE.SH(1) General Commands Manual EZSTREAM-FILE.SH(1)


ezstream-file.sh — script to stream files from the command line


ezstream-file.sh [−hqrVv] [−p pidfile] [−T cfg_template] [file ...]


The ezstream-file.sh script uses an ezstream configuration file template to stream a list of files given on the command line, or via standard input. In other words, filenames are written to a temporary playlist, and a template-based configuration is generated to stream them.

The path to a configuration template must be provided, either by using the −T command line argument, or the EZSTREAM_TEMPLATE environment variable.

The configuration template must be a valid playlist configuration, and contain the follwing configuration statement inside the <media /> block:


If no input files are specified, the list of files to be streamed are read from standard input.

Lastly, the EZSTREAM environment variable allows to specify an alternate ezstream binary.

Command line parameters


Print a summary of available command line parameters with short descriptions and exit.

−p pidfile


Passed to ezstream. ) Write the ezstream-file.sh process ID (a single number) to pidfile.



Passed to ezstream. ) Be more quiet. Suppress the output that external programs send to standard error.



Passed to ezstream. ) Show a real-time stream status information line on standard output. Implies −q.

−T cfg_template

Use the configuration in cfg_template, overriding the default set in the EZSTREAM_TEMPLATE environment variable.


Print the ezstream-file.sh version number and exit.



Passed to ezstream. ) Produce more verbose output from ezstream. Use twice for even more verbose output.


Directory containing example configuration files for various uses of ezstream, as well as example playlist and metadata scripts.


ezstream(1), ezstream-cfgmigrate(1)


The ezstream-file.sh script and this manual were written by Moritz Grimm. ezstream 1.0.2 November 10, 2023 EZSTREAM-FILE.SH(1)

Updated 2024-01-29 - jenkler.se | uex.se