pipewire(1) General Commands Manual pipewire(1)

pipewire - کارساز چندرسانه‌ای PipeWire

pipewire [گزینه‌ها]

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

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

-h | --help

نمایش راهنما.

-v | --verbose

افزایش سطح پرگویی به اندازهٔ یک واحد. این گزینه می‌تواند چندین بار مشخص شود.

--version

نمایش اطلاعات نگارش.

-c | --config=FILE

بارگذاری فایل پیکربندی مشخص‌شده (پیش‌فرض: pipewire.conf).

-P | --properties=PROPS

افزودن مشخصه‌های داده‌شده در قالب یک شیء SPA JSON به context.

یک دیمن PipeWire همچنین یک شیء فرادادهٔ (metadata) تنظیمات را ارائه می‌دهد که می‌تواند برای تغییر برخی تنظیمات در زمان اجرا به کار رود.

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

این تنظیمات می‌توانند با استفاده از pw-metadata(1) تغییر یابند:

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

log.level = INTEGER

تغییر سطح گزارش‌گیری (log level) دیمن PipeWire.

clock.rate = INTEGER

نرخ نمونه‌برداری پیش‌فرض.

clock.allowed-rates = [ RATE1 RATE2... ]

نرخ‌های نمونه‌برداری مجاز.

clock.force-rate = INTEGER

به طور موقت گراف را مجبور می‌کند با یک نرخ نمونه‌برداری ثابت کار کند. هم پردازش DSP و هم دستگاه‌ها بی‌درنگ به نرخ جدید جابه‌جا می‌شوند. جریان‌های در حال اجرا (برنامه‌های ALSA ،native و PulseAudio) به طور خودکار بازنمونه‌برداری می‌شوند تا با نرخ جدید مطابقت یابند.

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

clock.quantum = INTEGER

کوانتوم پیش‌فرض (اندازهٔ بافر).

clock.min-quantum = INTEGER

کوچک‌ترین کوانتوم مورد استفاده.

clock.max-quantum = INTEGER

بزرگ‌ترین کوانتوم مورد استفاده.

clock.force-quantum = INTEGER

به طور موقت گراف را مجبور می‌کند با یک کوانتوم ثابت کار کند.

مقدار را روی 0 تنظیم کنید تا به کوانتوم اجازه داده شود دوباره تغییر کند.

PIPEWIRE_RUNTIME_DIR

XDG_RUNTIME_DIR

USERPROFILE

برای یافتن سوکت PipeWire روی سرور (و کلاینت‌های بومی) استفاده می‌شود.

PIPEWIRE_CORE

نام سوکتی که باید ایجاد شود.

PIPEWIRE_REMOTE

نام سوکتی که باید به آن متصل شد.

PIPEWIRE_DAEMON

اگر روی true تنظیم شود، فرایند به یک سرور جدید PipeWire تبدیل می‌شود.

PIPEWIRE_CONFIG_DIR

XDG_CONFIG_HOME

HOME

برای یافتن دایرکتوری‌های فایل پیکربندی استفاده می‌شود.

PIPEWIRE_CONFIG_PREFIX

PIPEWIRE_CONFIG_NAME

برای بازنویسی پیشوند و نام پیکربندی ارائه‌شده توسط برنامه استفاده می‌شود.

PIPEWIRE_NO_CONFIG

بازنویسی پیکربندی پیش‌فرض را فعال (false) یا غیرفعال (true) می‌کند.

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

LANG

زبان فعلی در application.language.

XDG_SESSION_ID

به‌عنوان مشخصه application.process.session-id تنظیم می‌شود.

DISPLAY

به‌عنوان مشخصه window.x11.display تنظیم می‌شود.

PIPEWIRE_MODULE_DIR

دایرکتوری محل یافتن ماژول‌های PipeWire را تعیین می‌کند.

SPA_SUPPORT_LIB

نام کتابخانهٔ پشتیبان SPA برای بارگذاری. از این متغیر می‌توان برای جابه‌جایی به یک کتابخانهٔ پشتیبان جایگزین استفاده کرد، برای مثال، جهت اجرا روی هستهٔ بی‌درنگ EVL.

JOURNAL_STREAM

برای تجزیهٔ جریانی که برای journal به کار می‌رود، استفاده می‌شود. این متغیر معمولاً توسط systemd پیکربندی می‌شود.

PIPEWIRE_LOG_LINE

