.\" 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 "WPCTL" "1" "Sep 03, 2026" "0.5.17" "WirePlumber" .SH "نام (NAME)" wpctl \- رابط خط فرمانی کنترل WirePlumber .SH "خلاصه دستور (SYNOPSIS)" .sp \fBwpctl\fP [\fICOMMAND\fP] [\fICOMMAND_OPTIONS\fP] .SH "توضیحات (DESCRIPTION)" .sp \fBwpctl\fP یک ابزار کنترلی خط فرمانی برای WirePlumber، مدیر نشست PipeWire است. این ابزار رابطی را برای بررسی، کنترل و پیکربندی دستگاه‌های صوتی و تصویری، گره‌ها (nodes) و ویژگی‌های آن‌ها در سرور رسانه PipeWire فراهم می‌کند. .sp ‏WirePlumber وظیفهٔ مدیریت مسیریابی صدا و تصویر، پیکربندی دستگاه‌ها و سیاست‌های نشست را بر عهده دارد. \fBwpctl\fP به کاربران اجازه می‌دهد با این مؤلفه‌ها تعامل داشته باشند، بلندی صدا را تغییر دهند، دستگاه‌های پیش‌فرض را تعیین کنند، ویژگی‌های اشیاء را بررسی نمایند و تنظیمات را تغییر دهند. .SH "دستورات (COMMANDS)" .SS status .sp \fBwpctl status\fP [\fB\-k\fP|\fB\-\-nick\fP] [\fB\-n\fP|\fB\-\-name\fP] .sp وضعیت فعلی اشیاء را در PipeWire، از جمله دستگاه‌ها، سینک‌ها (sinks)، منابع (sources)، فیلترها و جریان‌ها (streams) نمایش می‌دهد. همچنین یک نمای سلسله‌مراتبی از سامانهٔ صوتی/تصویری ارائه می‌دهد. .INDENT 0.0 .TP .B گزینه‌ها: .INDENT 7.0 .TP \fB\-k\fP, \fB\-\-nick\fP نمایش نام مستعار (nickname) دستگاه و گره به جای توضیحات .TP \fB\-n\fP, \fB\-\-name\fP نمایش نام دستگاه و گره به جای توضیحات .UNINDENT .UNINDENT .SS list .sp \fBwpctl list\fP [\fBaudio\fP|\fBvideo\fP] [\fBdevices\fP|\fBsinks\fP|\fBsources\fP] .sp فهرستی ماشین‌خوان از اشیاء PipeWire را نمایش می‌دهد که می‌توان آن را به صورت اختیاری بر اساس نوع رسانه و نوع شیء فیلتر کرد. هر خط از خروجی شامل فیلدهای جداشده با تب است: شناسه شیء (ID)، نام، نوع رسانه/نوع شیء، و در صورتی که گره پیش‌فرض فعلی باشد، یک علامت \fB*\fP. .INDENT 0.0 .TP .B آرگومان‌ها: .INDENT 7.0 .TP \fBaudio\fP|\fBvideo\fP (اختیاری) فیلتر کردن بر اساس نوع رسانه .TP \fBdevices\fP|\fBsinks\fP|\fBsources\fP (اختیاری) فیلتر کردن بر اساس نوع شیء (ابتدا نیازمند تعیین نوع رسانه است) .UNINDENT .UNINDENT.SS get\-volume .sp \fBwpctl get\-volume\fP \fIID\fP .sp اطلاعات بلندی صدای گره مشخص‌شده، شامل سطح کنونی بلندی صدا و وضعیت بی‌صدا بودن (mute) را نمایش می‌دهد. .INDENT 0.0 .TP .B آرگومان‌ها: .INDENT 7.0 .TP .B \fIID\fP شناسه گره (Node ID) یا شناسه ویژه (بخش «شناسه‌های ویژه» (SPECIAL IDENTIFIERS) را ببینید) .UNINDENT .UNINDENT .SS inspect .sp \fBwpctl inspect\fP \fIID\fP [\fB\-r\fP|\fB\-\-referenced\fP] [\fB\-a\fP|\fB\-\-associated\fP] .sp اطلاعات تفصیلی درباره شیء مشخص‌شده، از جمله تمامی ویژگی‌ها و فراداده‌ها را نمایش می‌دهد. .INDENT 0.0 .TP .B آرگومان‌ها: .INDENT 7.0 .TP .B \fIID\fP شناسه شیء یا شناسه ویژه .UNINDENT .TP .B گزینه‌ها: .INDENT 7.0 .TP \fB\-r\fP, \fB\-\-referenced\fP نمایش اشیایی که در ویژگی‌ها به آن‌ها ارجاع داده شده است .TP \fB\-a\fP, \fB\-\-associated\fP نمایش اشیاء مرتبط .UNINDENT .UNINDENT .SS set\-default .sp \fBwpctl set\-default\fP \fIID\fP .sp گره دستگاه مشخص‌شده را به عنوان مقصد پیش‌فرض از نوع خود (ضبط یا بازپخش) برای جریان‌های جدیدی که به اتصال خودکار نیاز دارند، تنظیم می‌کند. .sp این انتخاب پس از راه‌اندازی‌های مجدد، در فایل وضعیت \fBdefault\-nodes\fP \%<#\:state-locations> به خاطر سپرده می‌شود و نسبت به انتخاب خودکار و مبتنی بر اولویتی که در غیر این صورت WirePlumber انجام می‌داد، ارجحیت دارد. برای لغو آن از \fBclear\-default\fP استفاده کنید. .INDENT 0.0 .TP .B آرگومان‌ها: .INDENT 7.0 .TP .B \fIID\fP شناسه گره sink یا source .UNINDENT .UNINDENT .SS set\-volume .sp \fBwpctl set\-volume\fP \fIID\fP \fIVOL\fP[\fB%\fP][\fB\-\fP|\fB+\fP] [\fB\-p\fP|\fB\-\-pid\fP] [\fB\-l\fP \fILIMIT\fP|\fB\-\-limit\fP \fILIMIT\fP] .sp بلندی صدای گره مشخص‌شده را تنظیم می‌کند. .INDENT 0.0 .TP .B آرگومان‌ها: .INDENT 7.0 .TP .B \fIID\fP شناسه گره، شناسه ویژه، یا PID (همراه با \-\-pid) .TP \fIVOL\fP[\fB%\fP][\fB\-\fP|\fB+\fP] مشخصه بلندی صدا: .INDENT 7.0 .IP \(bu 2 \fIVOL\fP \- تنظیم بلندی صدا روی یک مقدار مشخص (1.0 = 100%) .IP \(bu 2 \fIVOL\fP\fB%\fP \- تنظیم بلندی صدا بر حسب درصد (50% = 0.5) .IP \(bu 2 \fIVOL\fP\fB+\fP \- افزایش بلندی صدا به مقدار مشخص .IP \(bu 2 \fIVOL\fP\fB\-\fP \- کاهش بلندی صدا به مقدار مشخص .IP \(bu 2 \fIVOL\fP\fB%+\fP \- افزایش بلندی صدا بر حسب درصد .IP \(bu 2 \fIVOL\fP\fB%\-\fP \- کاهش بلندی صدا بر حسب درصد .UNINDENT .UNINDENT .TP .B گزینه‌ها: .INDENT 7.0 .TP \fB\-p\fP, \fB\-\-pid\fP در نظر گرفتن ID به عنوان شناسه فرایند (PID) و اعمال تغییرات روی تمام گره‌های مرتبط با آن .TP \fB\-l\fP \fILIMIT\fP, \fB\-\-limit\fP \fILIMIT\fP محدود کردن بلندی نهایی صدا به مقداری کمتر از این مقدار (عدد ممیز شناور، 1.0 = 100%) .UNINDENT .TP .B مثال‌ها: تنظیم بلندی صدا روی 50%: \fBwpctl set\-volume @DEFAULT_SINK@ 0.5\fP .sp افزایش بلندی صدا به اندازه 10%: \fBwpctl set\-volume 42 10%+\fP .sp تنظیم بلندی صدا برای تمام گره‌های PID 1234: \fBwpctl set\-volume \-\-pid 1234 0.8\fP .UNINDENT.SS set\-mute .sp \fBwpctl set\-mute\fP \fIID\fP \fB1\fP|\fB0\fP|\fBtoggle\fP [\fB\-p\fP|\fB\-\-pid\fP] .sp وضعیت بی‌صدا بودن گره مشخص‌شده را تغییر می‌دهد. .INDENT 0.0 .TP .B آرگومان‌ها: .INDENT 7.0 .TP .B \fIID\fP شناسهٔ گره (Node ID)، شناسهٔ ویژه، یا PID (همراه با \-\-pid) .TP \fB1\fP|\fB0\fP|\fBtoggle\fP وضعیت بی‌صدا: 1 (بی‌صدا)، 0 (باصدا)، یا تعویض (toggle) وضعیت فعلی .UNINDENT .TP .B گزینه‌ها: .INDENT 7.0 .TP \fB\-p\fP, \fB\-\-pid\fP در نظر گرفتن ID به عنوان شناسهٔ فرایند و اعمال تغییرات روی تمام گره‌های مرتبط با آن .UNINDENT .UNINDENT .SS set\-profile .sp \fBwpctl set\-profile\fP \fIID\fP \fIINDEX\fP .sp پروفایل دستگاه مشخص‌شده را روی نمایهٔ داده‌شده تنظیم می‌کند. .INDENT 0.0 .TP .B آرگومان‌ها: .INDENT 7.0 .TP .B \fIID\fP شناسهٔ دستگاه یا شناسهٔ ویژه .TP .B \fIINDEX\fP نمایهٔ پروفایل (عدد صحیح، 0 معمولاً به معنای \(aqoff\(aq است) .UNINDENT .UNINDENT .SS set\-route .sp \fBwpctl set\-route\fP \fIID\fP \fIINDEX\fP .sp مسیر (route) دستگاه مشخص‌شده را روی نمایهٔ داده‌شده تنظیم می‌کند. .INDENT 0.0 .TP .B آرگومان‌ها: .INDENT 7.0 .TP .B \fIID\fP شناسهٔ گره دستگاه یا شناسهٔ ویژه .TP .B \fIINDEX\fP نمایهٔ مسیر (عدد صحیح، 0 معمولاً به معنای \(aqoff\(aq است) .UNINDENT .UNINDENT .SS clear\-default .sp \fBwpctl clear\-default\fP [\fIID\fP] .sp گره پیش‌فرض پیکربندی‌شده را پاک می‌کند. اگر هیچ شناسه‌ای مشخص نشود، تمام گره‌های پیش‌فرض را پاک می‌کند. .sp این کار انتخاب‌های فعلی و تمام انتخاب‌های قبلی \fBset\-default\fP از آن نوع را فراموش می‌کند تا WirePlumber به انتخاب خودکار گره پیش‌فرض بر اساس ویژگی \fBpriority.session\fP هر گره بازگردد. این دستور زمانی لازم است که اولویت پیکربندی‌شده بی‌اثر به نظر می‌رسد، چرا که انتخاب‌های ذخیره‌شده بر هر اولویتی ارجحیت دارند. انتخاب‌های ذخیره‌شده در بخش \(dqDefault Configured Devices\(dq از خروجی \fBstatus\fP فهرست شده‌اند. .INDENT 0.0 .TP .B آرگومان‌ها: .INDENT 7.0 .TP .B \fIID\fP (اختیاری) شناسهٔ تنظیمات برای پاک‌سازی (0\-2 برای Audio/Sink، Audio/Source، Video/Source). در صورت حذف، تمام پیش‌فرض‌ها را پاک می‌کند. .UNINDENT .UNINDENT.SS settings .sp \fBwpctl settings\fP [\fIKEY\fP] [\fIVAL\fP] [\fB\-d\fP|\fB\-\-delete\fP] [\fB\-s\fP|\fB\-\-save\fP] [\fB\-r\fP|\fB\-\-reset\fP] .sp تنظیمات WirePlumber را نمایش می‌دهد، تغییر می‌دهد، یا حذف می‌کند. .INDENT 0.0 .TP .B آرگومان‌ها: .INDENT 7.0 .TP .B \fIKEY\fP (اختیاری) نام کلید تنظیمات .TP .B \fIVAL\fP (اختیاری) مقدار تنظیمات (در قالب JSON) .UNINDENT .TP .B گزینه‌ها: .INDENT 7.0 .TP \fB\-d\fP, \fB\-\-delete\fP حذف مقدار ذخیره‌شدهٔ تنظیمات (مشخص نکردن KEY به معنی حذف همه است) .TP \fB\-s\fP, \fB\-\-save\fP ذخیرهٔ مقدار تنظیمات (مشخص نکردن KEY به معنی ذخیرهٔ همه، و مشخص نکردن VAL به معنی ذخیرهٔ مقدار فعلی است) .TP \fB\-r\fP, \fB\-\-reset\fP بازنشانی تنظیمات به مقدار پیش‌فرض آن .UNINDENT .TP .B رفتار: .INDENT 7.0 .IP \(bu 2 بدون آرگومان: نمایش تمام تنظیمات .IP \(bu 2 فقط KEY: نمایش مقدار تنظیمات مشخص‌شده .IP \(bu 2 هم KEY و هم VAL: تعیین مقدار تنظیمات مشخص‌شده .UNINDENT .UNINDENT .SS set\-log\-level .sp \fBwpctl set\-log\-level\fP [\fIID\fP] \fILEVEL\fP .sp سطح لاگ (گزارش‌گیری) یک کلاینت را تنظیم می‌کند. .INDENT 0.0 .TP .B آرگومان‌ها: .INDENT 7.0 .TP .B \fIID\fP (اختیاری) شناسهٔ کلاینت. در صورت عدم ذکر، روی WirePlumber اعمال می‌شود. برای سرور PipeWire از 0 استفاده کنید. .TP .B \fILEVEL\fP سطح لاگ (مانند \fB0\fP، \fB1\fP، \fB2\fP، \fB3\fP، \fB4\fP، \fB5\fP، \fBE\fP، \fBW\fP، \fBN\fP، \fBI\fP، \fBD\fP، \fBT\fP). برای لغو تنظیم سطح لاگ از \fB\-\fP استفاده کنید. .UNINDENT .UNINDENT .SS reset .sp \fBwpctl reset\fP [\fB\-c\fP|\fB\-\-wireplumber\-config\fP] [\fB\-p\fP|\fB\-\-pipewire\-config\fP] [\fB\-a\fP|\fB\-\-all\fP] [\fB\-n\fP|\fB\-\-no\-restart\fP] [\fB\-d\fP|\fB\-\-dry\-run\fP] [\fB\-y\fP|\fB\-\-yes\fP] .sp با حذف فایل‌های وضعیت و پیکربندی، WirePlumber (و در صورت تمایل PipeWire) را به مقادیر پیش‌فرض بازنشانی می‌کند. به‌طور پیش‌فرض، تنها دایرکتوری وضعیت WirePlumber (\fB~/.local/state/wireplumber\fP) حذف می‌شود. WirePlumber به‌طور خودکار پیش از حذف متوقف شده و پس از آن مجدداً راه‌اندازی می‌شود، مگر اینکه \fB\-\-no\-restart\fP داده شده باشد. قبل از حذف هر فایلی یک اعلان تأیید نمایش داده می‌شود، مگر اینکه گزینهٔ \fB\-\-yes\fP داده شده باشد. .sp این دستور نیازی به نشست فعال PipeWire ندارد. .INDENT 0.0 .TP .B گزینه‌ها: .INDENT 7.0 .TP \fB\-c\fP, \fB\-\-wireplumber\-config\fP فایل‌های پیکربندی کاربر WirePlumber (\fB~/.config/wireplumber\fP) را نیز حذف می‌کند .TP \fB\-p\fP, \fB\-\-pipewire\-config\fP فایل‌های پیکربندی کاربر PipeWire (\fB~/.config/pipewire\fP) را نیز حذف کرده و سرویس PipeWire را مجدداً راه‌اندازی می‌کند .TP \fB\-a\fP, \fB\-\-all\fP تمام فایل‌های وضعیت و پیکربندی را حذف می‌کند (معادل ترکیب \fB\-c\fP و \fB\-p\fP) .TP \fB\-n\fP, \fB\-\-no\-restart\fP پس از حذف فایل‌ها، سرویس‌ها را متوقف یا راه‌اندازی مجدد نمی‌کند .TP \fB\-d\fP, \fB\-\-dry\-run\fP بدون حذف واقعی چیزی یا راه‌اندازی مجدد سرویس‌ها، نشان می‌دهد چه فایل‌هایی حذف خواهند شد .TP \fB\-y\fP, \fB\-\-yes\fP بدون درخواست تأیید، عملیات را ادامه می‌دهد .UNINDENT .UNINDENT.SH "شناسه‌های ویژه (SPECIAL IDENTIFIERS)" .sp دستور \fBwpctl\fP به جای شناسه‌های عددی، این شناسه‌های ویژه را برای مقادیر پیش‌فرض پرکاربرد می‌پذیرد: .INDENT 0.0 .TP \fB@DEFAULT_SINK@\fP، \fB@DEFAULT_AUDIO_SINK@\fP سینک صوتی پیش‌فرض فعلی (دستگاه پخش) .TP \fB@DEFAULT_SOURCE@\fP، \fB@DEFAULT_AUDIO_SOURCE@\fP منبع صوتی پیش‌فرض فعلی (دستگاه ضبط) .TP \fB@DEFAULT_VIDEO_SOURCE@\fP منبع ویدیویی پیش‌فرض فعلی (دوربین) .UNINDENT .sp این شناسه‌ها در زمان اجرا به شناسه‌های گره مربوطه تبدیل می‌شوند. .SH "وضعیت خروج (EXIT STATUS)" .sp \fBwpctl\fP کدهای خروج زیر را بازمی‌گرداند: .INDENT 0.0 .TP .B 0 موفقیت .TP .B 1 خطای عمومی (مانند آرگومان‌های نامعتبر، خطای اتصال) .TP .B 2 عدم امکان اتصال به PipeWire .TP .B 3 خطای مختص به دستور (مانند پیدا نشدن شیء) .UNINDENT .SH "مثال‌ها (EXAMPLES)" .sp نمایش وضعیت سیستم: .INDENT 0.0 .INDENT 3.5 .sp .EX wpctl status .EE .UNINDENT .UNINDENT .sp تنظیم سینک صوتی پیش‌فرض: .INDENT 0.0 .INDENT 3.5 .sp .EX wpctl set\-default 42 .EE .UNINDENT .UNINDENT .sp تنظیم بلندی صدا روی 75% در سینک پیش‌فرض: .INDENT 0.0 .INDENT 3.5 .sp .EX wpctl set\-volume @DEFAULT_SINK@ 75% .EE .UNINDENT .UNINDENT .sp افزایش بلندی صدا به میزان 5% در یک گره مشخص: .INDENT 0.0 .INDENT 3.5 .sp .EX wpctl set\-volume 42 5%+ .EE .UNINDENT .UNINDENT .sp بی‌صدا کردن منبع پیش‌فرض: .INDENT 0.0 .INDENT 3.5 .sp .EX wpctl set\-mute @DEFAULT_SOURCE@ 1 .EE .UNINDENT .UNINDENT .sp تغییر وضعیت بی‌صدا در سینک پیش‌فرض: .INDENT 0.0 .INDENT 3.5 .sp .EX wpctl set\-mute @DEFAULT_SINK@ toggle .EE .UNINDENT .UNINDENT .sp بررسی یک دستگاه به همراه اشیای مرتبط: .INDENT 0.0 .INDENT 3.5 .sp .EX wpctl inspect \-\-associated 30 .EE .UNINDENT .UNINDENT .sp نمایش تمام تنظیمات WirePlumber: .INDENT 0.0 .INDENT 3.5 .sp .EX wpctl settings .EE .UNINDENT .UNINDENT .sp اعمال یک تنظیم مشخص: .INDENT 0.0 .INDENT 3.5 .sp .EX wpctl settings bluetooth.autoswitch true .EE .UNINDENT .UNINDENT .sp ذخیرهٔ تمام تنظیمات فعلی: .INDENT 0.0 .INDENT 3.5 .sp .EX wpctl settings \-\-save .EE .UNINDENT .UNINDENT .sp تنظیم سطح لاگ WirePlumber روی debug: .INDENT 0.0 .INDENT 3.5 .sp .EX wpctl set\-log\-level D .EE .UNINDENT .UNINDENT .sp تنظیم سطح لاگ برای یک کلاینت مشخص: .INDENT 0.0 .INDENT 3.5 .sp .EX wpctl set\-log\-level 42 W .EE .UNINDENT .UNINDENT .sp فهرست کردن تمام سینک‌های صوتی: .INDENT 0.0 .INDENT 3.5 .sp .EX wpctl list audio sinks .EE .UNINDENT .UNINDENT .sp بازنشانی وضعیت WirePlumber (اجرای آزمایشی): .INDENT 0.0 .INDENT 3.5 .sp .EX wpctl reset \-\-dry\-run .EE .UNINDENT .UNINDENT .sp بازنشانی وضعیت و پیکربندی WirePlumber بدون درخواست تأیید: .INDENT 0.0 .INDENT 3.5 .sp .EX wpctl reset \-\-wireplumber\-config \-\-yes .EE .UNINDENT .UNINDENT.sp بازنشانی همه‌چیز (وضعیت و پیکربندی WirePlumber و PipeWire): .INDENT 0.0 .INDENT 3.5 .sp .EX wpctl reset \-\-all .EE .UNINDENT .UNINDENT .SH "نکات (NOTES)" .sp شناسه‌های اشیاء را می‌توان با استفاده از دستور \fBstatus\fP پیدا کرد. نمایش سلسله‌مراتبی، شناسه‌ها را برای دستگاه‌ها، گره‌ها و سایر اشیاء نشان می‌دهد. .sp مقادیر بلندی صدا، اعدادی با ممیز شناور هستند که در آن‌ها 1.0 بیانگر ۱۰۰٪ بلندی صدا است. این مقادیر می‌توانند برای اعمال تقویت صدا (amplification) از 1.0 فراتر روند. .sp هنگام استفاده از گزینهٔ \fB\-\-pid\fP، دستور \fBwpctl\fP تمام گره‌های صوتی مرتبط با شناسهٔ فرایند مشخص‌شده را پیدا کرده و عملیات را روی همهٔ آن‌ها اعمال می‌کند. .SH "همچنین ببینید (SEE ALSO)" .sp \fBwireplumber\fP(1), \fBwpexec\fP(1), \fBpipewire\fP(1), \fBpw\-cli\fP(1), \fBpw\-dump\fP(1) .sp مستندات WirePlumber: \% .SH "نویسندگان (AUTHORS)" توسعه‌دهندگان WirePlumber .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 2020-2025, Collabora & contributors .\" End of generated man page.