نام (NAME)

pipewire-client.conf - فایل پیکربندی کلاینت PipeWire

خلاصه دستور (SYNOPSIS)

/pipewire/client.conf

/etc/pipewire/client.conf

/usr/share/pipewire/client.conf

/usr/share/pipewire/client.conf.d/

/etc/pipewire/client.conf.d/

/pipewire/client.conf.d/

توضیحات (DESCRIPTION)

پیکربندی برای کلاینت‌های بومی PipeWire و برای پلاگین ALSA مربوط به PipeWire.

یک برنامه کلاینت بومی PipeWire پیکربندی پیش‌فرض را برای بارگذاری انتخاب می‌کند، و اگر چیزی مشخص نشده باشد، معمولاً client.conf را بارگذاری می‌نماید.

قالب فایل پیکربندی و منطق جستجوی آن همانند pipewire.conf(5) است.

فایل‌های پیکربندی قطره‌ای (drop-in) به صورت client.conf.d/*.conf قابل استفاده بوده و توصیه می‌شوند. به pipewire.conf(5) مراجعه کنید.

بخش‌های فایل پیکربندی (CONFIGURATION FILE SECTIONS)

stream.properties

stream.rules

alsa.properties

alsa.rules

علاوه بر این، بخش‌های پیکربندی زمینه (context) در PipeWire نیز ممکن است مشخص شوند، به pipewire.conf(5) مراجعه کنید.

ویژگی‌های جریان (STREAM PROPERTIES)

فایل‌های پیکربندی کلاینت شامل یک بخش stream.properties هستند که گزینه‌های جریان‌های کلاینت را پیکربندی می‌کند:

# ~/.config/pipewire/client.conf.d/custom.conf
stream.properties = {
    #node.latency = 1024/48000
    #node.autoconnect = true
    #resample.disable = false
    #resample.quality = 4
    #resample.window = exp # blackman kaiser
    #resample.cutoff = 0.0
    #resample.n-taps = 0
    #resample.param.exp.A = 0.0
    #resample.param.blackman.alpha = 0.0
    #resample.param.kaiser.alpha = 0.0
    #resample.param.kaiser.stopband-attenuation = 0.0
    #resample.param.kaiser.transition-bandwidth = 0.0
    #monitor.channel-volumes = false
    #channelmix.disable = false
    #channelmix.min-volume = 0.0
    #channelmix.max-volume = 10.0
    #channelmix.normalize = false
    #channelmix.lock-volume = false
    #channelmix.mix-lfe = true
    #channelmix.upmix = true
    #channelmix.upmix-method = psd  # none, simple
    #channelmix.lfe-cutoff = 150.0
    #channelmix.fc-cutoff  = 12000.0
    #channelmix.rear-delay = 12.0
    #channelmix.stereo-widen = 0.0
    #channelmix.hilbert-taps = 0
    #dither.noise = 0
    #dither.method = none # rectangular, triangular, triangular-hf, wannamaker3, shaped5
    #debug.wav-path = 
}

برخی از ویژگی‌ها به جنبه‌های مختلف جریان اشاره دارند:

• ویژگی‌های عمومی جریان برای شناسایی جریان.
• ویژگی‌های عمومی جریان برای دسته‌بندی جریان.
• نحوه زمان‌بندی آن توسط گراف پردازش.
• نحوه پیوند آن توسط مدیر نشست (session manager).
• نحوه انجام پردازش داخلی.
• ویژگی‌هایی برای پیکربندی قالب رسانه.

فهرستی از ویژگی‌های شیء که می‌توان بر جریان‌ها اعمال کرد در pipewire-props(7) Common Node Properties و pipewire-props(7) Audio Adapter Properties یافت می‌شود.

قواعد جریان (STREAM RULES)

می‌توانید قواعد تطبیق (به pipewire(1) مراجعه کنید) را برای تنظیم ویژگی‌های جریان‌ها و فیلترهای مشخص اضافه کنید.

بخش‌های stream.rules و filter.rules یک کنش update-props فراهم می‌کنند که یک شیء حاوی ویژگی‌ها دریافت کرده و آن‌ها را روی شیء گره (node) جریان و فیلتر به‌روزرسانی می‌کند.

یک بخش stream.rules یا filter.rules را به این صورت در فایل پیکربندی اضافه کنید:

# ~/.config/pipewire/client.conf.d/custom.conf
stream.rules = [
    {
        matches = [
            {
                # all keys must match the value. ! negates. ~ starts regex.
                application.process.binary = "firefox"
            }
        ]
        actions = {
            update-props = {
                node.name = "My Name"
            }
        }
    }
]

این پیکربندی node.name مربوط به Firefox را روی "My Name" تنظیم می‌کند.

ویژگی‌های کلاینت ALSA (ALSA CLIENT PROPERTIES)

یک بخش alsa.properties می‌تواند برای پیکربندی برنامه‌های کلاینت که از طریق پلاگین ALSA مربوط به PipeWire متصل می‌شوند اضافه شود.

# ~/.config/pipewire/client.conf.d/custom.conf
alsa.properties = {
    #alsa.deny = false
    #alsa.format = 0
    #alsa.rate = 0
    #alsa.channels = 0
    #alsa.period-bytes = 0
    #alsa.buffer-bytes = 0
    #alsa.volume-method = cubic         # linear, cubic
}

alsa.deny

alsa.format

alsa.rate

alsa.channels

alsa.period-bytes

alsa.buffer-bytes

alsa.volume-method = cubic | linear

قواعد کلاینت ALSA (ALSA CLIENT RULES)

امکان تنظیم ویژگی‌های خاص کلاینت ALSA با استفاده از قواعد تطبیق (به pipewire(1) مراجعه کنید) وجود دارد. می‌توانید هر یک از ویژگی‌های ALSA بالا یا هر یک از stream.properties را تنظیم کنید.

# ~/.config/pipewire/client.conf.d/custom.conf
alsa.rules = [
    {   matches = [ { application.process.binary = "resolve" } ]
        actions = {
            update-props = {
                alsa.buffer-bytes = 131072
            }
        }
    }
]

متغیرهای محیطی (ENVIRONMENT VARIABLES)

برای متغیرهای محیطی متداول به pipewire(1) مراجعه کنید. بسیاری از آن‌ها برای برنامه‌های کلاینت نیز اعمال می‌شوند.

متغیرهای محیطی همچنین بر برنامه‌های ALSA که از پلاگین ALSA مربوط به PipeWire استفاده می‌کنند تأثیر می‌گذارند.

PIPEWIRE_ALSA

PIPEWIRE_ALSA='{ alsa.buffer-bytes=16384 node.name=foo }' aplay ...

PIPEWIRE_NODE

PIPEWIRE_NODE=alsa_output.pci-0000_00_1b.0.analog-stereo aplay ...

نویسندگان (AUTHORS)

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

همچنین ببینید (SEE ALSO)

libpipewire-module-protocol-pulse(7), pipewire.conf(5), pipewire-pulse(1), pipewire-pulse-modules(7)