.TH "pipewire" 1 "1.6.8" "PipeWire" \" -*- nroff -*-
.ad l
.nh
.SH "نام (NAME)"
pipewire \- کارساز چندرسانه‌ای PipeWire

.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP

.PP
\fBpipewire\fP [\fIگزینه‌ها\fP]

.PP
.SH "توضیحات (DESCRIPTION)"
.PP

.PP
‏PipeWire سرویسی است که اشتراک‌گذاری محتوای چندرسانه‌ای را میان دستگاه‌ها و برنامه‌ها تسهیل می‌کند\&.

.PP
دیمن \fBpipewire\fP یک فایل پیکربندی را می‌خواند که در صفحهٔ راهنمای \fBpipewire\&.conf(5)\fP بیشتر مستند شده است\&.

.PP
.SH "گزینه‌ها (OPTIONS)"
.PP

.PP
\fB-h | --help\fP
.RS 4
نمایش راهنما\&.
.RE
.PP
\fB-v | --verbose\fP
.RS 4
افزایش سطح پرگویی به اندازهٔ یک واحد\&. این گزینه می‌تواند چندین بار مشخص شود\&.
.RE
.PP
\fB--version\fP
.RS 4
نمایش اطلاعات نگارش\&.
.RE
.PP
\fB-c | --config=FILE\fP
.RS 4
بارگذاری فایل پیکربندی مشخص‌شده (پیش‌فرض: pipewire\&.conf)\&.
.RE
.PP
\fB-P | --properties=PROPS\fP
.RS 4
افزودن مشخصه‌های داده‌شده در قالب یک شیء SPA JSON به context\&.
.RE
.PP
.SH "تنظیمات زمان اجرا (RUNTIME SETTINGS)"
.PP
یک دیمن PipeWire همچنین یک شیء فرادادهٔ (metadata) تنظیمات را ارائه می‌دهد که می‌تواند برای تغییر برخی تنظیمات در زمان اجرا به کار رود\&.

.PP
به طور معمول این تنظیمات می‌توانند هر یک از محدودیت‌های ذکرشده در گزینه‌های پیکربندی بالا، مانند مقادیر quantum و samplerate را دور بزنند\&.

.PP
این تنظیمات می‌توانند با استفاده از \fBpw-metadata(1)\fP تغییر یابند: 
.PP
.nf
pw\-metadata \-n settings                  # list settings
pw\-metadata \-n settings 0                # list server settings
pw\-metadata \-n settings 0 log\&.level 2    # modify a server setting

.fi
.PP

.PP
\fBlog\&.level = INTEGER\fP
.RS 4
تغییر سطح گزارش‌گیری (log level) دیمن PipeWire\&.
.RE
.PP
\fBclock\&.rate = INTEGER\fP
.RS 4
نرخ نمونه‌برداری پیش‌فرض\&.
.RE
.PP
\fBclock\&.allowed-rates = [ RATE1 RATE2\&.\&.\&. ]\fP
.RS 4
نرخ‌های نمونه‌برداری مجاز\&.
.RE
.PP
\fBclock\&.force-rate = INTEGER\fP
.RS 4
به طور موقت گراف را مجبور می‌کند با یک نرخ نمونه‌برداری ثابت کار کند\&. هم پردازش DSP و هم دستگاه‌ها بی‌درنگ به نرخ جدید جابه‌جا می‌شوند\&. جریان‌های در حال اجرا (برنامه‌های ALSA ،native و PulseAudio) به طور خودکار بازنمونه‌برداری می‌شوند تا با نرخ جدید مطابقت یابند\&.

.PP
مقدار را روی 0 تنظیم کنید تا به نرخ نمونه‌برداری اجازه داده شود دوباره تغییر کند\&. 
.RE
.PP

.PP
\fBclock\&.quantum = INTEGER\fP
.RS 4
کوانتوم پیش‌فرض (اندازهٔ بافر)\&.
.RE
.PP
\fBclock\&.min-quantum = INTEGER\fP
.RS 4
کوچک‌ترین کوانتوم مورد استفاده\&.
.RE
.PP
\fBclock\&.max-quantum = INTEGER\fP
.RS 4
بزرگ‌ترین کوانتوم مورد استفاده\&.
.RE
.PP
\fBclock\&.force-quantum = INTEGER\fP
.RS 4
به طور موقت گراف را مجبور می‌کند با یک کوانتوم ثابت کار کند\&.

.PP
مقدار را روی 0 تنظیم کنید تا به کوانتوم اجازه داده شود دوباره تغییر کند\&. 
.RE
.PP.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
.SS "دایرکتوری‌های سوکت"

.PP
\fBPIPEWIRE_RUNTIME_DIR \fP
.RS 4

.RE
.PP
\fBXDG_RUNTIME_DIR \fP
.RS 4

