'\" t
.\"     Title: qutebrowser
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 04/03/2026
.\"    Manual: qutebrowser manpage
.\"    Source: qutebrowser
.\"  Language: English
.\"
.TH "QUTEBROWSER" "1" "04/03/2026" "qutebrowser" "qutebrowser manpage"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
qutebrowser \- مرورگری صفحه‌کلیدمحور و شبیه به vim مبتنی بر Python و Qt\&.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBqutebrowser\fR [\fI\-OPTION\fR [\fI\&...\fR]] [\fI:COMMAND\fR [\fI\&...\fR]] [\fIURL\fR [\fI\&...\fR]]
.SH "توضیحات (DESCRIPTION)"
.sp
برنامهٔ qutebrowser یک مرورگر با تمرکز بر صفحه‌کلید و رابط کاربری گرافیکی کمینه‌گرا (مینیمال) است\&. این مرورگر بر پایهٔ Python و Qt توسعه یافته و یک نرم‌افزار آزاد تحت پروانهٔ GPL است\&.
.sp
این نرم‌افزار از مرورگرها و افزونه‌های دیگری همچون dwb و Vimperator/Pentadactyl الهام گرفته شده است\&.
.sp
توجه داشته باشید که دستورها و تنظیمات qutebrowser در این صفحهٔ راهنما توضیح داده نشده‌اند، بلکه در راهنمای تعبیه‌شده در خودِ qutebrowser قرار دارند \- برای نمایش آن از دستور «:help» استفاده کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.SS "آرگومان‌های موضعی (positional arguments)"
.PP
\fB\fI:command\fR\fR
.RS 4
دستورهایی برای اجرا هنگام راه‌اندازی\&.
.RE
.PP
\fB\fIURL\fR\fR
.RS 4
نشانی‌های وب (URL) برای باز شدن هنگام راه‌اندازی (ورودی خالی به‌عنوان جداکنندهٔ پنجره عمل می‌کند)\&.
.RE
.SS "گزینه‌ها (options)"
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش این پیام راهنما و خروج\&.
.RE
.PP
\fB\-B\fR \fIBASEDIR\fR, \fB\-\-basedir\fR \fIBASEDIR\fR
.RS 4
دایرکتوری پایه برای تمام ذخیره‌سازی‌ها\&.
.RE
.PP
\fB\-C\fR \fICONFIG\fR, \fB\-\-config\-py\fR \fICONFIG\fR
.RS 4
مسیر فایل config\&.py\&.
.RE
.PP
\fB\-V\fR, \fB\-\-version\fR
.RS 4
نمایش نسخه و خروج\&.
.RE
.PP
\fB\-s\fR \fIOPTION\fR \fIVALUE\fR, \fB\-\-set\fR \fIOPTION\fR \fIVALUE\fR
.RS 4
اعمال یک پیکربندی موقت برای این نشست (session)\&.
.RE
.PP
\fB\-r\fR \fISESSION\fR, \fB\-\-restore\fR \fISESSION\fR
.RS 4
بازیابی یک نشست نام‌گذاری‌شده\&.
.RE
.PP
\fB\-R\fR, \fB\-\-override\-restore\fR
.RS 4
عدم بازیابی نشست، حتی اگر نشستی برای بازیابی وجود داشته باشد\&.
.RE
.PP
\fB\-\-target\fR \fI{auto,tab,tab\-bg,tab\-silent,tab\-bg\-silent,window,private\-window}\fR
.RS 4
نحوهٔ باز شدن نشانی‌های وب در صورتی که یک نمونه از qutebrowser از قبل در حال اجرا باشد\&.
.RE
.PP
\fB\-\-backend\fR \fI{webkit,webengine}\fR
.RS 4
تعیین موتور زیرساخت (backend) مورد استفاده\&.
.RE
.PP
\fB\-\-qt\-wrapper\fR \fI{PyQt6,PyQt5}\fR
.RS 4
تعیین پوشش‌دهندهٔ Qt (wrapper) مورد استفاده\&. این مورد را می‌توان از طریق متغیر محیطی QUTE_QT_WRAPPER نیز تنظیم کرد\&. اگر هر دو تنظیم شده باشند، آرگومان خط فرمان اولویت خواهد داشت\&.
.RE
.PP
\fB\-\-desktop\-file\-name\fR \fIDESKTOP_FILE_NAME\fR
.RS 4
تنظیم نام پایهٔ مدخل دسکتاپ (desktop entry) برای این برنامه\&. برای تنظیم app_id تحت Wayland استفاده می‌شود\&. ببینید:
https://doc\&.qt\&.io/qt\-6/qguiapplication\&.html#desktopFileName\-prop
.RE
.PP
\fB\-\-untrusted\-args\fR
.RS 4
علامت‌گذاری تمام آرگومان‌های پس از آن به‌عنوان غیرقابل‌اعتماد، که تضمین می‌کند آن‌ها نشانی وب/عبارت‌های جستجو هستند (نه پرچم‌ها یا دستورها)\&.
.RE
.SS "آرگومان‌های اشکال‌زدایی (debug arguments)"
.PP
\fB\-l\fR \fI{critical,error,warning,info,debug,vdebug}\fR, \fB\-\-loglevel\fR \fI{critical,error,warning,info,debug,vdebug}\fR
.RS 4
بازنویسی سطح گزارش‌گیری (loglevel) پیکربندی‌شده برای کنسول\&.
.RE
.PP
\fB\-\-logfilter\fR \fILOGFILTER\fR
.RS 4
فهرستی جداشده با کاما از مواردی که باید در لاگ اشکال‌زدایی روی خروجی استاندارد (stdout) ثبت شوند\&.
.RE
.PP
\fB\-\-loglines\fR \fILOGLINES\fR
.RS 4
تعداد خطوط لاگ اشکال‌زدایی برای نگهداری در حافظهٔ رم (\-1: نامحدود)\&.
.RE
.PP
\fB\-d\fR, \fB\-\-debug\fR
.RS 4
فعال‌سازی گزینه‌های اشکال‌زدایی\&.
.RE
.PP
\fB\-\-json\-logging\fR
.RS 4
خروجی دادن خطوط گزارش در قالب JSON (یک شیء در هر خط)\&.
.RE
.PP
\fB\-\-nocolor\fR
.RS 4
غیرفعال‌سازی گزارش‌گیری رنگی\&.
.RE
.PP
\fB\-\-force\-color\fR
.RS 4
اجبار به گزارش‌گیری رنگی\&.
.RE
.PP
\fB\-\-nowindow\fR
.RS 4
عدم نمایش پنجرهٔ اصلی\&.
.RE
.PP
\fB\-T\fR, \fB\-\-temp\-basedir\fR
.RS 4
استفاده از یک دایرکتوری پایهٔ موقت\&.
.RE
.PP
\fB\-\-no\-err\-windows\fR
.RS 4
عدم نمایش هرگونه پنجرهٔ خطا (برای tests/smoke\&.py استفاده می‌شود)\&.
.RE
.PP
\fB\-\-qt\-arg\fR \fINAME\fR \fIVALUE\fR
.RS 4
ارسال یک آرگومان همراه با مقدار به Qt\&. برای مثال، برای تعیین اندازه و موقعیت پنجره می‌توانید این دستور را اجرا کنید:
\-\-qt\-arg geometry 650x555+200+300
.RE
.PP
\fB\-\-qt\-flag\fR \fIQT_FLAG\fR
.RS 4
ارسال یک آرگومان به Qt به‌عنوان پرچم (flag)\&.
.RE
.PP
\fB\-D\fR \fIDEBUG_FLAGS\fR, \fB\-\-debug\-flag\fR \fIDEBUG_FLAGS\fR
.RS 4
ارسال نام قابلیت اشکال‌زدایی جهت فعال‌سازی\&.
.RE
.SH "فایل‌ها (FILES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI~/\&.config/qutebrowser/config\&.py\fR: فایل پیکربندی\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI~/\&.config/qutebrowser/autoconfig\&.yml\fR: پیکربندی انجام‌شده از طریق رابط گرافیکی (GUI)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI~/\&.config/qutebrowser/quickmarks\fR: نشانک‌های سریع ذخیره‌شده\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI~/\&.local/share/qutebrowser/\fR: اطلاعات گوناگون وضعیت برنامه\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI~/\&.cache/qutebrowser/\fR: داده‌های موقت\&.
.RE
.sp
توجه داشته باشید که qutebrowser از مشخصات دایرکتوری پایهٔ XDG پیروی می‌کند \- اگر \fIXDG_CONFIG_HOME\fR، \fIXDG_DATA_HOME\fR یا \fIXDG_CACHE_HOME\fR در محیط سیستم تنظیم شده باشند، دایرکتوری‌های پیکربندی‌شده در آن‌ها به‌جای مقادیر پیش‌فرض فوق استفاده خواهند شد\&.
.SH "گزارش باگ‌ها (BUGS)"
.sp
باگ‌ها در سیستم ردیابی اشکالات GitHub در نشانی https://github\&.com/qutebrowser/qutebrowser/issues پیگیری می‌شوند\&.
.sp
اگر باگی پیدا کردید، از دستور داخلی \fI:report\fR برای ایجاد یک گزارش باگ حاوی تمام اطلاعات لازم استفاده کنید\&.
.sp
در صورت تمایل، می‌توانید به‌جای آن به فهرست پستی qutebrowser@lists\&.qutebrowser\&.org بنویسید\&.
.sp
برای گزارش باگ‌های امنیتی، لطفاً با security@qutebrowser\&.org تماس بگیرید (یا در صورت نیاز به رمزگذاری GPG، با شناسهٔ GPG معادل 0x916EB0C8FD55A072 به me@the\-compiler\&.org پیام دهید)\&.
.sp
همچنین می‌توانید یک آسیب‌پذیری را از طریق قابلیت گزارش خصوصی GitHub ارسال نمایید\&.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.sp
این برنامه یک نرم‌افزار آزاد است: شما می‌توانید تحت شرایط «پروانهٔ عمومی همگانی گنو» (GNU General Public License) منتشر شده توسط بنیاد نرم‌افزارهای آزاد، چه نسخهٔ ۳ این پروانه یا (به انتخاب خودتان) هر نسخهٔ بالاتر، آن را بازتوزیع کرده و/یا تغییر دهید\&.
.sp
این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانت؛ حتی بدون ضمانت ضمنیِ قابلیت فروش یا تناسب با یک هدف خاص\&. برای جزئیات بیشتر به پروانهٔ عمومی همگانی گنو مراجعه کنید\&.
.sp
شما باید به همراه این برنامه یک نسخه از پروانهٔ عمومی همگانی گنو را دریافت کرده باشید\&. در غیر این صورت، https://www\&.gnu\&.org/licenses را مشاهده کنید\&.
.SH "منابع (RESOURCES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
وبگاه:
https://www\&.qutebrowser\&.org
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
فهرست پستی:
qutebrowser@lists\&.qutebrowser\&.org
/
https://listi\&.jpberlin\&.de/mailman/listinfo/qutebrowser
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
فهرست پستی فقط اعلان:
qutebrowser\-announce@lists\&.qutebrowser\&.org
/
https://listi\&.jpberlin\&.de/mailman/listinfo/qutebrowser\-announce
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
آی‌آرسی (IRC):
#qutebrowser
در
Libera Chat
(چت تحت وب،
از طریق Matrix)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
گیت‌هاب:
https://github\&.com/qutebrowser/qutebrowser
.RE
.SH "نویسندگان (AUTHORS)"
.sp
برنامهٔ \fBqutebrowser\fR توسط Freya Bruhin نوشته شده است\&. اسامی تمام مشارکت‌کنندگان را می‌توان در فایل README توزیع‌شده با qutebrowser یافت\&.