| FASTFETCH(1) | FASTFETCH | FASTFETCH(1) |
نام (NAME)
fastfetch - ابزاری سریع، قدرتمند و پرامکانات برای نمایش اطلاعات سیستم، مشابه neofetch
خلاصه دستور (SYNOPSIS)
fastfetch [گزینهها...]
توضیحات (DESCRIPTION)
ابزار fastfetch برنامهای برای نمایش اطلاعات سیستم به شیوهای جذاب و دیداری است. این ابزار که عمدتاً به زبان C نوشته شده است، بر کارایی، سرعت بالا و قابلیت شخصیسازی گسترده تمرکز دارد و عملکردی مشابه neofetch ارائه میدهد. این برنامه از لینوکس، اندروید، FreeBSD، macOS و ویندوز ۷ یا جدیدتر پشتیبانی میکند.
پیکربندی (CONFIGURATION)
ساختار فراخوانی (Fetch Structure)
ساختار مشخص میکند که کدام ماژولها و با چه ترتیبی نمایش داده شوند. این ساختار از نام ماژولها تشکیل شده است که با دونقطه (:) از یکدیگر جدا میشوند. به عنوان مثال: title:separator:os:kernel:uptime
برای مشاهده فهرست تمامی ماژولهای موجود، از گزینه --list-modules استفاده کنید.
فایلهای پیکربندی (Config Files)
برنامه Fastfetch از فرمت JSONC (همان JSON به همراه کامنت) برای فایلهای پیکربندی استفاده میکند. این فایلها باید دارای پسوند .jsonc باشند.
میتوانید با استفاده از گزینه --gen-config یک فایل پیکربندی پیشفرض ایجاد کنید. این فایل به صورت پیشفرض در مسیر ~/.config/fastfetch/config.jsonc ذخیره میشود.
فایلهای پیکربندی/پیشتنظیم (presets) به ترتیب در مسیرهای زیر جستجو میشوند:
1. نسبت به دایرکتوری کاری جاری
2. نسبت به ~/.local/share/fastfetch/presets/
3. نسبت به /usr/share/fastfetch/presets/
برای اطلاعات تفصیلی درباره گزینههای نشانواره (logo)، پیکربندی ماژولها و قالببندی، مراجعه کنید به: https://github.com/fastfetch-cli/fastfetch/wiki/Configuration
برنامه Fastfetch چندین پیشتنظیم داخلی ارائه میدهد. برای مشاهده فهرست آنها از گزینه --list-presets استفاده کنید.
اسکیمای JSON (JSON Schema)
یک طرحواره JSON (JSON schema) برای تکمیل خودکار و هوشمندی ویرایشگرها هنگام ویرایش فایل پیکربندی در دسترس است. خط زیر را به ابتدای فایل پیکربندی خود اضافه کنید:
"$schema": "https://github.com/fastfetch-cli/fastfetch/raw/dev/doc/json_schema.json"
گزینهها (OPTIONS)
گزینهها بدون حساسیت به حروف بزرگ و کوچک (case-insensitive) پردازش میشوند؛ برای نمونه، --logo-type و --LOGO-TYPE یکسان در نظر گرفته میشوند.
آرگومانهای درون قلاب [...] اختیاری هستند. آرگومانهای بولی (boolean) اختیاری در صورت مشخص شدن بدون مقدار، به صورت پیشفرض 'true' در نظر گرفته میشوند.
برای اطلاعات دقیقتر درباره یک گزینه خاص، از دستور زیر استفاده کنید: fastfetch -h <option_name_without_dashes>
هر ترکیبی از گزینهها را میتوان با ایجاد یک فایل پیکربندی دائمی کرد: fastfetch <options> --gen-config
اطلاعاتی (Informative)
- -h, --help [command]
- نمایش این پیام راهنما یا راهنمای یک دستور خاص.
- -v, --version
- نمایش نسخه کامل Fastfetch.
- --version-raw
- نمایش رشته خام نسخه (major.minor.patch).
- --list-config-paths
- فهرست کردن مسیرهای جستجوی فایلهای پیکربندی.
- --list-data-paths
- فهرست کردن مسیرهای جستجو برای پیشتنظیمها و نشانوارهها.
- --list-logos
- فهرست کردن نشانوارههای موجود.
- --list-modules
- فهرست کردن ماژولهای موجود.
- --list-presets
- فهرست کردن
پیشتنظیمهای
موجود.
پیشتنظیمها را میتوان با "--config <preset-name>" بارگذاری کرد.
- --list-features
- فهرست کردن
قابلیتهای
پشتیبانیشدهای
که fastfetch با
آنها
کامپایل
شده است.
عمدتاً برای اهداف توسعه و برنامهنویسی.
- --print-logos
- نمایش نشانوارههای موجود.
- --print-structure
- نمایش ساختار پیشفرض.
- --format enum
- تنظیم قالب خروجی.
- -j, --json [bool]
- فعال یا
غیرفعال
کردن خروجی
JSON.
میانبری برای `--format json`.
- --dynamic-interval num
- در حال اجرا
نگه داشتن
Fastfetch و
تازهسازی
خروجی در هر
<num>
میلیثانیه.
مقدار 0 (پیشفرض) این رفتار را غیرفعال میکند؛ با --json کار نمیکند.
- -w, --watch [num]
- نام مستعار برای dynamic-interval، اما مقدار بر حسب ثانیه است نه میلیثانیه. در صورت عدم تعیین مقدار، پیشفرض ۱ ثانیه است.
پیکربندی (Config)
- -c, --config config
- مشخص کردن
فایل
پیکربندی
یا
پیشتنظیم
برای
بارگذاری.
فایل به ترتیبی که توسط "fastfetch --list-config-paths" نمایش داده میشود جستجو میگردد. برای خواندن پیکربندی از ورودی استاندارد (stdin) از "-" استفاده کنید، یا از "none" برای غیرفعال کردن بارگذاری بیشتر پیکربندی. همچنین برای جزئیات به https://github.com/fastfetch-cli/fastfetch/wiki/Configuration مراجعه فرمایید.
- --gen-config [path]
- ایجاد
تعاملی یک
فایل
پیکربندی
در مسیر
مشخصشده.
در صورت اجرا در ترمینال، یک رابط کاربری تعاملی برای پیکربندی باز میکند. در صورتی که متغیر محیطی `$NO_COLOR` تنظیم شده باشد یا ورودی/خروجی استاندارد یک TTY نباشد، به حالت غیرتعاملی برمیگردد. مسیر پیشفرض "~/.config/fastfetch/config.jsonc" است. اگر <path> برابر "-" باشد، پیکربندی ایجادشده را در خروجی چاپ میکند.
عمومی (General)
- --thread [bool]
- استفاده از رشتههای پردازشی (threads) جداگانه برای درخواستهای HTTP.
- --wmi-timeout num
- تنظیم مهلت
زمانی
(میلیثانیه)
برای
پرسوجوهای
WMI.
فقط در ویندوز.
- --processing-timeout num
- تنظیم مهلت زمانی (میلیثانیه) هنگام انتظار برای فرآیندهای فرزند.
- --ds-force-drm [enum]
- مشخص کردن
اینکه آیا
تشخیص
نمایشگر
باید فقط از
DRM استفاده
کند یا خیر.
اگر با سایر روشهای تشخیص به مشکل برخوردید از این گزینه استفاده کنید. فقط در لینوکس.
- --detect-version [bool]
- مشخص کردن
اینکه آیا
نسخه
ترمینال،
شل،
ویرایشگر و
موارد دیگر
تشخیص داده
و نمایش
داده شود یا
خیر.
عمدتاً برای بنچمارک و سنجش کارایی.
نشانواره (Logo)
- -l, --logo logo
- تنظیم منبع
نشانواره.
برای
غیرفعال
کردن نمایش
نشانواره
از "none"
استفاده
کنید.
از نام یک نشانواره داخلی یا مسیر یک فایل تصویری استفاده کنید. همچنین به https://github.com/fastfetch-cli/fastfetch/wiki/Logo-options مراجعه کنید.
- --logo-type enum
- تنظیم نوع
نشانواره
مشخصشده
توسط "--logo".
همچنین به https://github.com/fastfetch-cli/fastfetch/wiki/Logo-options مراجعه کنید.
- --logo-width num
- تنظیم عرض
نشانواره
(بر حسب
کاراکتر) در
صورتی که یک
تصویر باشد.
برای پروتکل تصویری iTerm الزامی است.
- --logo-height num
- تنظیم
ارتفاع
نشانواره
(بر حسب
کاراکتر) در
صورتی که یک
تصویر باشد.
برای پروتکل تصویری iTerm الزامی است.
- --logo-preserve-aspect-ratio [bool]
- مشخص کردن
اینکه آیا
نشانواره
باید بدون
کشیدگی تا
حد ممکن عرض
و ارتفاع
مشخصشده
را پر کند
یا خیر.
فقط توسط پروتکل تصویری iTerm پشتیبانی میشود.
- --logo-color-[1-9] color
- بازنویسی و
تغییر یک
رنگ در
نشانواره.
برای فهرست رنگهای موجود `-h color` را ببینید.
- --logo-padding num
- تنظیم فاصله خالی (padding) در سمت چپ و راست نشانواره.
- --logo-padding-left num
- تنظیم فاصله خالی در سمت چپ نشانواره.
- --logo-padding-right num
- تنظیم فاصله خالی در سمت راست نشانواره.
- --logo-padding-top num
- تنظیم فاصله خالی در بالای نشانواره.
- --logo-print-remaining [bool]
- مشخص کردن اینکه آیا وقتی ارتفاع نشانواره از فهرست ماژولها بلندتر است، خطوط باقیمانده نشانواره چاپ شوند یا خیر.
- --logo-position enum
- تنظیم موقعیت نمایش نشانواره.
- --logo-recache [bool]
- در صورت انتخاب true، بازتولید حافظه نهان (cache) تصویر نشانواره.
- --file path
- کوتاهنوشت
برای --logo-type file --logo <path>.
برای اطلاعات بیشتر "--help logo-type" را ببینید.
- --file-raw path
- کوتاهنوشت
برای --logo-type file-raw --logo <path>.
برای اطلاعات بیشتر "--help logo-type" را ببینید.
- --data data
- کوتاهنوشت
برای --logo-type data --logo <data>.
برای اطلاعات بیشتر "--help logo-type" را ببینید.
- --data-raw data
- کوتاهنوشت
برای --logo-type data-raw --logo <data>.
برای اطلاعات بیشتر "--help logo-type" را ببینید.
- --raw path
- کوتاهنوشت
برای --logo-type raw --logo <path>.
برای اطلاعات بیشتر "--help logo-type" را ببینید.
- --sixel path
- کوتاهنوشت
برای --logo-type sixel --logo <path>.
برای اطلاعات بیشتر "--help logo-type" را ببینید.
- --kitty path
- کوتاهنوشت
برای --logo-type kitty --logo <path>.
برای اطلاعات بیشتر "--help logo-type" را ببینید.
- --kitty-direct path
- کوتاهنوشت
برای --logo-type kitty-direct --logo
<path>.
برای اطلاعات بیشتر "--help logo-type" را ببینید.
- --kitty-icat path
- کوتاهنوشت
برای --logo-type kitty-icat --logo
<path>.
برای اطلاعات بیشتر "--help logo-type" را ببینید.
- --iterm path
- کوتاهنوشت
برای --logo-type iterm --logo <path>.
برای اطلاعات بیشتر "--help logo-type" را ببینید.
- --chafa path
- کوتاهنوشت
برای --logo-type chafa --logo <path>.
برای اطلاعات بیشتر "--help logo-type" را ببینید.
- --chafa-fg-only [bool]
- تولید
خروجی
سلولهای
کاراکتری
تنها با
استفاده از
رنگهای
پیشزمینه.
برای جزئیات به مستندات Chafa مراجعه فرمایید.
- --chafa-symbols str
- مشخص کردن
نمادهای
کاراکتری
مورد
استفاده در
خروجی
نهایی.
برای جزئیات به مستندات Chafa مراجعه فرمایید.
- --chafa-canvas-mode enum
- تعیین نحوه
استفاده از
رنگها در
خروجی.
این مقدار به مقدار عددی صحیح enum ChafaCanvasMode نگاشت میشود. برای جزئیات به مستندات Chafa مراجعه کنید.
- --chafa-color-space enum
- تنظیم فضای
رنگی مورد
استفاده
برای
کوانتیزاسیون.
این مقدار به مقدار عددی صحیح enum ChafaColorSpace نگاشت میشود. برای جزئیات به مستندات Chafa مراجعه کنید.
- --chafa-dither-mode enum
- تنظیم حالت
دیترینگ
خروجی (در
رنگ ۲۴ بیتی
تاثیری
ندارد).
این مقدار به مقدار عددی صحیح enum ChafaDitherMode نگاشت میشود. برای جزئیات به مستندات Chafa مراجعه کنید.
نمایش (Display)
- -s, --structure structure
- تنظیم
ساختار
نمایش
اطلاعات (fetch).
باید فهرستی از کلیدهای ماژول باشد که با دونقطه از هم جدا شدهاند. از "fastfetch --list-modules" برای مشاهده گزینههای موجود استفاده کنید.
- --structure-disabled structure
- غیرفعال
کردن
ماژولهای
خاص در
ساختار.
باید فهرستی از کلیدها باشد که با دونقطه از هم جدا شدهاند.
- --stat [bool]
- نمایش زمان اجرای هر یک از ماژولها (بر حسب میلیثانیه).
- --pipe [bool]
- غیرفعال
کردن
رنگها.
به صورت پیشفرض بر پایه isatty(1) به طور خودکار تشخیص داده میشود.
- --color color
- تنظیم رنگ
هر دو بخش
کلیدها و
عنوان.
میانبری برای "--color-keys <color>" و "--color-title <color>". برای ساختار نحوی رنگها، https://github.com/fastfetch-cli/fastfetch/wiki/Color-Format-Specification را ببینید.
- --color-keys color
- تنظیم رنگ
کلیدها.
بر ماژولهای Title ،Separator و Colors تاثیری ندارد. برای فهرست رنگهای موجود `-h color` را ببینید.
- --color-title color
- تنظیم رنگ
عنوان.
برای فهرست رنگهای موجود `-h color` را ببینید.
- --color-output color
- تنظیم رنگ
خروجی
ماژول.
برای فهرست رنگهای موجود `-h color` را ببینید.
- --color-separator color
- تنظیم رنگ
جداکننده
کلید-مقدار.
برای فهرست رنگهای موجود `-h color` را ببینید.
- --duration-abbreviation [bool]
- مشخص کردن
اینکه آیا
مقادیر مدت
زمان خلاصه
شوند یا
خیر.
اگر true باشد، خروجی به جای "1 hour, 2 mins" به صورت "1h 2m" نمایش داده میشود.
- --duration-space-before-unit enum
- مشخص کردن اینکه آیا قبل از واحد در مقادیر مدت زمان یک فاصله قرار گیرد یا خیر.
- --key-width num
- تراز کردن عرض کلیدها با <num> کاراکتر.
- --key-padding-left num
- تنظیم فاصله خالی سمت چپ کلیدها به <num> کاراکتر.
- --key-type enum
- مشخص کردن اینکه آیا یک آیکون قبل از کلیدهای متنی نمایش داده شود یا خیر.
- --key-language [enum]
- مشخص کردن
زبان مورد
استفاده
برای
کلیدهای
ماژول.
برای تشخیص خودکار بر پایه زبان محلی سیستم (locale)، خالی بگذارید. در صورت عدم پشتیبانی از زبان محلی، به انگلیسی برمیگردد.
- --bright-color [bool]
- مشخص کردن اینکه آیا کلیدها، عنوان و نشانواره اسکی با رنگهای روشن (bright) چاپ شوند یا خیر.
- --separator str
- تنظیم جداکننده میان کلید و مقدار.
- --show-errors [bool]
- چاپ خطاها در صورت وقوع.
- --disable-linewrap [bool]
- مشخص کردن اینکه آیا شکست خودکار خطوط (line wrap) در حین اجرا غیرفعال شود یا خیر.
- --hide-cursor [bool]
- مشخص کردن اینکه آیا مکاننما (cursor) در حین اجرا پنهان شود یا خیر.
- --percent-type num
- تنظیم سبک
نمایش
درصدها.
1 برای عدد درصد 2 برای نوار چندرنگ 3 برای هر دو 6 فقط برای نوار 9 برای عدد رنگی 10 برای نوار تکرنگ
- --percent-ndigits num
- تنظیم تعداد ارقام اعشار هنگام قالببندی درصدها.
- --percent-color-green color
- تنظیم رنگ
مورد
استفاده
برای وضعیت
سبز نوارها
و اعداد
درصد.
برای فهرست رنگهای موجود `-h color` را ببینید.
- --percent-color-yellow color
- تنظیم رنگ
مورد
استفاده
برای وضعیت
زرد نوارها
و اعداد
درصد.
برای فهرست رنگهای موجود `-h color` را ببینید.
- --percent-color-red color
- تنظیم رنگ
مورد
استفاده
برای وضعیت
قرمز
نوارها و
اعداد درصد.
برای فهرست رنگهای موجود `-h color` را ببینید.
- --percent-space-before-unit enum
- مشخص کردن اینکه آیا قبل از نماد درصد یک فاصله قرار گیرد یا خیر.
- --percent-width num
- مشخص کردن
عرض عدد
درصد بر حسب
کاراکتر.
این گزینه فقط بر اعداد درصد تاثیر میگذارد، نه نوارها.
- --bar-char-elapsed str
- تنظیم کاراکتر مورد استفاده برای بخش سپریشده نوار درصد.
- --bar-char-total str
- تنظیم کاراکتر مورد استفاده برای کل طول نوار درصد.
- --bar-border-left string
- تنظیم رشته مورد استفاده برای حاشیه سمت چپ نوارهای درصد.
- --bar-border-right string
- تنظیم رشته مورد استفاده برای حاشیه سمت راست نوارهای درصد.
- --bar-border-left-elapsed string
- اگر هر دو گزینه bar-border-left-elapsed و bar-border-right-elapsed تنظیم شوند، حاشیه به عنوان بخشی از محتوای نوار استفاده میشود.
- --bar-border-right-elapsed string
- اگر هر دو گزینه bar-border-left-elapsed و bar-border-right-elapsed تنظیم شوند، حاشیه به عنوان بخشی از محتوای نوار استفاده میشود.
- --bar-color-elapsed color
- تنظیم رنگ
مورد
استفاده
برای بخش
سپریشده
نوارهای
درصد.
به طور پیشفرض بر اساس percent-color-{green,yellow,red} به طور خودکار انتخاب میشود.
- --bar-color-total color
- تنظیم رنگ مورد استفاده برای کل طول نوارهای درصد.
- --bar-color-border color
- تنظیم رنگ مورد استفاده برای حاشیههای نوار درصد.
- --bar-width num
- تنظیم عرض نوارهای درصد بر حسب کاراکتر.
- --no-buffer [bool]
- مشخص کردن اینکه آیا بافرینگ خروجی استاندارد (stdout) غیرفعال شود یا خیر.
- --size-ndigits num
- تنظیم تعداد ارقام اعشار هنگام قالببندی اندازهها و حجمها.
- --size-binary-prefix enum
- تنظیم پیشوند دودویی (binary prefix) مورد استفاده هنگام قالببندی اندازهها.
- --size-max-prefix enum
- تنظیم بزرگترین پیشوند دودویی مورد استفاده هنگام قالببندی اندازهها.
- --size-space-before-unit enum
- مشخص کردن اینکه آیا قبل از واحد یک فاصله قرار گیرد یا خیر.
- --freq-ndigits num
- تنظیم تعداد ارقام اعشار هنگام نمایش فرکانس پردازنده مرکزی (CPU) یا گرافیکی (GPU) بر حسب گیگاهرتز.
- --freq-space-before-unit enum
- مشخص کردن اینکه آیا قبل از واحد یک فاصله قرار گیرد یا خیر.
- --fraction-ndigits num
- تنظیم
تعداد
ارقام
اعشار
هنگام
نمایش
مقادیر
کسری.
در صورت منفی بودن، تعداد ارقام بر اساس مقدار به طور خودکار تعیین میشود.
- --fraction-trailing-zeros enum
- تنظیم شرایط حفظ صفرهای پایانی.
- --temp-unit enum
- تنظیم واحد اندازهگیری دما.
- --temp-ndigits num
- تنظیم تعداد ارقام اعشار هنگام نمایش دما.
- --temp-color-green color
- تنظیم رنگ
مورد
استفاده
برای وضعیت
سبز مقادیر
دما.
برای فهرست رنگهای موجود `-h color` را ببینید.
- --temp-color-yellow color
- تنظیم رنگ
مورد
استفاده
برای وضعیت
زرد مقادیر
دما.
برای فهرست رنگهای موجود `-h color` را ببینید.
- --temp-color-red color
- تنظیم رنگ
مورد
استفاده
برای وضعیت
قرمز
مقادیر دما.
برای فهرست رنگهای موجود `-h color` را ببینید.
- --temp-space-before-unit enum
- مشخص کردن اینکه آیا قبل از واحد یک فاصله قرار گیرد یا خیر.
مثالها (EXAMPLES)
کاربرد پایهای
fastfetch
استفاده از یک نشانواره خاص
fastfetch --logo arch
ساختار سفارشی
fastfetch --structure title:os:kernel:uptime:memory
ایجاد فایل پیکربندی
fastfetch --gen-config
استفاده از یک پیشتنظیم
fastfetch --config neofetch
نمونه فایل پیکربندی
// ~/.config/fastfetch/config.jsonc
{
"$schema": "https://github.com/fastfetch-cli/fastfetch/raw/dev/doc/json_schema.json",
"logo": {
"type": "auto",
"source": "arch"
},
"display": {
"separator": ": ",
"color": {
"keys": "blue",
"title": "red"
},
"key": {
"width": 12
}
},
"modules": [
"title",
"separator",
"os",
"kernel",
"uptime",
{
"type": "memory",
"format": "{used}/{total} ({used_percent}%)"
}
]
}
همچنین ببینید (SEE ALSO)
اشکالات (BUGS)
لطفاً اشکالات را به نشانی زیر گزارش دهید: https://github.com/fastfetch-cli/fastfetch/issues
نویسندگان (AUTHORS)
برنامه Fastfetch توسط تیمی از مشارکتکنندگان در گیتهاب توسعه داده شده است. برای اطلاعات بیشتر به https://github.com/fastfetch-cli/fastfetch مراجعه کنید.
| Sep 01 2026 | Fastfetch 2.68.1 |