.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "WIREPLUMBER" "1" "Sep 03, 2026" "0.5.17" "WirePlumber"
.SH "نام (NAME)"
wireplumber \- مدیر نشست PipeWire
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBwireplumber\fP [\fB\-c\fP|\fB\-\-config\-file\fP=\fIFILE\fP]
[\fB\-p\fP|\fB\-\-profile\fP=\fIPROFILE\fP] [\fB\-v\fP|\fB\-\-version\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
\fBwireplumber\fP دیمن WirePlumber است، یک مدیر نشست و خط‌مشی پیمانه‌ای
برای PipeWire. این برنامه به خودی خود کاری انجام نمی‌دهد مگر بارگذاری مؤلفه‌های فهرست‌شده در
پروفایل انتخاب‌شده؛ تمام منطق مدیریتی واقعی — راه‌اندازی دستگاه‌ها،
پیوند دادن جریان‌ها، اعطای مجوزها به کلاینت‌ها — در همان
مؤلفه‌ها پیاده‌سازی شده است.
.sp
این برنامه معمولاً به جای اجرای دستی، به صورت یک سرویس کاربری systemd اجرا می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ systemctl \-\-user status wireplumber
.EE
.UNINDENT
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
\fB\-c\fP, \fB\-\-config\-file\fP=\fIFILE\fP
استفاده از \fIFILE\fP به عنوان فایل پیکربندی اصلی به جای \fBwireplumber.conf\fP\&.
پوشه قطعات پیکربندی مربوطه یعنی \fBFILE.d/\fP نیز بارگذاری می‌شود.
.TP
\fB\-p\fP, \fB\-\-profile\fP=\fIPROFILE\fP
بارگذاری \fIPROFILE\fP به جای پروفایل پیش‌فرض \fBmain\fP. به این ترتیب نمونه دوم
تنها با بخشی از قابلیت‌ها راه‌اندازی می‌شود؛ بخش
«اجرای چندین نمونه» را در \%<#\:daemon-multi-instance>\& ببینید.
.TP
\fB\-v\fP, \fB\-\-version\fP
چاپ نسخه برنامه و خروج.
.UNINDENT
.SH "محیط (ENVIRONMENT)"
.INDENT 0.0
.TP
\fBWIREPLUMBER_DEBUG\fP
سطح گزارش‌گیری و سطوح گزارش‌گیری بر پایه موضوع را تعیین می‌کند. بخش «گزارش‌گیری اشکال‌زدایی» را در \%<#\:daemon-logging>\& ببینید.
.TP
\fBWIREPLUMBER_CONFIG_DIR\fP
پوشه‌ای را که در ابتدا برای یافتن فایل‌های پیکربندی جستجو می‌شود، لغو و جایگزین می‌کند.
.TP
\fBWIREPLUMBER_DATA_DIR\fP
پوشه‌ای را که در ابتدا برای یافتن فایل‌های داده، مانند اسکریپت‌ها، جستجو می‌شود، لغو و جایگزین می‌کند.
.TP
\fBWIREPLUMBER_MODULE_DIR\fP
پوشه‌ای را که در ابتدا برای یافتن ماژول‌ها جستجو می‌شود، لغو و جایگزین می‌کند.
.UNINDENT
.sp
بخش «محل‌های فایل‌های WirePlumber» را در \%<#\:daemon-file-locations> برای ترتیب کامل جستجوی هر یک از این موارد ببینید.
.SH "فایل‌ها (FILES)"
.sp
فایل‌های پیکربندی در پوشه‌های زیر جستجو می‌شوند که در اینجا
از بالاترین به پایین‌ترین اولویت فهرست شده‌اند:
.INDENT 0.0
.TP
.B \fI$XDG_CONFIG_HOME\fP\fB/wireplumber/\fP
پیکربندی کاربر؛ \fB~/.config/wireplumber/\fP مگر آن‌که \fI$XDG_CONFIG_HOME\fP
تنظیم شده باشد.
.TP
.B \fI$XDG_CONFIG_DIRS\fP\fB/wireplumber/\fP
پیکربندی مختص میزبان؛ \fB/etc/xdg/wireplumber/\fP مگر آن‌که
\fI$XDG_CONFIG_DIRS\fP تنظیم شده باشد.
.TP
.B \fB/etc/wireplumber/\fP
پیکربندی مختص میزبان، در \fI$sysconfdir\fP زمان کامپایل.
.TP
.B \fI$XDG_DATA_DIRS\fP\fB/wireplumber/\fP
پیکربندی ارائه‌شده توسط توزیع؛ \fB/usr/local/share/wireplumber/\fP و
\fB/usr/share/wireplumber/\fP مگر آن‌که \fI$XDG_DATA_DIRS\fP تنظیم شده باشد.
.TP
.B \fB/usr/share/wireplumber/\fP
پیکربندی عرضه‌شده به همراه WirePlumber، در \fI$datadir\fP زمان کامپایل.
.UNINDENT
.sp
در هر یک از این پوشه‌ها، \fBwireplumber.conf\fP فایل پیکربندی اصلی
و \fBwireplumber.conf.d/*.conf\fP قطعاتی هستند که در آن ادغام می‌شوند.
تنها نخستین \fBwireplumber.conf\fP یافت‌شده بارگذاری می‌شود، اما قطعات از
\fIتمام\fP پوشه‌ها به ترتیب معکوس اولویت بارگذاری می‌شوند، به‌طوری که یک
قطعه در پوشه با اولویت بالاتر، موارد پایین‌تر از خود را جایگزین می‌کند.
.sp
اسکریپت‌ها و سایر فایل‌های داده در زیرپوشه \fBscripts\fP از
پوشه‌های زیر جستجو می‌شوند، مجدداً از بالاترین به پایین‌ترین اولویت:
.INDENT 0.0
.TP
.B \fI$XDG_DATA_HOME\fP\fB/wireplumber/\fP
اسکریپت‌های ارائه‌شده توسط کاربر؛ \fB~/.local/share/wireplumber/\fP مگر آن‌که
\fI$XDG_DATA_HOME\fP تنظیم شده باشد.
.TP
.B \fI$XDG_DATA_DIRS\fP\fB/wireplumber/\fP
اسکریپت‌های مختص میزبان؛ \fB/usr/local/share/wireplumber/\fP و
\fB/usr/share/wireplumber/\fP مگر آن‌که \fI$XDG_DATA_DIRS\fP تنظیم شده باشد.
.TP
.B \fB/usr/share/wireplumber/\fP
اسکریپت‌های عرضه‌شده به همراه WirePlumber، در \fI$datadir\fP زمان کامپایل.
.UNINDENT
.sp
سایر مکان‌ها بدون ترتیب خاصی جستجو می‌شوند:
.INDENT 0.0
.TP
.B \fB/usr/lib/wireplumber\-0.5/\fP
ماژول‌های WirePlumber، در \fI$libdir\fP زمان کامپایل. در سیستم‌های چندمعماری (multiarch)
این مسیر \fB/usr/lib/\fP\fI<arch\-triplet>\fP\fB/wireplumber\-0.5/\fP است. ماژول‌های PipeWire و SPA
در عوض از پوشه‌های ماژول خود PipeWire بارگذاری می‌شوند.
.TP
.B \fI$XDG_STATE_HOME\fP\fB/wireplumber/\fP
وضعیت ذخیره‌شده: گره‌های پیش‌فرض، پروفایل‌ها و مسیرهای دستگاه، ویژگی‌های جریان و
تنظیماتی که در زمان اجرا تغییر کرده‌اند. این مسیر
\fB~/.local/state/wireplumber/\fP است مگر آن‌که \fI$XDG_STATE_HOME\fP تنظیم شده باشد.
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
کدهای خروج از قراردادهای \fBsysexits.h\fP(3head) پیروی می‌کنند:
.INDENT 0.0
.TP
\fB0\fP (\fIEX_OK\fP)
موفقیت‌آمیز.
.TP
\fB64\fP (\fIEX_USAGE\fP)
خطای نحوه استفاده در خط فرمان.
.TP
\fB69\fP (\fIEX_UNAVAILABLE\fP)
یک سرویس مورد نیاز در دسترس نبود؛ معمولاً WirePlumber نتوانسته است به
PipeWire متصل شود.
.TP
\fB70\fP (\fIEX_SOFTWARE\fP)
خطای داخلی نرم‌افزار.
.TP
\fB78\fP (\fIEX_CONFIG\fP)
خطای پیکربندی.
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBwpctl\fP(1), \fBwpexec\fP(1), \fBpipewire\fP(1), \fBpw\-cli\fP(1),
\fBpw\-dump\fP(1), \fBsysexits.h\fP(3head)
.sp
مستندات WirePlumber: \%<https://\:pipewire\:.pages\:.freedesktop\:.org/\:wireplumber>
.SH "نویسنده (AUTHOR)"
توسعه‌دهندگان WirePlumber
.SH "حق نشر (COPYRIGHT)"
2020-2025, Collabora & contributors
.\" End of generated man page.