.Dd $Mdocdate: Dec 16 2020$
.Dt SHOUT 1
.Os
.\"
.Sh "نام (NAME)"
.\"
.Nm shout
.Nd کلاینت منبع برای پخش و ارسال جریان به Icecast
.\"
.Sh "خلاصه دستور (SYNOPSIS)"
.\"
.Nm
[OPTIONS]
.\"
.Sh "توضیحات (DESCRIPTION)"
.\"
.Nm
داده‌ها را از ورودی استاندارد خوانده و به سرور Icecast ارسال (استریم) می‌کند.
.\"
.Sh "گزینه‌ها (OPTIONS)"
.\"
.Bl -tag -width 4n
.\"
.It Fl \-format Ar format
تنظیم فرمت استریم. می‌تواند "ogg"، "mp3" یا "webm" باشد. مقدار پیش‌فرض "ogg" است.
.\"
.It Fl H Ar host
نگاه کنید به
.Fl \-host
.\"
.It Fl h
نگاه کنید به
.Fl \-help
.\"
.It Fl \-help
نمایش راهنما.
.\"
.It Fl \-host Ar host
تنظیم میزبان مقصد. مقدار پیش‌فرض "localhost" است.
.It Fl \-mount Ar string
تنظیم نقطه اتصال (mountpoint). مقدار پیش‌فرض "/example.ogg" است.
.\"
.It Fl P Ar port
نگاه کنید به
.Fl \-port
.\"
.It Fl \-pass Ar string
تنظیم گذرواژه منبع. مقدار پیش‌فرض "hackme" است.
.\"
.It Fl \-port Ar port
تنظیم پورت مقصد. از نام‌های نمادین نیز پشتیبانی می‌شود. مقدار پیش‌فرض 8000 است.
.\"
.It Fl \-proto Ar protocol
تنظیم پروتکل. مقدار پیش‌فرض "http" است.
.\" STATION METADATA
.It Fl \-station-description Ar string
تنظیم توضیحات استریم.
.\"
.It Fl \-station-genre Ar string
تنظیم ژانر (سبک) استریم.
.\"
.\" --station-meta
.It Fl \-station-meta Ar key Ns No = Ns Ar value
تنظیم متادیتا. هر دو پارامتر
.Ar key
و
.Ar value
رشته‌های دلخواه هستند.
.\"
.It Fl \-station-name Ar string
تنظیم نام استریم.
.\"
.It Fl \-station-url Ar string
تنظیم نشانی وب (URL) استریم.
.\"
.It Fl \-tls-mode Ar tls-mode
تنظیم حالت TLS. می‌تواند "disabled"، "auto"، "auto_no_plain"، "rfc2818" یا "rfc2817" باشد. مقدار پیش‌فرض "auto" است.
.Pp
هنگامی که libshout بدون پشتیبانی از TLS ساخته شده باشد، تنها مقادیر "disabled" و "auto" پشتیبانی می‌شوند.
.\"
.It Fl \-usage Ar usage{,usage}
تنظیم کاربردهای استریم. می‌تواند شامل موارد زیر باشد:
.Bl -tag -width 13n -compact
.It Qq audio
برای زیرجریان‌های صوتی
.It Qq visual
برای زیرجریان‌های تصویر/ویدیو (اغلب در ترکیب با "audio")
.It Qq text
برای زیرجریان‌های متنی به جز زیرنویس‌ها
.It Qq subtitle
برای زیرجریان‌های زیرنویس
.It Qq light
برای زیرجریان‌های کنترل نورپردازی
.It Qq ui
برای داده‌های رابط کاربری، مانند منوها یا دکمه‌های DVD
.It Qq metadata
برای زیرجریان‌هایی که شامل فراداده (متادیتا) برای استریم هستند
.It Qq application
برای زیرجریان‌های داده ویژه برنامه‌های کاربردی
.It Qq control
برای زیرجریان‌هایی که زیرساخت را کنترل می‌کنند
.It Qq complex
برای زیرجریان‌هایی که خود ترکیبی از انواع دیگر هستند
.It Qq other
برای زیرجریان‌هایی از انواعی که در اینجا ذکر نشده است
.It Qq unknown
برای جریان‌هایی که ممکن است شامل زیرجریان‌های اضافی با ماهیت ناشناخته باشند
.It Qq 3d
برای جریان‌هایی که شامل اطلاعات پخش سه‌بعدی هستند
.It Qq 4d
برای جریان‌هایی که شامل اطلاعات پخش 4D/XD هستند
.El
.\"
.It Fl \-user Ar string
تنظیم کاربر منبع. مقدار پیش‌فرض "source" است.
.\"
.El
.\"
.Sh "نکات (NOTES)"
اگر به این باینری پیوند نمادین (symlink) یا پیوند سخت به نام "oggfwd" داده شود، سازگاری جایگزین مستقیم با
.Xr oggfwd 1
فراهم می‌کند.