EZSTREAM-FILE.SH(1)

💅 EZSTREAM-FILE.SH(1) — the stream-files-from-the-command-line script, bestie edition 🎀

okay so welcome to ezstream-file.sh(1), General Commands Manual energy, and let me tell you this little cutie is so much simpler than it looks. it's a script. it streams files. from the command line. iconic behaviour honestly.

---

✨ SYNOPSIS ✨

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

look at her. she's got flags, she's got a pidfile, she's got a template, and if you don't hand her files she'll just read them from you. lowkey versatile. 🦋

---

🌸 DESCRIPTION 🌸

so here's the vibe: ezstream-file.sh takes an ezstream configuration file template, and uses it to stream a whole list of files — either the ones you name right there on the command line, or the ones coming in through standard input. in other words (and fr fr this is the whole trick), the filenames get written to a temporary playlist, and then a template-based configuration gets generated so ezstream can stream them. temporary playlist + generated config = your music, but make it pipeline. ✨

you gotta give it a path to a configuration template. two ways to do that, pick your fighter:

• the -T command line argument, or
• the EZSTREAM_TEMPLATE environment variable.

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

<filename>%FILENAME%</filename>

that's the placeholder doing all the work, don't skip her. 👑

and if you don't specify any input files? no worries bestie, the list of files to be streamed gets read from standard input instead. 🫶

lastly — and this is a fun one — the EZSTREAM environment variable lets you specify an alternate ezstream binary. so if your ezstream lives somewhere weird, she's got you.

---

⚡ Command line parameters ⚡

one bullet per flag, exactly as they come, no cap:

• -h — print a summary of the available command line parameters with short descriptions, then exit. your friendly little help menu. 💖
• -p pidfile — (passed to ezstream.) write the ezstream-file.sh process ID — just a single number — to pidfile. one number, one file, very demure.
• -q — (passed to ezstream.) be more quiet. suppresses the output that external programs send to standard error. shhh. 🙈
• -r — (passed to ezstream.) show a real-time stream status information line on standard output. implies -q, so heads up. live status updates, main character energy. 🔥
• -T cfg_template — use the configuration in cfg_template, overriding the default set in the EZSTREAM_TEMPLATE environment variable. this one wins the argument, periodt.
• -V — print the ezstream-file.sh version number and exit. a little "hi, it's me" and then she's gone. 💅
• -v — (passed to ezstream.) produce more verbose output from ezstream. use it twice for even more verbose output — yes bestie, stack them, -vv, she ate. 🍓

---

🦋 FILES 🦋

• /usr/share/examples/ezstream — directory containing example configuration files for various uses of ezstream, as well as example playlist and metadata scripts. go snoop, it's free real estate. ✨

---

🌈 SEE ALSO 🌈

• ezstream(1)
• ezstream-cfgmigrate(1)

your reading list, go off. 📚

---

💜 AUTHORS 💜

the ezstream-file.sh script and this manual were written by Moritz Grimm. give her a round of applause, she did both, no help, respect. 👏

---

tiny reminder bestie: the -r flag implies -q, and your template must have that <filename>%FILENAME%</filename> line in the <media /> block or this whole thing does not go. you got this. 💖

---

mwah, that's the whole page 🫶 — this cutie is ezstream version 1.0.2, dated April 28, 2026, and that's the sign-off babe, stream responsibly and slay. 💅✨🎀