| STREAMLINK(1) | Streamlink | STREAMLINK(1) |
نام (NAME)
streamlink - استخراج جریانهای ویدیویی از سرویسهای گوناگون و هدایت آنها به پخشکننده ویدیوی دلخواه
خلاصه دستور (SYNOPSIS)
streamlink [OPTIONS] <URL> [STREAM]
مثالها (EXAMPLES)
streamlink --loglevel debug youtu.be/VIDEO-ID best streamlink --player mpv --player-args '--no-border --no-keepaspect-window' twitch.tv/CHANNEL 1080p60 streamlink --player-external-http --player-external-http-port 8888 URL STREAM streamlink --output /path/to/file --http-timeout 60 URL STREAM streamlink --stdout URL STREAM | ffmpeg -i pipe:0 ... streamlink --http-header 'Authorization=OAuth TOKEN' --http-header 'Referer=URL' URL STREAM streamlink --hls-live-edge 5 --stream-segment-threads 5 'hls://https://host/playlist.m3u8' best streamlink --twitch-low-latency -p mpv -a '--cache=yes --demuxer-max-back-bytes=2G' twitch.tv/CHANNEL best
گزینهها (OPTIONS)
آرگومانهای مکانی (Positional arguments)
- URL
- نشانی
اینترنتی (URL)
برای تلاش
جهت
استخراج
جریانهای
ویدیویی از
آن.
معمولاً بسته به پیادهسازی افزونه مورد استفاده، میتوان پروتکل نشانیهای http(s) (https://) را حذف کرد.
همچنین میتوان URL را با استفاده از گزینه --url نیز مشخص نمود.
- STREAM
- جریان
ویدیویی
(استریم)
برای پخش.
برای انتخاب بالاترین یا پایینترین کیفیت موجود، از best یا worst استفاده کنید.
جریانهای جایگزین (fallback) را میتوان با یک فهرست جداشده با کاما تعیین کرد:
"720p,480p,best"
اگر هیچ جریانی مشخص نشده باشد و از --default-stream نیز استفاده نشود، فهرستی از جریانهای موجود چاپ خواهد شد.
گزینههای عمومی (General options)
- --version-check
- بررسی نسخه برنامه و خروج.
- --auto-version-check {yes,true,1,on,no,false,0,off}
- فعال یا
غیرفعال
کردن بررسی
خودکار
برای نسخه
جدید Streamlink.
پیشفرض: "no".
- --config FILENAME
- بارگذاری
گزینهها
از این فایل
پیکربندی.
برای بارگذاری چندین فایل میتوان آن را تکرار کرد؛ در این حالت، گزینهها روی یکدیگر ادغام میشوند و آخرین فایل پیکربندی بالاترین اولویت را خواهد داشت.
- --no-config
- غیرفعال کردن بارگذاری هرگونه فایل پیکربندی پیشفرض یا سفارشی.
- --locale LOCALE
- نادیدهگرفتن
تنظیم محلی
(locale) سیستم جهت
انتخاب
زبان
ترجیحی
زیرنویس و
صدا.
قالب مشخصکننده محلی بهصورت [language_code]_[country_code] است؛ مانند en_US یا es_ES.
پیشفرض: system locale.
- -l LEVEL
- --loglevel LEVEL
- تنظیم
آستانه
پیامهای
گزارشگیری.
سطوح معتبر، به ترتیب افزایش میزان پرگویی (verbosity):
none, critical, error, warning, info, debug, trace, all
مقدار پیشفرض: "info".
- --logformat FORMAT
- تنظیم یک
قالب
سفارشی
برای
گزارشگیری.
برای اطلاعات بیشتر درباره قالب گزارشگیری و مشخصههای موجود در LogRecord، به مستندات logging.Formatter کتابخانه استاندارد پایتون مراجعه کنید. قالببند Streamlink از سبک آکولاد ({}) استفاده میکند.
قالب پیشفرض به سطح لاگ انتخابشده بستگی دارد.
برای سطوح با جزئیات بالا (trace و all):
مقدار پیشفرض: "[{asctime}][{threadName}][{name}][{levelname}] {message}".
در غیر این صورت:
مقدار پیشفرض: "[{name}][{levelname}] {message}".
- --logdateformat DATEFORMAT
- تنظیم یک
قالب تاریخ
سفارشی
برای
گزارشگیری.
این گزینه مشخصه asctime مربوط به LogRecord را از طریق strftime() قالببندی میکند.
قالب پیشفرض تاریخ به سطح لاگ انتخابشده بستگی دارد.
برای سطوح با جزئیات بالا (trace و all):
مقدار پیشفرض: "%H:%M:%S.%f".
در غیر این صورت:
مقدار پیشفرض: "%H:%M:%S".
- --logfile FILE
- الحاق
خروجی
گزارش به FILE
بهجای
نوشتن در stdout/stderr.
اعلانهای کاربر و روند پیشرفت بارگیری در FILE نوشته نخواهند شد.
مقدار - (خط تیره) نام فایل را روی یک رشته شبیه به ISO8601 تنظیم میکند و دایرکتوریهای پیشفرض زیر را برای گزارشگیری انتخاب خواهد کرد.
Windows:
%TEMP%\streamlink\logs
macOS:
${HOME}/Library/Logs/streamlink
Linux/BSD:
${XDG_STATE_HOME:-${HOME}/.local/state}/streamlink/logs
گزینههای افزونه (Plugin options)
- --plugins
- چاپ فهرستی از تمام افزونههای نصبشده فعلی.
- --show-matchers PLUGIN
- نمایش
فهرست
تطبیقدهندههای
یک افزونه
خاص (الگوی regex
برای URL به
همراه
اولویت
اختیاری و
نام
اختیاری).
خروجی در قالبی شبیه به YAML و خوانا برای انسان است. لطفاً هنگام خواندن دادههای تطبیقدهنده به صورت برنامهنویسیشده از --json استفاده کنید.
- --can-handle-url URL
- بررسی
اینکه آیا
Streamlink
افزونهای
دارد که
بتواند URL
مشخصشده
را مدیریت
کند یا خیر.
کد وضعیت در صورت موفقیت 0 و در صورت شکست 1 است.
برای اسکریپتنویسی خارجی مفید است.
- --can-handle-url-no-redirect URL
- مشابه --can-handle-url، اما بدون دنبال کردن تغییرمسیرها (redirects) هنگام بررسی URL.
- --no-plugin-cache
- غیرفعالسازی
ورودی/خروجی
(I/O) مخزن
کلید-مقدار
افزونه.
در صورت غیرفعال بودن، افزونهها قادر به بارگذاری یا ذخیره دادههایی مانند کوکیها، اطلاعات احراز هویت و غیره نخواهند بود. دادههایی که بارگذاری یا ذخیره میشوند به پیادهسازی هر افزونه بستگی دارند.
- --no-plugin-sideloading
- غیرفعالسازی
بارگذاری
جانبی
خودکار (sideloading)
افزونههای
شخص ثالث از
مکان
پیشفرض.
برای آگاهی از مکانی که افزونههای شخص ثالث از آن بارگذاری میشوند، به مستندات بارگذاری جانبی افزونه (plugin-sideloading) مراجعه کنید.
- --plugin-dir DIRECTORY
- بارگذاری
افزونههای
اضافی از
این
دایرکتوری.
میتواند چندین بار برای بارگذاری افزونهها از چند دایرکتوری مشخص شود.
- --plugin-dirs DIRECTORY
- بارگذاری افزونههای اضافی از فهرستی از دایرکتوریهای جداشده با کاما. (منسوخشده)
- --interface INTERFACE
- رابط شبکه
را بر اساس
نشانی IP یا
نام رابط
انتخاب
میکند.
پیشوندهای اختیاری زیر پشتیبانی میشوند:
- if!<name> نام رابط
- host!<name> نشانی IP یا نام میزبان (hostname)
- ifhost!<interface>!<host> نام رابط و نشانی IP یا نام میزبان
نکته:
- -4
- --ipv4
- نامهای نشانی را فقط به IPv4 تحلیل (resolve) میکند. این گزینه بر --ipv6 اولویت دارد.
- -6
- --ipv6
- نامهای نشانی را فقط به IPv6 تحلیل (resolve) میکند. این گزینه بر --ipv4 اولویت دارد.
گزینههای پخشکننده (Player options)
- -p PATH
- --player PATH
- فایل
اجرایی
پخشکنندهای
را که اجرا
خواهد شد
تنظیم
میکند (مگر
اینکه روش
خروجی
متفاوتی
انتخاب شده
باشد).
میتوانید یک مسیر مطلق یا نسبی به فایل اجرایی پخشکننده را تعیین کنید، یا اگر نام فایل اجرایی از طریق مسیرهای متغیر محیطی PATH سیستم قابل شناسایی باشد، تنها نام آن را مشخص کنید.
علاوه بر تنظیم مسیر فایل اجرایی پخشکننده، آرگومانهای سفارشی پخشکننده را میتوان از طریق --player-args تعیین کرد.
نکته:
پیشفرض: پخشکننده VLC در صورت موجود بودن.
- -a ARGUMENTS
- --player-args ARGUMENTS
- رشتهای از
آرگومانهای
سفارشی
برای
راهاندازی
--player را تنظیم
میکند که
تجزیه و
نشانهگذاری
(tokenize) خواهند
شد.
این مقدار میتواند شامل متغیرهای قالببندی باشد که درون آکولاد { و } احاطه شدهاند. نویسههای آکولاد را میتوان با تکرار دوتایی آنها، مانند {{ و }}، گریزدهی (escape) کرد.
متغیرهای قالببندی موجود:
- {playerinput}
- این آرگومان ورودی است که --player دریافت خواهد کرد. برای ورودی استاندارد (stdin)، این مقدار - (خط تیره) است، اما بسته به گزینههای استفاده شده میتواند یک مسیر فایل یا URL نیز باشد. اگر تنظیم نشود، آرگومان ورودی پخشکننده به انتهای فهرست آرگومانهای تجزیهشدهٔ پخشکننده پیوست خواهد شد.
- {playertitleargs}
- آرگومانهای عنوان پخشکننده که به طور خودکار تولید میشوند، البته در صورتی که یک --player پشتیبانیشده پیدا شود. برای اطلاعات بیشتر --title را ببینید. در صورت عدم تنظیم، آرگومانهای عنوان پخشکننده که به طور خودکار تولید شدهاند به ابتدای فهرست آرگومانهای تجزیهشدهٔ پخشکننده اضافه میشوند.
مثال:
streamlink -p vlc -a "--play-and-exit --no-one-instance" <url> [stream]
پیشفرض: "".
- --player-env KEY=VALUE
- یک متغیر
محیطی
اضافی،
افزون بر
متغیرهای
به ارث
رسیده از
فرایند
والد Streamlink/Python،
به فرایند
ایجادشدهٔ
--player اضافه
میکند. این
ویژگی
امکان
تنظیم
متغیرهای
محیطی
پخشکننده
را در
فایلهای
پیکربندی
فراهم
میسازد.
برای افزودن چندین متغیر محیطی میتوان آن را تکرار کرد.
- -v
- --player-verbose
- خروجی stdout/stderr مربوط به --player را در خروجی stdout/stderr مربوط به Streamlink مینویسد.
- --verbose-player
- منسوخ شده و به جای آن باید از --player-verbose استفاده شود.
- -n
- --player-fifo
- باعث میشود --player جریان را از طریق یک لولهٔ نامگذاریشده (named pipe) به جای لولهٔ stdin بخواند.
- --fifo
- منسوخ شده و به جای آن باید از --player-fifo استفاده شود.
- --player-http
- باعث میشود --player جریان را به جای لولهٔ stdin از طریق HTTP بخواند.
- --player-continuous-http
- باعث
میشود --player
جریان را از
طریق HTTP
بخواند،
اما برخلاف
--player-http، در
صورت
درخواست
پخشکننده،
به طور
مداوم تلاش
خواهد کرد
تا جریان را
دوباره باز
کند.
این گزینه در صورتی که پخشکننده توانایی اتصال مجدد به یک جریان HTTP را داشته باشد، امکان مدیریت قطع شدن جریان را فراهم میکند. این کار معمولاً با تنظیم پخشکننده روی حالت «تکرار» ("repeat mode") انجام میشود.
- --player-external-http
- دادههای
جریان را
بدون باز
کردن --player از
طریق HTTP
ارائه
میدهد. این
ویژگی به
دستگاههای
خارجی
مانند
گوشیهای
هوشمند یا
گیرندههای
استریم
اجازه
میدهد
جریانهایی
را تماشا
کنند که در
غیر این
صورت قادر
به پخش
آنها
نبودند.
رفتار پیشفرض مشابه گزینهٔ --player-continuous-http است، اما هیچ برنامهٔ پخشکنندهای آغاز نخواهد شد، و کارساز به جای رابط محلی (loopback)، روی تمامی اتصالات در دسترس گوش خواهد داد.
برای انتخاب یک رابط شبکهٔ خاص، --player-external-http-interface و برای انتخاب یک درگاه غیرتصادفی، --player-external-http-port را ببینید.
به صورت اختیاری، گزینهٔ --player-external-http-continuous اجازه میدهد حالت اجرای مداوم غیرفعال شود تا Streamlink با پایان یافتن جریان متوقف شود.
نشانیهای URL قابل استفاده برای دسترسی به جریان روی کنسول چاپ خواهند شد، و کارساز را میتوان با استفاده از CTRL-C متوقف کرد.
- --player-external-http-continuous {yes,true,1,on,no,false,0,off}
- حالت اجرای
--player-external-http را روی
مداوم (continuous) یا
غیرمداوم
(non-continuous) تنظیم
میکند.
در حالت اجرای مداوم، Streamlink پس از پایان جریان به اجرا ادامه میدهد و منتظر درخواست HTTP بعدی میماند، مگر اینکه با CTRL-C متوقف شود.
اگر روی غیرمداوم تنظیم شود، Streamlink به محض پایان یافتن جریان متوقف خواهد شد.
پیشفرض: true.
- --player-external-http-interface INTERFACE
- رابط شبکهای را که کارساز HTTP روی آن گوش خواهد داد تنظیم میکند. در صورت عدم تعیین یا مقداردهی به 0.0.0.0، به تمامی رابطهای در دسترس متصل خواهد شد.
- --player-external-http-port PORT
- در صورت فعال بودن این حالت، درگاه کارساز HTTP خارجی را تنظیم میکند. برای استفاده از یک درگاه تصادفی بالا (>1024)، این گزینه را نادیده بگیرید یا روی 0 تنظیم کنید.
- --player-passthrough TYPES
- فهرستی
جداشده با
کاما از
انواع
جریان برای
ارسال به --player
به صورت یک URL
تا به جای
Streamlink، انتقال
جریان را
مدیریت کند.
انواع جریانهایی که قابلیت تبدیل به یک URL قابل پخش را دارند عبارتند از:
hls, http
هنگام استفاده از این گزینه، مطمئن شوید که پخشکننده توانایی مدیریت این نوع جریان را دارد.
- --player-no-close
- به طور
پیشفرض،
Streamlink پس از
پایان
جریان --player را
میبندد.
این کار
برای
جلوگیری از
باز ماندن
پخشکنندههای
گرافیکی
معلق پس از
خروج Streamlink است.
با این وجود، این موضوع اثر جانبی بستن پخشکننده را پیش از آنکه تمام دادههای ذخیرهشده در حافظهٔ موقت خود را پخش کند، به همراه دارد.
این گزینه در عوض به پخشکننده اجازه میدهد که خودش دربارهٔ زمان خروج تصمیم بگیرد.
- --title TITLE
- تغییر
عنوان
پنجرهی --player.
لطفاً برای مشاهده تمامی متغیرهای فراداده موجود به بخش "Metadata variables" در مستندات خط فرمان Streamlink و همچنین به بخش "Plugins" برای فهرست متغیرهای فراداده تعریفشده در هر افزونه مراجعه کنید.
تنها پخشکنندههای زیر پشتیبانی میشوند:
- mpv
- PotPlayer
- VLC
مثال:
streamlink -p mpv --title "{author} - {category} - {title}" <URL> [STREAM]
گزینههای خروجی فایل
- -o FILENAME
- --output FILENAME
- نوشتن
دادههای
استریم در
FILENAME به جای
پخش آن در
--player. اگر FILENAME
روی - (خط
تیره) تنظیم
شده باشد،
دادههای
استریم
مشابه
آرگومان --stdout
در stdout نوشته
خواهند شد.
در صورت مجاز بودن مجوزهای سیستمفایل، دایرکتوریها و زیردایرکتوریها در صورت عدم وجود ایجاد خواهند شد.
مگر اینکه --force تنظیم شده باشد، Streamlink در صورتی که FILENAME از قبل وجود داشته باشد، پیش از نوشتن درخواست تأیید خواهد کرد.
لطفاً برای مشاهده تمامی متغیرهای فراداده موجود به بخش "Metadata variables" در مستندات خط فرمان Streamlink و همچنین به بخش "Plugins" برای فهرست متغیرهای فراداده تعریفشده در هر افزونه مراجعه کنید.
نویسههای پشتیبانینشده در متغیرهای جایگزینشده با یک زیرخط (_) جایگزین میشوند.
مثال:
streamlink --output "~/recordings/{author}/{category}/{id}-{time:%Y%m%d%H%M%S}.ts" <URL> [STREAM]
- -r FILENAME
- --record FILENAME
- نوشتن
دادههای
استریم در
FILENAME همزمان
با فراهم
کردن امکان
پخش در --player یا
نوشتن آن در
--stdout. اگر FILENAME
روی - (خط
تیره) تنظیم
شده باشد،
دادههای
استریم در
عین باز
نگهداشتن
پخشکننده،
مشابه
آرگومان --stdout
در stdout نوشته
خواهند شد.
در صورت مجاز بودن مجوزهای سیستمفایل، دایرکتوریها و زیردایرکتوریها در صورت عدم وجود ایجاد خواهند شد.
مگر اینکه --force تنظیم شده باشد، Streamlink در صورتی که FILENAME از قبل وجود داشته باشد، پیش از نوشتن درخواست تأیید خواهد کرد.
لطفاً برای مشاهده تمامی متغیرهای فراداده موجود به بخش "Metadata variables" در مستندات خط فرمان Streamlink و همچنین به بخش "Plugins" برای فهرست متغیرهای فراداده تعریفشده در هر افزونه مراجعه کنید.
نویسههای پشتیبانینشده در متغیرهای جایگزینشده با یک زیرخط (_) جایگزین میشوند.
مثال:
streamlink --record "~/recordings/{author}/{category}/{id}-{time:%Y%m%d%H%M%S}.ts" <URL> [STREAM]
- -R FILENAME
- --record-and-pipe FILENAME
- منسوخ شده است؛ به جای آن از --stdout --record=FILENAME استفاده کنید.
- --fs-safe-rules {POSIX,Windows}
- قواعد مورد
استفاده
برای
ایمنسازی
متغیرهای
قالببندی
برای
سیستمفایل
به صورت
خودکار بر
اساس نوع
سیستمِ
مورد
استفاده
انتخاب
میشوند.
این گزینه
تشخیص
خودکار را
نادیده
میگیرد.
برای زمانی در نظر گرفته شده است که Streamlink روی یک سیستمعامل شبهیونیکس اجرا میشود اما روی سیستمفایلهای Windows مانند NTFS، دستگاههای USB دارای VFAT یا exFAT، اشتراکهای CIFS که محدودیتهای نامگذاری فایل ویندوز را اعمال میکنند و غیره داده مینویسد.
این نویسهها برای قواعد مورد استفاده با یک زیرخط جایگزین میشوند:
- POSIX: \x00-\x1F /
- Windows: \x00-\x1F \x7F " * / : < > ? \ |
- --skip
- هنگام
استفاده از
--output یا --record،
اگر فایل از
قبل وجود
داشته باشد
هرگز درون
آن ننویس
(بدون اعلان
و پرسش).
بر --force تقدم دارد.
- --progress {yes,force,no}
- هنگام
استفاده از
--output یا --record،
نوار
پیشرفت
بارگیری را
نمایش داده
یا پنهان
میکند، یا
در صورت
نبود
ترمینال
نمایش آن را
اجباری
میسازد.
پیشفرض: yes.
- --url URL
- یک URL برای
تلاش جهت
استخراج
استریمها
از آن.
معمولاً بسته به پیادهسازی افزونهٔ (plugin) مورد استفاده، میتوان پروتکل نشانیهای وب http(s) را حذف کرد (https://).
این گزینه جایگزینی برای تنظیم URL با استفاده از آرگومان مکانی است و در صورت تنظیم در فایل پیکربندی میتواند مفید باشد.
- --default-stream STREAM
- استریم
برای پخش.
از best یا worst برای انتخاب بالاترین یا پایینترین کیفیت موجود استفاده کنید.
استریمهای جایگزین (fallback) را میتوان با استفاده از یک فهرست جداشده با کاما مشخص کرد:
"720p,480p,best"
این گزینه جایگزینی برای تنظیم استریم با استفاده از یک آرگومان مکانی است و در صورت تنظیم در فایل پیکربندی میتواند مفید باشد.
- --stream-url
- در صورت امکان، استریم شناساییشده را به یک URL تبدیل کرده و آن را چاپ میکند.
- --retry-streams DELAY
- تلاش مجدد
برای واکشی
فهرست
استریمهای
موجود تا
زمان پیدا
شدن
استریمها،
با انتظار
به مدت DELAY
ثانیه بین
هر تلاش.
تعداد دفعات تلاش مجدد را میتوان با --retry-max محدود کرد. برای مقادیر غیرصفرِ --retry-max مقدار پیشفرض 1 در نظر گرفته میشود.
اگر هر دو گزینهٔ --retry-streams و --retry-max روی 0 تنظیم شوند، تنها یک تلاش برای دریافت فهرست استریمهای موجود انجام خواهد شد. این رفتار پیشفرض است.
- --retry-max COUNT
- توقف
دریافت
فهرست
استریمهای
موجود پس از
COUNT بار تلاش
مجدد.
در صورتی که --retry-streams روی مقداری غیرصفر تنظیم شده باشد، مقدار 0 باعث میشود که Streamlink استریمها را به طور نامحدود واکشی کند. اگر --retry-streams تنظیم نشده باشد، تاخیر پیشفرض بین دریافت استریمهای موجود ۱ ثانیه است.
- --retry-open ATTEMPTS
- پس از یک
دریافت
موفقیتآمیز،
تا زمان
صرفنظر
کردن، به
تعداد ATTEMPTS
بار برای
باز کردن
استریم
تلاش
میکند.
پیشفرض: 1 است.
- --stream-types TYPES
- --stream-priority TYPES
- فهرستی از
انواع
استریمهای
مجاز که با
کاما از هم
جدا
شدهاند.
هنگامی که چندین استریم با نام یکسان اما انواع استریم متفاوت وجود داشته باشند، از این ترتیب برای تفکیک استریمها استفاده خواهد شد. هر نوع استریمی که در فهرست قید نشده باشد، از فهرست استریمهای موجود حذف خواهد شد. از * (ستاره) میتوان بهعنوان نویسه عمومی (wildcard) برای تطابق با هر نوع استریم دیگری، مانند dash استفاده کرد.
پیشفرض: "hls,http,*" است.
- --stream-sorting-excludes STREAMS
- تنظیم دقیق
مترادفهای
نام استریم
best و worst با
مستثنی
کردن
استریمهای
ناخواسته.
اگر تمام استریمهای موجود مستثنی شوند، best و worst غیرقابل دسترس خواهند شد و مترادفهای استریم ویژهٔ جدید best-unfiltered و worst-unfiltered میتوانند به عنوان روش انتخاب جایگزین (fallback) استفاده شوند.
قالب عبارت فیلتر (filter-expression) عبارت است از:
[operator]<value>
عملگرهای معتبر عبارتند از >، >=، < و <=. در صورتی که هیچ عملگری مشخص نشود، برابری بررسی میشود.
برای مثال این عبارت استریمهایی با رتبهٔ بالاتر از "480p" را مستثنی میکند:
--stream-sorting-excludes ">480p"
میتوان با جدا کردن هر عبارت با کاما، از چندین فیلتر استفاده کرد.
برای مثال این عبارت استریمها را از دو نوع کیفیت مستثنی میکند:
--stream-sorting-excludes ">480p,>medium"
- --ringbuffer-size SIZE
- حداکثر
اندازه
بافر
حلقهای (ringbuffer).
میتوان مبیبایت یا کیبیبایت (بر مبنای ۲) را به ترتیب با پسوندهای M یا K مشخص کرد.
بافر حلقهای به عنوان یک فضای ذخیرهسازی موقت میان جریان و پخشکننده (player) استفاده میشود. این به Streamlink اجازه میدهد جریان را سریعتر از پخشکنندهای که دادهها را از بافر حلقهای میخواند بارگیری کند.
هرچه اندازه بافر حلقهای کوچکتر باشد، در صورت کاهش سرعت بارگیری، احتمال بافرینگ در پخشکننده بیشتر خواهد بود؛ و هرچه اندازه بزرگتر باشد، دادههای بیشتری میتوانند ذخیره شوند تا نوسانات سرعت بارگیری جبران گردد.
بیشتر پخشکنندهها کَشِ اضافی مخصوص به خود را دارند و به محض در دسترس قرار گرفتن داده، محتوای بافر حلقهای را خواهند خواند. اگر در زمان توقف موقت (pause) پخش، خواندن دادهها توسط پخشکننده متوقف شود، تا زمانی که بافر حلقهای پر نشود، Streamlink در پسزمینه به بارگیری جریان ادامه خواهد داد.
پیشفرض: "16M".
- --stream-segment-attempts ATTEMPTS
- تعداد
دفعات تلاش
برای
بارگیری هر
قطعه (segment) از
جریان پیش
از انصراف.
این گزینه برای تمام انواع مختلف جریانهای قطعهبندیشده، مانند DASH ،HLS و غیره اعمال میشود.
پیشفرض: 3.
- --stream-segment-threads THREADS
- اندازه
استخر
رشتهها (thread pool)
مورد
استفاده
برای
بارگیری
قطعات.
حداقل
مقدار 1 و
حداکثر 10
است.
این گزینه برای تمام انواع مختلف جریانهای قطعهبندیشده، مانند DASH ،HLS و غیره اعمال میشود.
پیشفرض: 1.
- --stream-segment-timeout TIMEOUT
- حداکثر
زمان
انتظار
برای شروع
بارگیری هر
قطعه.
این گزینه برای تمام انواع مختلف جریانهای قطعهبندیشده، مانند DASH ،HLS و غیره اعمال میشود.
پیشفرض: 10.0.
- --stream-segmented-duration [[XX:]XX:]XX[.XX] | [XXh][XXm][XX[.XX]s]
- محدود کردن
مدتزمان
خروجی
جریانهای
قطعهبندیشده،
مانند HLS و DASH.
مدتزمان
واقعی ممکن
است کمی
طولانیتر
باشد، چرا
که به
نزدیکترین
قطعه گرد
میشود.
برای غیرفعال کردن، مقدار آن را 0 قرار دهید.
پیشفرض: 0.
- --stream-segmented-queue-deadline FACTOR
- ضریب ضربی
برای بازه
زمانی که
قطعات جدید
باید در آن
در صف قرار
گیرند تا از
مشکلات پخش
ناشی از
کمبود
دادههای
ویدیویی/صوتی
جلوگیری
شود. اگر
این مهلت صف
قطعه (segment-queue-deadline)
برآورده
نشود،
جریان
زودتر از
موعد متوقف
خواهد شد.
هدف از این مهلت صف قطعه این است که در صورت اعلام نشدن پایان جریان توسط سرور، امکان توقف زودهنگام وجود داشته باشد تا Streamlink مجبور نباشد تا زمان رخداد اتمام مهلت خواندن بافر (read-timeout) منتظر بماند. گزینه --stream-timeout را ببینید.
زمان پایهای که این ضریب بر آن اعمال میشود به پیادهسازی خاص جریان و مقادیر بازگرداندهشده از سرور پخش جریانی بستگی دارد. بررسی این مهلت پس از تلاش برای دریافت دادههای جدید انجام میشود.
برای غیرفعال کردن، مقدار را 0 قرار دهید.
پیشفرض: 3.0.
بهطور پیشفرض، برای در دسترس قرار گرفتن قطعات جدید، سه برابر بازه زمانی اعلامشده توسط سرور منتظر میماند.
- --stream-timeout TIMEOUT
- حداکثر
زمان
انتظار
برای ادامه
خروجی دادن
دادهها
توسط یک
جریان
پالایشنشده
(unfiltered).
این گزینه برای تمام انواع مختلف جریانها، مانند DASH ،HLS ،HTTP و غیره اعمال میشود.
پیشفرض: 60.0.
- --stream-passthrough-encrypted
- عبور دادن
مستقیم
دادهها از
جریانهای
رمزگذاریشده
بدون
رمزگشایی
یا
بررسیهای
رمزگذاری.
این گزینه برای جریانهای DASH و HLS اعمال میشود و به احتمال قوی منجر به خروجی مخدوش و غیرقابل استفاده خواهد شد.
- --mux-subtitles
- ترکیب
خودکار (mux)
زیرنویسهای
موجود در
جریان
خروجی.
باید توسط پلاگین مورد استفاده پشتیبانی شود.
گزینههای HLS (HLS options)
- --hls-live-edge SEGMENTS
- تعداد
قطعات از
موقعیت
زنده
کنونیِ
جریان برای
شروع پخش
جریانی.
اندازه یا
طول هر قطعه
توسط
ارائهدهنده
پخش تعیین
میشود.
مقادیر کمتر، تاخیر (latency) را کاهش میدهند اما احتمال بافرینگ را نیز بالا میبرند؛ زیرا زمان کمتری برای بارگیری قطعات و نوشتن دادههای آنها در بافر خروجی توسط Streamlink وجود دارد. تعداد بارگیریهای موازی قطعات را میتوان با --stream-segment-threads مشخص کرد و زمان بارگذاری مجدد فهرست پخش HLS برای واکشی و در صف قرار دادن قطعات جدید را میتوان با --hls-playlist-reload-time بازنویسی کرد.
پیشفرض: 3.
نکته:
- --hls-segment-stream-data
- نوشتن فوری دادههای قطعه در بافر خروجی در حین بارگیری.
- --hls-playlist-reload-attempts ATTEMPTS
- حداکثر
تعداد
تلاشها
برای
بارگذاری
مجدد فهرست
پخش HLS پیش از
انصراف.
پیشفرض: 3.
- --hls-playlist-reload-time TIME
- تنظیم یک مقدار سفارشی برای زمان بارگذاری مجدد فهرست پخش HLS، بر حسب ثانیه یا با استفاده از یکی از کلیدواژههای زیر:
- segment: مدتزمان آخرین قطعه در فهرست پخش فعلی
- live-edge: مجموع مدتزمان قطعات مربوط به مقدار لبه زنده منهای یک
- default: فراداده (metadata) مدتزمان هدف فهرست پخش
پیشفرض: default.
- --hls-segment-queue-threshold FACTOR
- منسوخ شده؛ به جای آن از --stream-segmented-queue-deadline استفاده کنید.
- --hls-segment-ignore-names NAMES
- فهرستی جدا
شده با
ویرگول از
نامهای
قطعات که
پالایش
(حذف)
خواهند شد.
مثال: --hls-segment-ignore-names 000,001,002
این گزینه تمام قطعاتی را که نام آنها به 000.ts، 001.ts و 002.ts ختم میشود نادیده میگیرد.
پیشفرض: None.
- --hls-segment-key-uri URI
- بازنویسی
URIهای کلید
رمزگذاری
قطعه برای
جریانهای
رمزگذاریشده.
این مقدار میتواند با استفاده از متغیرهای زیر که با بخش مربوطه خود از URI قطعه مبدأ جایگزین میشوند، الگوگذاری شود:
{url} {scheme} {netloc} {path} {query}
مثالها:
--hls-segment-key-uri "https://example.com/hls/encryption_key"
--hls-segment-key-uri "{scheme}://1.2.3.4{path}{query}"
--hls-segment-key-uri "{scheme}://{netloc}/custom/path/to/key"
پیشفرض: None.
- --hls-audio-select CODE
- انتخاب یک
یا چند منبع
صوتی مشخص
بر اساس کد
زبان یا نام
آن.
میتواند
روی *
(ستاره)
تنظیم شود
تا شامل
تمام منابع
صوتی گردد.
مثالها:
--hls-audio-select "English,German" --hls-audio-select "en,de" --hls-audio-select "*"
نکته:
پیشفرض: 0.
- --hls-duration [[XX:]XX:]XX[.XX] | [XXh][XXm][XX[.XX]s]
- به نفع --stream-segmented-duration منسوخ شده است.
- --hls-live-restart
- پرش به ابتدای استریم زنده، یا تا جای ممکن به عقبترین نقطه.
گزینههای DASH
- --dash-manifest-reload-attempts ATTEMPTS
- حداکثر
تعداد
دفعات تلاش
برای
بارگذاری
مجدد
مانیفست DASH
قبل از
انصراف.
پیشفرض: 3.
گزینههای FFmpeg
- --ffmpeg-ffmpeg FILENAME
- تنظیم مکان
فایل
اجرایی FFmpeg در
صورتی که
نتوان آن را
از مسیرهای
متغیر
محیطی PATH
سیستم پیدا
کرد.
برای دسترسی یا میکس (mux) استریمهای ویدیویی و صوتی مجزا، مثلاً در استریمهای DASH یا استریمهای HLS با چند منبع، وجود FFmpeg ضروری است.
مثال: --ffmpeg-ffmpeg "/usr/local/bin/ffmpeg"
- --ffmpeg-no-validation
- غیرفعالسازی اعتبارسنجی و ثبت گزارش نسخه FFmpeg.
- --ffmpeg-verbose
- نوشتن خروجی stderr مربوط به FFmpeg در خروجی stderr برنامه Streamlink.
- --ffmpeg-verbose-path PATH
- نوشتن خروجی stderr مربوط به FFmpeg در PATH.
- --ffmpeg-loglevel LOGLEVEL
- تغییر
مقدار -loglevel در
FFmpeg به LOGLEVEL.
مگر در صورتی که --ffmpeg-verbose یا --ffmpeg-verbose-path تنظیم شده باشد، تغییر سطح گزارش هیچ اثری نخواهد داشت.
پیشفرض: "info".
- --ffmpeg-fout OUTFORMAT
- تنظیم قالب
خروجی به
OUTFORMAT. این
مورد فقط
برای
استریمهایی
که نیاز به muxing
دارند
اعمال
میشود.
پیشفرض: "matroska".
مثال: --ffmpeg-fout "mpegts"
- --ffmpeg-video-transcode CODEC
- تبدیل کدک
(transcode) ویدیو به
CODEC. این مورد
فقط برای
استریمهایی
که نیاز به muxing
دارند
اعمال
میشود.
پیشفرض: "copy".
مثال: --ffmpeg-video-transcode "h264"
- --ffmpeg-audio-transcode CODEC
- تبدیل کدک
(transcode) صدا به CODEC.
این مورد
فقط برای
استریمهایی
که نیاز به muxing
دارند
اعمال
میشود.
پیشفرض: "copy".
مثال: --ffmpeg-audio-transcode "aac"
- --ffmpeg-copyts
- تنظیم گزینه -copyts در FFmpeg تا برچسبهای زمانی ورودی پردازش نشوند و مقدار آفست زمان شروع اولیه حفظ شود.
- --ffmpeg-start-at-zero
- فعال کردن گزینه -start_at_zero در FFmpeg هنگام استفاده از --ffmpeg-copyts.
- --ffmpeg-validation-timeout SECONDS
- مهلت زمانی
بر حسب
ثانیه برای
اعتبارسنجی
نسخه FFmpeg.
پیشفرض: 4.0.
در صورت کند بودن شروع به کار FFmpeg در سیستمهای کمتوان، این مقدار را افزایش دهید.
گزینههای HTTP
- --http-proxy HTTP_PROXY
- یک پراکسی HTTP
برای
استفاده در
تمام
درخواستهای
HTTP و HTTPS، از
جمله
اتصالات WebSocket.
مثال: --http-proxy "http://hostname:port/"
- --http-cookie KEY=VALUE
- یک کوکی
برای
افزودن به
هر درخواست
HTTP.
برای افزودن چند کوکی میتواند تکرار شود.
- --http-cookies-file PATH
- مسیری به یک
فایل کوکی
که
دادههای
کوکی آن به
درخواستهای
HTTP افزوده
خواهد شد.
برای افزودن چند فایل کوکی میتواند تکرار شود.
قالب فایل باید از قالب فایل کوکی HTTP نتاسکیپ (MozillaCookieJar، curl و غیره) که با عنوان cookies.txt نیز شناخته میشود، پیروی کند. توجه داشته باشید که این قالب، اطلاعات مربوط به کوکیهای RFC 2965 و همچنین مشخصههای جدیدتر یا غیر استاندارد کوکی مانند port را از دست میدهد.
برخلاف --http-cookie که دادهها را با هر درخواست ارسال میکند، این گزینه با رعایت دامنه، مسیر و سایر مشخصههای کوکی، امکان کنترل دقیقتری را فراهم میسازد.
- --http-header KEY=VALUE
- یک هدر برای
افزودن به
هر درخواست
HTTP.
برای افزودن چند هدر میتواند تکرار شود.
- --http-query-param KEY=VALUE
- یک پارامتر
کوئری برای
افزودن به
هر درخواست
HTTP.
برای افزودن چند پارامتر کوئری میتواند تکرار شود.
- --http-ignore-env
- نادیده گرفتن تنظیمات HTTP تعیینشده در محیط، مانند متغیرهای محیطی (HTTP_PROXY و غیره) یا احراز هویت ~/.netrc.
- --http-no-ssl-verify
- عدم تلاش
برای
اعتبارسنجی
گواهیهای
TLS/SSL.
با احتیاط استفاده شود، زیرا پیامدهای امنیتی مربوط به TLS/SSL دارد.
- --http-disable-dh
- غیرفعال
کردن تبادل
کلید Diffie Hellman.
با احتیاط استفاده شود، زیرا پیامدهای امنیتی مربوط به TLS/SSL دارد.
- --http-ssl-cert PEM_FILENAME
- گواهی SSL مورد استفاده: یک فایل .pem.
- --http-ssl-cert-crt-key CRT_FILENAME KEY_FILENAME
- گواهی SSL مورد استفاده: یک فایل .crt و یک فایل .key.
- --http-timeout TIMEOUT
- تنظیم
مقدار مهلت
زمانی
عمومی مورد
استفاده
توسط تمامی
درخواستهای
HTTP به جز
مواردی که
با
گزینههای
دیگر پوشش
داده
شدهاند.
پیشفرض: 20.0.
- --webbrowser {yes,true,1,on,no,false,0,off}
- فعال یا
غیرفعال
کردن
پشتیبانی
از API مرورگر
وب در Streamlink.
رابط برنامهنویسی (API) مرورگر وب در Streamlink به پلاگینهایی که آن را پیادهسازی کردهاند اجازه میدهد تا یک مرورگر وب را راهاندازی کرده و دادهها را از وبسایتهایی استخراج کنند که در حالت عادی بهدلیل محدودیتهای خاص JavaScript، امکان دریافت آنها از طریق نشست معمول HTTP در Python وجود ندارد.
مرورگر وب بهصورت ایزوله و در محیطی تمیز، بدون دسترسی به دادههای عادی کاربر اجرا میشود.
در حال حاضر Streamlink تنها از مرورگرهای وب مبتنی بر Chromium با استفاده از پروتکل Chrome Devtools Protocol (CDP) پشتیبانی میکند. این شامل خود Chromium، Google Chrome، Microsoft Edge، Brave، Vivaldi و سایر موارد میشود، اما پشتیبانی کامل از فورکهای متفرقهٔ Chromium تضمین نمیشود. در صورت بروز هرگونه مشکل، لطفاً با Chromium یا Google Chrome امتحان کنید.
پیشفرض: true.
- --webbrowser-executable PATH
- مسیر فایل
اجرایی
مرورگر وب.
بهطور پیشفرض، این مسیر بهصورت خودکار بر اساس قواعد پیادهسازیِ webbrowser API استفادهشده جستجو میشود. این فرایند معمولاً شامل فهرستی از نامهای اجرایی شناختهشده و مسیرهای جایگزین در تمام سیستمعاملهای پشتیبانیشده است.
- --webbrowser-timeout TIME
- حداکثر زمانی که مرورگر وب میتواند برای راهاندازی و اجرا صرف کند.
- --webbrowser-cdp-host HOST
- میزبان (Host)
برای رابط
ارتباط
بینپردازشی
مرورگر وب
(مختص CDP).
پیشفرض: 127.0.0.1.
- --webbrowser-cdp-port PORT
- پورت برای
رابط
ارتباط
بینپردازشی
مرورگر وب
(مختص CDP).
بهطور پیشفرض تلاش میکند یک پورت آزاد پیدا کند.
- --webbrowser-cdp-timeout TIME
- حداکثر زمان انتظار برای دریافت پاسخ یک دستور واحد در CDP.
- --webbrowser-headless {yes,true,1,on,no,false,0,off}
- تعیین
اینکه
مرورگر وب
در حالت
بدون سر (headless)
اجرا شود یا
خیر. در
صورت فعال
بودن،
مرورگر
کاملاً
پنهان
میماند و
برای اجرا
نیازی به
محیط
گرافیکی
(دسکتاپ)
ندارد.
لطفاً توجه داشته باشید که ممکن است حالت headless توسط وبسایتهایی که از سیستمهای تشخیص ربات استفاده میکنند مسدود شود.
پیشفرض: false.
گزینههای مختص پلاگین (Plugin-specific options)
Bbciplayer
- --bbciplayer-username USERNAME
- نام کاربری مورد استفاده برای ثبتنام در bbc.co.uk.
- --bbciplayer-password PASSWORD
- گذرواژه حساب bbc.co.uk جهت استفاده به همراه --bbciplayer-username.
- --bbciplayer-hd
- ترجیح دادن استریمهای HD نسبت به استریمهای محلی SD؛ ممکن است برخی از برنامههای زنده با کیفیت HD پخش نشوند.
Clubbingtv
- --clubbingtv-username
- نام کاربری مورد استفاده برای ثبتنام در Clubbing TV.
- --clubbingtv-password
- گذرواژه حساب Clubbing TV جهت استفاده به همراه --clubbingtv-username.
Kick
- --kick-low-latency
- فعالسازی
پخش با
تأخیر کم از
طریق واکشی
پیشاپیش (prefetching)
بخشهای HLS.
در صورت
بالاتر
بودن،
مقدار --hls-segment-stream-data
را به true و --hls-live-edge
را به 2
تغییر
میدهد.
کاهش دادن
مقدار --hls-live-edge
به 1 به
کمترین
میزان
تأخیر ممکن
منجر
میشود،
اما به
احتمال
بسیار زیاد
باعث ایجاد
بافرینگ
خواهد شد.
برای دستیابی به پخش واقعی با تأخیر کم، لازم است تنظیمات کش/بافرینگ پخشکننده تنظیم شده و تا جای ممکن به کمترین مقدار کاهش یابد، اما همچنان باید به اندازهای باشد که باعث بافر شدن نشود. این موضوع به نرخ بیت (bitrate) استریم و کیفیت اتصال به سرورهای Kick بستگی دارد. لطفاً برای پیکربندی لازم به مستندات خود پخشکننده مراجعه کنید. پارامترهای پخشکننده را میتوان از طریق --player-args تنظیم کرد.
نکته:
Nicolive
- --niconico-email EMAIL
- ایمیل یا شماره تلفن مرتبط با حساب Niconico شما.
- --niconico-password PASSWORD
- گذرواژه حساب Niconico شما.
- --niconico-user-session VALUE
- مقدار توکن
نشست کاربر
(user-session).
میتواند بهعنوان جایگزینی برای ارائه گذرواژه استفاده شود.
- --niconico-purge-credentials
- پاکسازی اعتبارنامههای ذخیرهشدهٔ Niconico جهت شروع یک نشست جدید و احراز هویت مجدد.
- --niconico-timeshift-offset [[XX:]XX:]XX | [XXh][XXm][XXs]
- میزان
زمانی که
باید از
ابتدای
استریم
نادیده
گرفته شده و
رد شود.
پیشفرض: 0.
- --openrectv-email EMAIL
- ایمیل مرتبط با حساب کاربری openrectv شما؛ برای دسترسی به هر پخش زنده openrectv مورد نیاز است.
- --openrectv-password PASSWORD
- گذرواژه حساب کاربری openrectv برای استفاده با --openrectv-email.
Pixiv
- --pixiv-sessionid SESSIONID
- شناسه نشست (sessionid) در pixiv.net که در کوکی PHPSESSID متعلق به pixiv استفاده میشود.
- --pixiv-devicetoken DEVICETOKEN
- توکن دستگاه (device token) در pixiv.net که در کوکی device_token متعلق به pixiv استفاده میشود.
- --pixiv-purge-credentials
- پاکسازی اعتبارنامههای کششدهی Pixiv برای آغاز یک نشست جدید و احراز هویت مجدد.
- --pixiv-performer USER
- انتخاب پخش میزبان مشترک (co-host) بهجای پخش مالک اصلی.
Raiplay
- --raiplay-email EMAIL
- ایمیل استفادهشده برای ثبتنام در raiplay.it.
- --raiplay-password PASSWORD
- گذرواژه حساب کاربری raiplay.it برای استفاده با --raiplay-email.
- --raiplay-purge-credentials
- پاکسازی اعتبارنامههای کششدهی RaiPlay برای آغاز یک نشست جدید و احراز هویت مجدد.
Soop
- --soop-username USERNAME
- نام کاربری استفادهشده برای ثبتنام در sooplive.com.
- --soop-password PASSWORD
- گذرواژه حساب کاربری sooplive.com برای استفاده با --soop-username.
- --soop-purge-credentials
- پاکسازی اعتبارنامههای کششدهی Soop برای آغاز یک نشست جدید و احراز هویت مجدد.
- --soop-stream-password STREAM_PASSWORD
- گذرواژه پخش زنده.
Steam
- --steam-email EMAIL
- آدرس ایمیل حساب Steam برای دسترسی به پخشهای خصوصی یا دوستان (friends/private).
- --steam-password PASSWORD
- گذرواژه حساب Steam برای استفاده با --steam-email.
Streann
- --streann-url URL
- نشانی URL مبدأ که iframe در آن قرار دارد؛ فقط برای URLهای مستقیم مربوط به ott.streann.com مورد نیاز است.
Tf1
- --tf1-email EMAIL
- آدرس ایمیل استفادهشده برای ثبتنام در tf1.fr.
- --tf1-password PASSWORD
- گذرواژه حساب کاربری tf1.fr برای استفاده با --tf1-email.
- --tf1-purge-credentials
- پاکسازی اعتبارنامههای کششدهی tf1.fr برای آغاز یک نشست جدید و احراز هویت مجدد.
Twitcasting
- --twitcasting-password PASSWORD
- گذرواژه پخشهای خصوصی Twitcasting.
Twitch
- --twitch-low-latency
- پخش با
تاخیر کم (low latency)
را از طریق
واکشی
پیشدستانهی
قطعات HLS
فعال
میکند.
مقدار --hls-segment-stream-data
را روی true و
اگر --hls-live-edge
بیشتر از ۲
باشد، آن را
روی 2 تنظیم
میکند.
کاهش --hls-live-edge به
1 کمترین
تاخیر ممکن
را در پی
خواهد
داشت، اما
به احتمال
زیاد موجب
ایجاد
بافرینگ
میشود.
بهمنظور دستیابی به پخش واقعی با تاخیر کم در هنگام پخش، تنظیمات کش/بافرینگ پخشکننده (player) باید تنظیم شده و تا جای ممکن به کمترین مقدار کاهش یابد، اما همچنان آنقدر باشد که مانع از ایجاد بافرینگ شود. این موضوع به نرخ بیت (bitrate) پخش و کیفیت اتصال به سرورهای Twitch بستگی دارد. لطفاً برای پیکربندی لازم به مستندات اختصاصی پخشکننده مراجعه کنید. پارامترهای پخشکننده را میتوان از طریق --player-args مشخص کرد.
نکته:
- --twitch-supported-codecs CODECS
- فهرستی
جداشده با
کاما از
نامهای
کدک که
اولویت کدک
پخشِ
کلاینت را
به Twitch اعلام
میکند.
اینکه کدام
پخشها و
کدام
کدکها در
دسترس
هستند، به
کانال و پخش
مربوطه
بستگی دارد.
پیشفرض: "h264" است.
کدکهای پشتیبانیشده عبارتند از h264، h265 و av1. برای فعالسازی همه کدکها، روی "h264,h265,av1" تنظیم کنید.
پخشهای با کیفیت بالاتر ممکن است تنها با فعالسازی h265 یا av1 در دسترس باشند. پخشهای با کیفیت پایینتر که در سمت Twitch مجدداً کدگذاری میشوند، ممکن است حتی در صورت عدم درخواست همچنان h264 باشند.
- --twitch-api-header KEY=VALUE
- یک سربرگ
برای
افزودن به
هر درخواست
HTTP در Twitch API.
برای افزودن چندین سربرگ میتواند تکرار شود.
برای افزودن دادههای احراز هویت که میتوانند از نمایش تبلیغات جلوگیری کنند مفید است. برای اطلاعات بیشتر به مستندات اختصاصی افزونه مراجعه کنید.
- --twitch-access-token-param KEY=VALUE
- یک پارامتر
برای
افزودن به
درخواست API
جهت دریافت
توکن
دسترسی پخش
(streaming access token).
برای افزودن چندین پارامتر میتواند تکرار شود.
- --twitch-force-client-integrity
- بدون وجود توکن client-integrity، تلاشی برای درخواست توکن دسترسی پخش انجام نشود.
- --twitch-purge-client-integrity
- پاکسازی توکن client-integrity کششدهی Twitch و دریافت یک توکن جدید.
- --ustream-password PASSWORD
- گذرواژهای برای دسترسی به کانالهای دارای گذرواژه در UStream.tv.
Ustvnow
- --ustvnow-username USERNAME
- نام کاربری حساب USTV Now شما
- --ustvnow-password PASSWORD
- گذرواژه حساب USTV Now شما
Wwenetwork
- --wwenetwork-email EMAIL
- رایانامه متصل به حساب WWE Network شما؛ برای دسترسی به هر یک از پخشهای WWE Network الزامی است.
- --wwenetwork-password PASSWORD
- گذرواژه حساب WWE Network برای استفاده همراه با --wwenetwork-email.
Yupptv
- --yupptv-boxid BOXID
- مقدار boxid در yupptv.com که در کوکی BoxId استفاده میشود.
- --yupptv-yuppflixtoken YUPPFLIXTOKEN
- مقدار yuppflixtoken در yupptv.com که در کوکی YuppflixToken استفاده میشود.
- --yupptv-purge-credentials
- پاکسازی اعتبارنامههای کششدهی YuppTV برای آغاز یک نشست جدید و احراز هویت مجدد.
Zattoo
- --zattoo-email EMAIL
- رایانامه متصل به حساب zattoo شما؛ برای دسترسی به هر یک از پخشهای zattoo الزامی است.
- --zattoo-password PASSWORD
- گذرواژه حساب zattoo برای استفاده همراه با --zattoo-email.
- --zattoo-purge-credentials
- پاکسازی اعتبارنامههای کششدهی zattoo برای آغاز یک نشست جدید و احراز هویت مجدد.
- --zattoo-stream-types TYPES
- فهرستی از
انواع
جریانهای
پخش جداشده
با کاما که
باید
استفاده
شوند.
انواع مجاز عبارتند از: dash, hls7
پیشفرض: "dash" است.
گزارش باگها (BUGS)
لطفاً یک گزارش مشکل جدید در ردیاب اشکالات Streamlink در GitHub ایجاد کرده و از فرمهای گزارش مناسب استفاده کنید:
همچنین ببینید (SEE ALSO)
برای دریافت اطلاعات دقیقتر درباره فایلهای پیکربندی، بارگذاری جانبی پلاگینها، پروتکلهای پخش جریانی، پشتیبانی از پروکسی، متادیتا یا موارد خاص هر افزونه، لطفاً مستندات برخط CLI مربوط به Streamlink را در اینجا مشاهده کنید:
https://streamlink.github.io/cli.html
فهرست افزونههای موجود و توضیحات آنها در اینجا قابل مشاهده است:
نویسندگان (AUTHORS)
مشارکتکنندگان Streamlink
کپیرایت و تکثیر (COPYRIGHT)
2026, Streamlink
| August 1, 2026 | 8.5.0 |