mirror of
https://gitlab.xiph.org/xiph/ezstream.git
synced 2024-11-03 04:17:18 -05:00
111 lines
2.9 KiB
Plaintext
111 lines
2.9 KiB
Plaintext
|
.\" $Id$
|
||
|
|
.\"
|
||
|
|
.\" Copyright (c) 2009 Moritz Grimm <mdgrimm@gmx.net>
|
||
|
|
.\"
|
||
|
|
.\" Permission to use, copy, modify, and distribute this software for any
|
||
|
|
.\" purpose with or without fee is hereby granted, provided that the above
|
||
|
|
.\" copyright notice and this permission notice appear in all copies.
|
||
|
|
.\"
|
||
|
|
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||
|
|
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||
|
|
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
||
|
|
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||
|
|
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||
|
|
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
||
|
|
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||
|
|
.\"
|
||
|
|
.Dd @BUILD_DATE@
|
||
|
|
.Dt EZSTREAM-FILE.SH 1
|
||
|
|
.Os @PACKAGE_NAME@ @PACKAGE_VERSION@
|
||
|
|
.Sh NAME
|
||
|
|
.Nm ezstream-file.sh
|
||
|
|
.Nd convenience script to stream files from the command line
|
||
|
|
.Sh SYNOPSIS
|
||
|
|
.Nm
|
||
|
|
.Bk -words
|
||
|
|
.Op Fl hnqVv
|
||
|
|
.Op Fl T Ar cfg_template
|
||
|
|
.Op Ar
|
||
|
|
.Ek
|
||
|
|
.Sh DESCRIPTION
|
||
|
|
The
|
||
|
|
.Nm
|
||
|
|
script uses an
|
||
|
|
.Nm 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.
|
||
|
|
.Pp
|
||
|
|
The path to a configuration template must be provided, either by using the
|
||
|
|
.Fl T
|
||
|
|
command line argument, or the
|
||
|
|
.Dv EZSTREAM_TEMPLATE
|
||
|
|
environment variable.
|
||
|
|
.Pp
|
||
|
|
The configuration template must be a valid playlist configuration, and contain
|
||
|
|
the follwing configuration statement:
|
||
|
|
.Bd -literal -offset indent
|
||
|
|
\&<filename\&>%FILENAME%\&</filename\&>
|
||
|
|
.Ed
|
||
|
|
.Pp
|
||
|
|
If no input files are specified, the list of files to be streamed are read
|
||
|
|
from standard input.
|
||
|
|
.Pp
|
||
|
|
Lastly, the
|
||
|
|
.Dv EZSTREAM
|
||
|
|
environment variable allows to specify an alternate
|
||
|
|
.Nm ezstream
|
||
|
|
binary.
|
||
|
|
.Ss Command line parameters
|
||
|
|
.Bl -tag -width Ds
|
||
|
|
.It Fl h
|
||
|
|
Print a summary of available command line parameters with short descriptions
|
||
|
|
and exit.
|
||
|
|
.It Fl n
|
||
|
|
.Po
|
||
|
|
Passed to
|
||
|
|
.Nm ezstream .
|
||
|
|
.Pc
|
||
|
|
Normalize metadata strings by removing excess whitespaces.
|
||
|
|
.It Fl q
|
||
|
|
.Po
|
||
|
|
Passed to
|
||
|
|
.Nm ezstream .
|
||
|
|
.Pc
|
||
|
|
Be more quiet.
|
||
|
|
Suppress the output that external programs send to standard error.
|
||
|
|
.It Fl T Ar cfg_template
|
||
|
|
Use the configuration in
|
||
|
|
.Ar cfg_template ,
|
||
|
|
overriding the default set in the
|
||
|
|
.Dv EZSTREAM_TEMPLATE
|
||
|
|
environment variable.
|
||
|
|
.It Fl V
|
||
|
|
Print the
|
||
|
|
.Nm
|
||
|
|
version number and exit.
|
||
|
|
.It Fl v
|
||
|
|
.Po
|
||
|
|
Passed to
|
||
|
|
.Nm ezstream .
|
||
|
|
.Pc
|
||
|
|
Produce more verbose output from
|
||
|
|
.Nm ezstream .
|
||
|
|
Use twice for even more verbose output.
|
||
|
|
.El
|
||
|
|
.Sh FILES
|
||
|
|
.Bl -tag -width "!!EXAMPLES_DIR!!" -compact
|
||
|
|
.It Pa !!EXAMPLES_DIR!!
|
||
|
|
Directory containing example configuration files for various uses of
|
||
|
|
.Nm ezstream ,
|
||
|
|
as well as example playlist and metadata scripts.
|
||
|
|
.El
|
||
|
|
.Sh SEE ALSO
|
||
|
|
.Xr ezstream 1
|
||
|
|
.Sh AUTHORS
|
||
|
|
.An -nosplit
|
||
|
|
.Nm
|
||
|
|
and this manual were written by
|
||
|
|
.An Moritz Grimm Aq mdgrimm@gmx.net .
|