.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH JACKTRIP "1" "September 2026" "JackTrip VERSION: 3.0.1" "دستورهای کاربری"
.SH "نام (NAME)"
JackTrip \- سامانه‌ای با کیفیت بالا برای اجرای صوتی تحت شبکه
.SH "خلاصه دستور (SYNOPSIS)"
.B jacktrip
[\fI\,-s|-c|-S|-C hostIPAddressOrURL\/\fR] [\fI\,گزینه‌ها\/\fR]
.SH "توضیحات (DESCRIPTION)"
JackTrip: سامانه‌ای برای اجرای صوتی باکیفیت در بستر شبکه
روی اینترنت
حق نشر \(co 2008\-2022 Juan\-Pablo Caceres, Chris Chafe.
گروه SoundWIRE در CCRMA، دانشگاه Stanford
این ساخت از JackTrip مشمول مجوز LGPL است.
کد منبع JackTrip تحت مجوزهای MIT و GPL منتشر شده است.
برای اطلاعات بیشتر، فایل LICENSE.md را ببینید.
نسخه: 3.0.1
.SH "گزینه‌ها (OPTIONS)"
.SS "آرگومان‌های الزامی: یکی از موارد زیر:"
.TP
\fB\-s\fR, \fB\-\-server\fR
اجرا در حالت سرور P2P
.TP
\fB\-c\fR, \fB\-\-client\fR <peer_hostname_or_IP_num>
اجرا در حالت کلاینت P2P
.TP
\fB\-S\fR, \fB\-\-jacktripserver\fR
اجرا در حالت سرور Hub
.TP
\fB\-C\fR, \fB\-\-pingtoserver\fR <peer_name_or_IP>
اجرا در حالت کلاینت Hub
.SS "آرگومان‌های اختیاری:"
.TP
\fB\-n\fR, \fB\-\-numchannels\fR #
تعداد کانال‌های ورودی و خروجی (# بزرگ‌تر از 0، پیش‌فرض: 2)
.TP
\fB\-\-receivechannels\fR #
تعداد کانال‌های دریافتی از شبکه (# بزرگ‌تر از 0)
.TP
\fB\-\-sendchannels\fR #
تعداد کانال‌های ارسالی به شبکه (# بزرگ‌تر از 0)
.TP
\fB\-q\fR, \fB\-\-queue\fR # (2 یا بیشتر)
طول بافر صف، بر حسب اندازه بسته (پیش‌فرض: 4)
.TP
\fB\-r\fR, \fB\-\-redundancy\fR # (1 یا بیشتر)
افزونگی بسته برای جلوگیری از افت کیفیت صوتی ناشی از گم شدن بسته‌ها (پیش‌فرض: 1)
.TP
\fB\-o\fR, \fB\-\-portoffset\fR #
آفست پورت اتصال (bind) دریافتی و پورت همتا از مقدار پیش‌فرض 4464
.TP
\fB\-B\fR, \fB\-\-bindport\fR #
تنها تنظیم شماره پورت اتصال (bind) (پیش‌فرض: 4464)
.TP
\fB\-P\fR, \fB\-\-peerport\fR #
تنها تنظیم شماره پورت همتا (پیش‌فرض: 4464)
.TP
\fB\-U\fR, \fB\-\-udpbaseport\fR
تنها تنظیم شماره پورت پایه udp سرور (پیش‌فرض: 61002)
.TP
\fB\-b\fR, \fB\-\-bitres\fR # (8, 16, 24, 32)
تفکیک‌پذیری عمق بیتی صدا (پیش‌فرض: 16، مقدار 32 از ممیز شناور استفاده می‌کند)
.TP
\fB\-z\fR, \fB\-\-zerounderrun\fR
تنظیم بافر روی صفر هنگام وقوع underrun (پیش‌فرض: wavetable)
.TP
\fB\-t\fR, \fB\-\-timeout\fR
خروج پس از 10 ثانیه عدم فعالیت شبکه
.TP
\fB\-l\fR, \fB\-\-loopback\fR
اجرا در حالت Loop\-Back
.TP
\fB\-j\fR, \fB\-\-jamlink\fR
اجرا در حالت JamLink (اتصال به JamLink Box)
.TP
\fB\-J\fR, \fB\-\-clientname\fR
تغییر نام پیش‌فرض کلاینت (پیش‌فرض: JackTrip)
.TP
\fB\-K\fR, \fB\-\-remotename\fR
تغییر نام پیش‌فرض کلاینت دوردست هنگام اتصال به یک سرور hub (پیش‌فرض از نشانی IP خارجی این رایانه مشتق می‌شود)
.TP
\fB\-\-appendthreadid\fR
الصاق شناسه ریسه (thread ID) به نام‌های کلاینت
.TP
\fB\-L\fR, \fB\-\-localaddress\fR
تغییر نشانی IP میزبان محلی پیش‌فرض (پیش‌فرض: 127.0.0.1)
.TP
\fB\-D\fR, \fB\-\-nojackportsconnect\fR
عدم اتصال خودکار پورت‌های صوتی پیش‌فرض در jack
.TP
\fB\-\-bufstrategy\fR # (0, 1, 2, 3, 4)
استفاده از بافر جیتر (jitter buffer) جایگزین
.TP
\fB\-\-broadcast\fR <broadcast_queue>
تکثیر پورت‌های دریافتی با طول مشخص‌شده برای broadcast_queue. خروجی‌های پخشی (Broadcast) تأخیر بالاتر اما اتلاف بسته کمتری دارند.
.TP
\fB\-\-udprt\fR
استفاده از اولویت ریسه بلادرنگ (RT) برای ورودی/خروجی شبکه
.SS "گزینه‌های اتصالات صوتی در حالت سرور HUB:"
.TP
\fB\-p\fR, \fB\-\-hubpatch\fR # (0, 1, 2, 3, 4, 5)
اتصال صوتی خودکار Hub، تنها در صورت اجرای حالت سرور HUB اثر دارد، 0=سرور به کلاینت‌ها، 1=لوپ‌بک کلاینت، 2=پخش ورودی/خروجی کلاینت بدون لوپ‌بک، 3=رزرو شده برای TUB، 4=میکس کامل، 5=بدون اتصال خودکار (پیش‌فرض: 0)
.TP
\fB\-i\fR, \fB\-\-includeserver\fR
گنجاندن صدای ورودی و خروجی سرور در میکس هنگام اتصال. تنها بر حالت‌های اتصال \fB\-p\fR 2 (پخش ورودی/خروجی کلاینت بدون لوپ‌بک) و \fB\-p\fR 4 (میکس کامل) اثر می‌گذارد.
.TP
\fB\-u\fR, \fB\-\-upmix\fR
تبدیل صوتی کلاینت‌های مونو به استریو (upmix) هنگام اتصال
.SS "پردازش سیگنال اختیاری:"
.TP
\fB\-f\fR, \fB\-\-effects\fR # | paramString | help
فعال کردن کمپرسور و/یا ریورب ورودی و/یا خروجی در کلاینت \- برای جزئیات `\-f help` را ببینید
.TP
\fB\-O\fR, \fB\-\-overflowlimiting\fR i|o[w]|io[w]|n|help
استفاده از محدودکننده(های) صوتی در کلاینت، i=ورودی از شبکه، o=خروجی به شبکه، io=هر دو، n=بدون محدودکننده، w=هشدار هنگام محدودسازی (پیش‌فرض=n). برای اطلاعات بیشتر دستور \fB\-O\fR help را وارد کنید.
.TP
\fB\-a\fR, \fB\-\-assumednumclients\fR help|# (1,2,..)
تعداد کلاینت‌های (منابع) فرضی که در سرور Hub میکس می‌شوند (در غیر این صورت مقدار 2 توسط \fB\-O\fR فرض می‌شود)
.TP
\fB\-T\fR, \fB\-\-srate\fR #
تنظیم نرخ نمونه‌برداری، تنها روی برخی از بک‌اندهای صوتی کار می‌کند (پیش‌فرض: 48000)
.TP
\fB\-F\fR, \fB\-\-bufsize\fR #
تنظیم اندازه بافر، تنها روی برخی از بک‌اندهای صوتی کار می‌کند (پیش‌فرض: 128)
.SS "آرگومان‌های استفاده از JACKTRIP بدون JACK:"
.TP
\fB\-R\fR, \fB\-\-rtaudio\fR
استفاده از سامانه صوتی پیش‌فرض سیستم به جای Jack
.HP
\fB\-\-audiodevice\fR "input\-output device name"
.HP
\fB\-\-audiodevice\fR "input device name","output device name"
.HP
\fB\-\-audioinputdevice\fR "input device name"
.TP
\fB\-\-audiooutputdevice\fR "output device name"
تنظیم دستگاه صوتی مورد استفاده؛ در صورت عدم تنظیم، از دستگاه پیش‌فرض استفاده خواهد شد
.TP
\fB\-\-listdevices\fR
فهرست کردن دستگاه‌های صوتی موجود
.TP
\fB\-d\fR, \fB\-\-deviceid\fR #
تنظیم شناسه دستگاه rtaudio (منسوخ شده، به جای آن از \fB\-\-audiodevice\fR استفاده کنید)
.SS "آرگومان‌های نمایش آمار ورودی/خروجی:"
.TP
\fB\-I\fR, \fB\-\-iostat\fR <time_in_secs>
فعال‌سازی گزارش آمار ورودی/خروجی با فاصله زمانی مشخص‌شده (به ثانیه)
.TP
\fB\-G\fR, \fB\-\-iostatlog\fR <log_file>
ذخیره گزارش آمار در یک فایل (پیش‌فرض: چاپ در خروجی استاندارد stdout)
.TP
\fB\-x\fR, \fB\-\-examine\-audio\-delay\fR <print_interval_in_secs> | help
چاپ آمار تأخیر صوتی رفت و برگشت (round\-trip). برای جزئیات `\-x help` را ببینید.
.SS "آرگومان‌های شبیه‌سازی مشکلات شبکه:"
.TP
\fB\-\-simloss\fR <rate>
شبیه‌سازی اتلاف بسته (packet loss)
.TP
\fB\-\-simjitter\fR <rate>,<d>
شبیه‌سازی جیتر (jitter)، مقدار d بیشینه تأخیر بر حسب بسته است
.SS "آرگومان‌های احراز هویت سرور/کلاینت HUB:"
.TP
\fB\-A\fR, \fB\-\-auth\fR
استفاده از احراز هویت در سمت کلاینت، یا اجباری کردن آن در سمت سرور
.TP
\fB\-\-certfile\fR
فایل گواهی برای استفاده در سرور hub
.TP
\fB\-\-keyfile\fR
فایل کلید خصوصی برای استفاده در سرور hub
.TP
\fB\-\-credsfile\fR
فایل حاوی نام‌های کاربری و گذرواژه‌های ذخیره‌شده
.TP
\fB\-\-username\fR
نام کاربری برای استفاده هنگام اتصال به عنوان کلاینت hub (اگر اینجا مشخص نشود، از ورودی استاندارد خوانده می‌شود)
.TP
\fB\-\-password\fR
گذرواژه برای استفاده هنگام اتصال به عنوان کلاینت hub (اگر اینجا مشخص نشود، از ورودی استاندارد خوانده می‌شود)
.TP
\fB\-\-iceservers\fR
فهرست جداشده با کاما از سرورهای ICE برای عبور از NAT در WebRTC (مانند "stun:stun.l.google.com:19302")
.SS "آرگومان‌های رابط کاربری گرافیکی (GUI):"
.TP
\fB\-\-gui\fR
اجبار JackTrip به اجرا با رابط کاربری گرافیکی (GUI). در صورت عدم استفاده از حالت VirtualStudio، سوئیچ‌های خط فرمان در بخش‌های آرگومان‌های الزامی، آرگومان‌های اختیاری (به جز \fB\-l\fR، \fB\-j\fR، \fB\-L\fR و \fB\-\-appendthreadid\fR)، اتصالات صوتی و احراز هویت اعمال خواهند شد و در مواردی که آرگومان‌ها مشخص نشده باشند از تنظیمات پیش‌فرض استفاده می‌شود. گزینه‌های بخش‌های دیگر نادیده گرفته خواهند شد (و آخرین تنظیمات استفاده‌شده بارگیری می‌شوند)، به جز \fB\-V\fR و سوئیچ‌های \fB\-\-version\fR و \fB\-\-help\fR که این موارد را لغو و بازنویسی می‌کنند.
.TP
\fB\-\-classic\-gui\fR
اجبار JackTrip به اجرا با رابط گرافیکی حالت کلاسیک (Classic Mode GUI).
.TP
\fB\-\-deeplink\fR
مدیریت یک نشانی اینترنتی پیوند عمیق (deeplink URL) با قالب jacktrip://join/<studio_id> از طریق اتصال به عنوان کلاینت hub
.TP
\fB\-\-logtofile\fR
نوشتن پیام‌های گزارش در فایل log.txt در دایرکتوری داده‌های برنامه نیز انجام شود. به طور پیش‌فرض غیرفعال است؛ پیام‌های گزارش همواره در کنسول نوشته می‌شوند.
.SS "آرگومان‌های راهنما:"
.TP
\fB\-v\fR, \fB\-\-version\fR
چاپ شماره نسخه
.TP
\fB\-V\fR, \fB\-\-verbose\fR
حالت پرگو، چاپ پیام‌های اشکال‌زدایی
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ این راهنما
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
حق نشر \(co 2008\-2022 Juan\-Pablo Caceres, Chris Chafe.
گروه SoundWIRE در CCRMA، دانشگاه Stanford
این ساخت از JackTrip مشمول مجوز LGPL است.
کد منبع JackTrip تحت مجوزهای MIT و GPL منتشر شده است.
برای اطلاعات بیشتر، فایل LICENSE.md را ببینید.