ثبت شماره خطوط در لاگ را فعال می‌کند. پیش‌فرض true است.

PIPEWIRE_LOG_TIMESTAMP

نوع برچسب زمانی لاگ‌گیری: "local" ،"monotonic" ،"realtime" ،"none". پیش‌فرض "local" است.

PIPEWIRE_LOG

یک فایل لاگ را برای استفاده به‌جای لاگر پیش‌فرض مشخص می‌کند.

PIPEWIRE_LOG_SYSTEMD

استفاده از systemd را برای لاگر فعال می‌کند، پیش‌فرض true است.

PIPEWIRE_CPU

پردازنده (CPU) و پرچم‌ها را انتخاب می‌کند. این یک ماسک بیتی از هر یک از پرچم‌های CPU است

PIPEWIRE_VM

ماشین مجازی‌ای را که PipeWire روی آن در حال اجرا است انتخاب می‌کند. این می‌تواند هر یک از انواع VM باشد.

DISABLE_RTKIT

استفاده از RTKit یا Realtime Portal را برای زمان‌بندی بی‌درنگ غیرفعال می‌کند.

NO_COLOR

استفاده از رنگ‌ها را در خروجی کنسول غیرفعال می‌کند.

PIPEWIRE_DLCLOSE

استفاده از dlclose را زمانی که یک کتابخانهٔ مشترک دیگر مورد استفاده قرار نمی‌گیرد، فعال (true) یا غیرفعال (false) می‌کند. هنگام اشکال‌زدایی، ممکن است غیرفعال کردن dlclose برای به‌دست آوردن نمادهای اشکال‌زدایی از شیء منطقی باشد.

PIPEWIRE_NODE

جریان را وادار می‌کند تا به یک object.serial یا node.name خاص متصل شود.

PIPEWIRE_PROPS

ویژگی‌های اضافی را به یک جریان یا پالایه اضافه می‌کند.

PIPEWIRE_QUANTUM

نرخ (rate) و buffer-size مشخصی را برای جریان یا پالایه اجبار می‌کند.

PIPEWIRE_LATENCY

یک تاخیر (latency) مشخص را برای جریان یا پالایه تعیین می‌کند. این صرفاً یک پیشنهاد است، اما تاخیر پیکربندی‌شده از آن بزرگ‌تر نخواهد بود.

PIPEWIRE_RATE

یک نرخ را برای جریان یا پالایه تعیین می‌کند. این صرفاً یک پیشنهاد است. نرخ زمانی تغییر داده خواهد شد که گراف بی‌کار (idle) باشد.

PIPEWIRE_AUTOCONNECT

تنظیمات پیش‌فرض اتصال خودکار (autoconnect) جریان را بازنویسی می‌کند.

SPA_PLUGIN_DIR

برای یافتن مکان افزونه‌های SPA استفاده می‌شود.

SPA_DATA_DIR

برای یافتن مکان فایل‌های پیکربندی ویژهٔ افزونه‌ها استفاده می‌شود. این متغیر در حال حاضر توسط افزونهٔ bluetooth برای مکان‌یابی پایگاه‌دادهٔ quirks به‌کار می‌رود.

SPA_DEBUG

سطح گزارش‌گیری (log level) را برای افزونه‌های SPA تنظیم می‌کند. این مورد معمولاً هنگام مدیریت افزونه‌ها توسط PipeWire، با متغیر PIPEWIRE_DEBUG کنترل می‌شود، اما برخی از ابزارهای مستقل (مانند spa-inspect) از این متغیر استفاده می‌کنند.

ACP_BUILDDIR

در صورت تنظیم، پروفایل‌های ACP از builddir بارگیری می‌شوند.

ACP_PATHS_DIR

ACP_PROFILES_DIR

به‌ترتیب برای یافتن مکان مسیرها و دایرکتوری‌های پروفایل ACP استفاده می‌شوند.

LADSPA_PATH

فهرستی از دایرکتوری‌ها که با کاما از هم جدا شده‌اند و افزونه‌های ladspa در آن‌ها یافت می‌شوند.

LIBJACK_PATH

دایرکتوری‌ای که فایل libjack.so متعلق به jack1 یا jack2 می‌تواند در آن یافت شود.

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

pw-top(1), pw-dump(1), pw-mon(1), pw-cat(1), pw-cli(1), libpipewire-modules(7)

1.6.8 PipeWire