tvoe(1)

💖 tvoe — TV over ethernet streaming 💖

okay bestie, sit down, we're learning tvoe (that's section 1 of the General Commands Manual, for the record) and honestly? it's giving iconic little streaming server. let's go ✨

🌸 NAME 🌸

tvoe — TV over ethernet streaming. that's it, that's the whole name, no notes 💅

🎀 SYNOPSIS 🎀

tvoe [-h] [-c config] [-f]

look at her. three flags. lowkey minimal, highkey powerful 🦋

✨ DESCRIPTION ✨

okay so tvoe (aka TV over Ethernet streaming server) is a lightweight DVB-S/S2 network streaming software. she can serve many transponders on multiple tuners simultaneously, and she does dynamic tuner allocation to the clients — which means you can literally add more stations to your channel list than your tuner config would ever be able to stream at once. the tuners get handed out on demand. main character energy fr fr 👑

tvoe is designed for a homogenous tuner configuration, meaning: if you're putting DVB-S2 channels in your channel list, then all your configured tuners should be S2-capable. no mixing, bestie, she's not built for that.

also, real talk: tvoe only supports S2API for tuner configuration. some legacy systems and DVB-S1-only drivers might not support S2API at all, and therefore cannot be used with tvoe. periodt. 💀

📺 channel lists (the zap format moment)

tvoe uses the same format for channel lists as the zap(1) utility from dvb-tools. and the good news? they're super easy to generate — use scan, wscan, or any other utility that supports the zap file format 🌈

for example, to generate a channel list of all channels on Astra 19.2E (mostly relevant for central Europe, iykyk), you can do:

scan /usr/share/dvb/dvb-s/Astra-19.2E > channels.conf

All channels listed in the channels.conf will be served by tvoe. so if you don't want some of them? remove the unused channels from the list before using it. declutter, bestie 🧹✨

⚙️ get it running

next up: adjust the example config file to match your tuner configuration. make sure to set the correct path to the channel list (this is the part people forget and then get mad, so like… don't 🙈). then you can start tvoe using:

tvoe -f CONFIGFILE

🌐 how you actually watch it

the streams can then be accessed via:

http://IP:CONFIGURED_PORT/by-sid/SID

where SID is the DVB service ID of the requested station — that's the second-last column in the channel specification in channels.conf 📝

additional URLs might be added in the future 👀 (manifesting)

💅 OPTIONS 💅

• -h — display a short usage summary. the "help me" button, we love her 🫶
• -c config — use the specified config. point her at your config file, slay.
• --p pidfile — write process PID to given pidfile. yes the flag really is --p, no she's not like other girls 💀
• --q — (quiet) — don't write debug output to stdout when starting. shhh, no thoughts, just vibes 🤫
• -f — start tvoe as a foreground process and disable forking to the background. she stays right there with you, watching 🌸

👑 AUTHORS 👑

tvoe is written by Dominik Paulus, inspired by the classic getstream utility — but designed for greater flexibility by not using a fixed transponder configuration. glow up fr ✨

📜 COPYRIGHT 📜

Copyright (c) 2013-2014 Dominik Paulus. License: ISC license.

🐛 BUGS 🐛

at the moment, tvoe only supports S2API, even for normal DVB-S-streams. yes, even then. it's the one (1) little flaw, we accept her as she is 😭💖

and that's the whole page bestie!! tvoe — from the General Commands Manual, section 1, no cap. she's small, she's speedy, she streams DVB-S/S2 over ethernet and she does it gorgeously. go forth and stream responsibly 🦋💜