EZSTREAM-FILE.SH(1)

💖 EZSTREAM-FILE.SH 💖

okay bestie, welcome to the manual page for ezstream-file from the General Commands Manual — she's a lil script, she's a whole vibe, and she streams files straight from your command line. let's get into it ✨

---

🌸 NAME 🌸

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

---

🎀 SYNOPSIS 🎀

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

---

✨ DESCRIPTION ✨

okay so here's the tea 🫖 — the ezstream-file script takes an ezstream configuration file template and uses it to stream a list of files you hand it on the command line, or that you pipe in via standard input. like, that's the whole plot. filenames get written to a temporary playlist, and then a template-based config gets generated to stream them. it's giving efficiency. 💅

you gotta give it a path to a configuration template, bestie — either with the -T command line argument, or by setting the EZSTREAM_TEMPLATE environment variable. no template, no stream, no cap.

the configuration template has to be a valid playlist configuration, and it must contain the following configuration statement inside the <media /> block:

<filename>%FILENAME%</filename>

if you don't specify any input files at all? no worries, the list of files to be streamed gets read from standard input instead. slay. 👑

and lastly — the EZSTREAM environment variable lets you point at an alternate ezstream binary. cute, right? 🦋

---

🍓 Command line parameters 🍓

• -h — prints a summary of all the available command line parameters with short descriptions, then exits. your lil help menu moment.
• -p pidfile — (passed straight through to ezstream.) writes the ezstream-file process ID (just a single number, nothing fancy) to pidfile.
• -q — (passed to ezstream.) be more quiet. suppresses the output that external programs send to standard error. shhh era.
• -r — (passed to ezstream.) shows a real-time stream status information line on standard output. implies -q. so like, you get the status line instead of the noise. ⭐
• -T cfg_template — use the configuration in cfg_template, overriding the default set in the EZSTREAM_TEMPLATE environment variable. she overrides. she's that girl.
• -V — prints the ezstream-file version number and exits. quick lil flex.
• -v — (passed to ezstream.) produces more verbose output from ezstream. use it twice for even more verbose output. go off, honestly. 🔥

---

🌈 FILES 🌈

• /usr/share/doc/ezstream/examples — directory containing example configuration files for various uses of ezstream, as well as example playlist and metadata scripts. go look, it's full of treasures.

---

👑 SEE ALSO 👑

ezstream(1), ezstream-cfgmigrate(1)

---

💜 AUTHORS 💜

the ezstream-file script and this manual were written by Moritz Grimm. thank you for your service, legend 🫶

---

and that's the whole page, bestie!! 🎀 this was ezstream version 1.0.2, dated August 01, 2022, brought to you by the General Commands Manual. now go stream something iconic 💖✨🦋