.RE
.PP
\fBUSERPROFILE \fP
.RS 4
برای یافتن سوکت PipeWire روی سرور (و کلاینت‌های بومی) استفاده می‌شود\&.
.RE
.PP
\fBPIPEWIRE_CORE \fP
.RS 4
نام سوکتی که باید ایجاد شود\&.
.RE
.PP
\fBPIPEWIRE_REMOTE \fP
.RS 4
نام سوکتی که باید به آن متصل شد\&.
.RE
.PP
\fBPIPEWIRE_DAEMON \fP
.RS 4
اگر روی true تنظیم شود، فرایند به یک سرور جدید PipeWire تبدیل می‌شود\&.
.RE
.PP
.SS "دایرکتوری‌های پیکربندی، نام فایل پیکربندی و پیشوند"

.PP
\fBPIPEWIRE_CONFIG_DIR \fP
.RS 4

.RE
.PP
\fBXDG_CONFIG_HOME \fP
.RS 4

.RE
.PP
\fBHOME \fP
.RS 4
برای یافتن دایرکتوری‌های فایل پیکربندی استفاده می‌شود\&.
.RE
.PP
\fBPIPEWIRE_CONFIG_PREFIX \fP
.RS 4

.RE
.PP
\fBPIPEWIRE_CONFIG_NAME \fP
.RS 4
برای بازنویسی پیشوند و نام پیکربندی ارائه‌شده توسط برنامه استفاده می‌شود\&.
.RE
.PP
\fBPIPEWIRE_NO_CONFIG \fP
.RS 4
بازنویسی پیکربندی پیش‌فرض را فعال (false) یا غیرفعال (true) می‌کند\&.
.RE
.PP
.SS "اطلاعات زمینه"

.PP
به‌عنوان بخشی از زمینه کلاینت، اطلاعات زیر از متغیرهای محیطی جمع‌آوری شده و در مشخصه‌های زمینه قرار می‌گیرد:

.PP
\fBLANG \fP
.RS 4
زبان فعلی در \fRapplication\&.language\fP\&.
.RE
.PP
\fBXDG_SESSION_ID \fP
.RS 4
به‌عنوان مشخصه \fRapplication\&.process\&.session-\fBid\fP\fP تنظیم می‌شود\&.
.RE
.PP
\fBDISPLAY \fP
.RS 4
به‌عنوان مشخصه \fRwindow\&.x11\&.display\fP تنظیم می‌شود\&.
.RE
.PP.SS "ماژول‌ها (Modules)"

.PP
\fBPIPEWIRE_MODULE_DIR \fP
.RS 4
دایرکتوری محل یافتن ماژول‌های PipeWire را تعیین می‌کند\&.
.RE
.PP
\fBSPA_SUPPORT_LIB \fP
.RS 4
نام کتابخانهٔ پشتیبان SPA برای بارگذاری\&. از این متغیر می‌توان برای جابه‌جایی به یک کتابخانهٔ پشتیبان جایگزین استفاده کرد، برای مثال، جهت اجرا روی هستهٔ بی‌درنگ EVL\&.
.RE
.PP
.SS "گزینه‌های ثبت لاگ (Logging options)"

.PP
\fBJOURNAL_STREAM \fP
.RS 4
برای تجزیهٔ جریانی که برای journal به کار می‌رود، استفاده می‌شود\&. این متغیر معمولاً توسط systemd پیکربندی می‌شود\&.
.RE
.PP
\fBPIPEWIRE_LOG_LINE \fP
.RS 4
ثبت شماره خطوط در لاگ را فعال می‌کند\&. پیش‌فرض true است\&.
.RE
.PP
\fBPIPEWIRE_LOG_TIMESTAMP \fP
.RS 4
نوع برچسب زمانی لاگ‌گیری: "local" ،"monotonic" ،"realtime" ،"none"\&. پیش‌فرض "local" است\&.
.RE
.PP
\fBPIPEWIRE_LOG \fP
.RS 4
یک فایل لاگ را برای استفاده به‌جای لاگر پیش‌فرض مشخص می‌کند\&.
.RE
.PP
\fBPIPEWIRE_LOG_SYSTEMD \fP
.RS 4
استفاده از systemd را برای لاگر فعال می‌کند، پیش‌فرض true است\&.
.RE
.PP
.SS "سایر تنظیمات (Other settings)"

.PP
\fBPIPEWIRE_CPU \fP
.RS 4
پردازنده (CPU) و پرچم‌ها را انتخاب می‌کند\&. این یک ماسک بیتی از هر یک از پرچم‌های \fBCPU\fP است
.RE
.PP
\fBPIPEWIRE_VM \fP
.RS 4
ماشین مجازی‌ای را که PipeWire روی آن در حال اجرا است انتخاب می‌کند\&. این می‌تواند هر یک از انواع \fBVM\fP باشد\&.
.RE
.PP
\fBDISABLE_RTKIT \fP
.RS 4
استفاده از RTKit یا Realtime Portal را برای زمان‌بندی بی‌درنگ غیرفعال می‌کند\&.
.RE
.PP
\fBNO_COLOR \fP
.RS 4
استفاده از رنگ‌ها را در خروجی کنسول غیرفعال می‌کند\&.
.RE
.PP
.SS "گزینه‌های اشکال‌زدایی (Debugging options)"

