SHOUT(1)

💖 SHOUT(1) — the manual, but make it cute 💖

okay so bestie, welcome to the General Commands Manual entry for shout — yes the name is literally in ALL CAPS, it's giving main character energy and honestly? slay. Sit down, grab a strawberry 🍓, and let's get you streaming.

✨ NAME ✨

shout — Icecast source client 👑

✨ SYNOPSIS ✨

shout [OPTIONS]

✨ DESCRIPTION ✨

So here's the vibe: shout reads data from standard input and streams it to Icecast. That's it. That's the whole thing. You feed it bytes on stdin, it yeets them at Icecast. No cap. 🦋

✨ OPTIONS ✨

Every single flag, no gatekeeping, we're going through ALL of them 💅

• --format format — Sets the stream format. It can be "ogg", "mp3", or "webm". Default is "ogg".
• -H host — See --host (same thing, shorter name, we love an alias ✨)
• -h — See --help
• --help — Shows help. Iconic of it.
• --host host — Sets the destination host. Default is "localhost".
• --mount string — Sets the mountpoint. Default is "/example.ogg".
• -P port — See --port
• --pass string — Sets the source password. Default is "hackme". (Yes really. Change it bestie, I'm begging 😭)
• --port port — Sets the destination port. Symbolic names are supported. Default is 8000.
• --proto protocol — Sets the protocol. Default is "http".
• --station-description string — Sets the stream description.
• --station-genre string — Sets the stream genre.
• --station-meta key=value — Sets meta information. Both key and value are arbitrary strings, so go feral 🎀
• --station-name string — Sets the stream name.
• --station-url string — Sets the stream URL.
• --tls-mode tls-mode — Sets the TLS mode. This can be "disabled", "auto", "auto_no_plain", "rfc2818", or "rfc2817". Default is "auto".

Heads up: when libshout is built without TLS support, only "disabled" and "auto" are supported. That's it, those two, the rest are not invited to the party 🙈

• --usage usage{,usage} — Sets the stream usages. This can be:
  • "audio" — for audio substreams
  • "visual" — for picture/video substreams (most often combined with "audio")
  • "text" — for text substreams that are not subtitles
  • "subtitle" — for subtitle substreams
  • "light" — for light control substreams
  • "ui" — for user interface data, such as DVD menus or buttons
  • "metadata" — for substreams that include metadata for the stream
  • "application" — for application specific data substreams
  • "control" — for substreams that control the infrastructure
  • "complex" — for substreams that are themself a mixture of other types
  • "other" — for substream of types not listed here
  • "unknown" — for streams that may contain additional substreams of unknown nature
  • "3d" — for streams that contain information for 3D playback
  • "4d" — for streams that contain information for 4D/XD playback
• --user string — Sets the source user. Default is "source".

✨ NOTES ✨

okay this part is lowkey fun: if this binary is symlinked, or hardlinked, to the name "oggfwd", it provides drop-in compatibility with oggfwd(1). So like, one binary, two identities, very shapeshifter of it 🧚✨

and that's the whole page bestie, you're officially certified 🫶

This one came from Debian, dated Dec 16, 2020. Go stream something iconic. Periodt. 💅🌈⭐