.PP
\fBPIPEWIRE_DLCLOSE \fP
.RS 4
استفاده از dlclose را زمانی که یک کتابخانهٔ مشترک دیگر مورد استفاده قرار نمی‌گیرد، فعال (true) یا غیرفعال (false) می‌کند\&. هنگام اشکال‌زدایی، ممکن است غیرفعال کردن dlclose برای به‌دست آوردن نمادهای اشکال‌زدایی از شیء منطقی باشد\&.
.RE
.PP
.SS "گزینه‌های جریان (Stream options)"

.PP
\fBPIPEWIRE_NODE \fP
.RS 4
جریان را وادار می‌کند تا به یک \fRobject\&.serial\fP یا \fRnode\&.name\fP خاص متصل شود\&.
.RE
.PP
\fBPIPEWIRE_PROPS \fP
.RS 4
ویژگی‌های اضافی را به یک جریان یا پالایه اضافه می‌کند\&.
.RE
.PP
\fBPIPEWIRE_QUANTUM \fP
.RS 4
نرخ (rate) و buffer-size مشخصی را برای جریان یا پالایه اجبار می‌کند\&.
.RE
.PP
\fBPIPEWIRE_LATENCY \fP
.RS 4
یک تاخیر (latency) مشخص را برای جریان یا پالایه تعیین می‌کند\&. این صرفاً یک پیشنهاد است، اما تاخیر پیکربندی‌شده از آن بزرگ‌تر نخواهد بود\&.
.RE
.PP
\fBPIPEWIRE_RATE \fP
.RS 4
یک نرخ را برای جریان یا پالایه تعیین می‌کند\&. این صرفاً یک پیشنهاد است\&. نرخ زمانی تغییر داده خواهد شد که گراف بی‌کار (idle) باشد\&.
.RE
.PP
\fBPIPEWIRE_AUTOCONNECT \fP
.RS 4
تنظیمات پیش‌فرض اتصال خودکار (autoconnect) جریان را بازنویسی می‌کند\&.
.RE
.PP.SS "گزینه‌های افزونه (Plugin options)"

.PP
\fBSPA_PLUGIN_DIR \fP
.RS 4
برای یافتن مکان افزونه‌های SPA استفاده می‌شود\&.
.RE
.PP
\fBSPA_DATA_DIR \fP
.RS 4
برای یافتن مکان فایل‌های پیکربندی ویژهٔ افزونه‌ها استفاده می‌شود\&. این متغیر در حال حاضر توسط افزونهٔ bluetooth برای مکان‌یابی پایگاه‌دادهٔ quirks به‌کار می‌رود\&.
.RE
.PP
\fBSPA_DEBUG \fP
.RS 4
سطح گزارش‌گیری (log level) را برای افزونه‌های SPA تنظیم می‌کند\&. این مورد معمولاً هنگام مدیریت افزونه‌ها توسط PipeWire، با متغیر \fRPIPEWIRE_DEBUG\fP کنترل می‌شود، اما برخی از ابزارهای مستقل (مانند spa-inspect) از این متغیر استفاده می‌کنند\&.
.RE
.PP
\fBACP_BUILDDIR \fP
.RS 4
در صورت تنظیم، پروفایل‌های ACP از builddir بارگیری می‌شوند\&.
.RE
.PP
\fBACP_PATHS_DIR \fP
.RS 4

.RE
.PP
\fBACP_PROFILES_DIR \fP
.RS 4
به‌ترتیب برای یافتن مکان مسیرها و دایرکتوری‌های پروفایل ACP استفاده می‌شوند\&.
.RE
.PP
\fBLADSPA_PATH \fP
.RS 4
فهرستی از دایرکتوری‌ها که با کاما از هم جدا شده‌اند و افزونه‌های ladspa در آن‌ها یافت می‌شوند\&.
.RE
.PP
\fBLIBJACK_PATH \fP
.RS 4
دایرکتوری‌ای که فایل libjack\&.so متعلق به jack1 یا jack2 می‌تواند در آن یافت شود\&.
.RE
.PP
.SH "نویسندگان (AUTHORS)"
.PP

.PP
توسعه‌دهندگان PipeWire <https://gitlab.freedesktop.org/pipewire/pipewire/issues>؛ PipeWire در <https://pipewire.org> در دسترس است

.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP

.PP
\fBpw-top(1)\fP, \fBpw-dump(1)\fP, \fBpw-mon(1)\fP, \fBpw-cat(1)\fP, \fBpw-cli(1)\fP, \fBlibpipewire-modules(7)\fP