conky(1)

General Commands Manual

conky(1)

نام (NAME)

conky - مانیتور سیستم برای سامانه X

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

conky [ options ]

توضیحات (DESCRIPTION)

برنامه Conky یک مانیتور سیستم برای سامانه X است که در ابتدا بر پایه torsmo توسعه یافته بود. از زمان پیدایش خود، Conky تغییرات قابل‌توجهی نسبت به نسخه پیشین خود داشته، در حالی که سادگی و قابلیت پیکربندی خود را حفظ کرده است. برنامه Conky می‌تواند تقریباً هر چیزی را چه روی میزکار اصلی (root desktop) و چه در پنجره اختصاصی خود نمایش دهد. برنامه Conky نه‌تنها دارای اشیاء داخلی فراوانی است، بلکه می‌تواند تقریباً هر نوع اطلاعاتی را با استفاده از اسکریپت‌ها و برنامه‌های خارجی دیگر نیز نمایش دهد.

برنامه Conky دارای بیش از ۲۵۰ شیء داخلی است، شامل پشتیبانی از انبوهی از آمارهای سیستم‌عامل (تنها به عنوان نمونه: uname، زمان فعالیت یا uptime، مصرف پردازنده، مصرف حافظه، مصرف دیسک، آمار پردازش‌ها مشابه "top" و پایش شبکه)، پشتیبانی داخلی از پروتکل‌های IMAP و POP3، پشتیبانی داخلی از بسیاری از پخش‌کننده‌های موسیقی محبوب (مانند MPD، XMMS2، Audacious) و موارد بسیار دیگر. برنامه Conky می‌تواند این اطلاعات را به صورت متن یا با استفاده از نوار پیشرفت‌های ساده و ابزارک‌های نموداری با قلم‌ها و رنگ‌های گوناگون نمایش دهد.

ما همیشه به دنبال مشارکت و کمک هستیم؛ چه در زمینه گزارش باگ‌ها، چه نگارش وصله‌ها (patches) یا نوشتن مستندات. لطفاً برای گزارش باگ‌ها، درخواست ویژگی‌های جدید و ارسال وصله‌ها از امکانات گیت‌هاب (GitHub) استفاده کنید.

از علاقه و توجه شما به Conky سپاسگزاریم.

کامپایل (COMPILING)

برای کاربرانی که برنامه را از سورس‌کد روی یک توزیع باینری کامپایل می‌کنند، مطمئن شوید که کتابخانه‌های توسعه X را نصب کرده‌اید (مگر اینکه ساخت خود را بدون X11 پیکربندی کنید). این بسته معمولاً برای کتابخانه‌های X11 به نام "libx11-dev" یا "xorg-x11-dev" است، و قالبی مشابه با پسوند "-dev" برای سایر کتابخانه‌های مورد نیاز دارد (بسته به گزینه‌های ساخت شما). با بررسی خطاهایی که هنگام اجرای `cmake' دریافت می‌کنید، می‌توانید ببینید چه بسته‌های اضافی دیگری را باید نصب کنید. ساده‌ترین روش برای مشاهده گزینه‌های ساخت موجود، اجرای `ccmake' یا `cmake-gui' از درون درخت سورس‌کد است؛ اما هنگام غیرفعال کردن برخی قابلیت‌ها احتیاط کنید، زیرا ممکن است عملکردهای مورد نظر خود را از دست بدهید. برای نمونه، با غیرفعال بودن BUILD_MATH خطایی دریافت نخواهید کرد، اما نمودارهای لگاریتمی به نمودارهای معمولی تبدیل می‌شوند و درجه‌ها خط شاخص خود را از دست می‌دهند.

برنامه Conky (مدت‌هاست) در مخازن بیشتر توزیع‌های محبوب در دسترس است. در اینجا چند دستورالعمل نصب برای برخی توزیع‌ها آمده است:

کاربران Gentoo -- برنامه Conky در سیستم پورتج (Portage) گنتو قرار دارد... برای نصب کافی است دستور "emerge app-admin/conky" را اجرا کنید.

کاربران دبیان و موارد مشابه -- برنامه Conky باید در مخازن شما موجود باشد و با اجرای "aptitude install conky" قابل نصب است.

نمونه‌ای برای کامپایل و اجرای Conky با مؤلفه‌های پیش‌فرض (توجه داشته باشید که برخی از گزینه‌های ساخت ممکن است برای سیستم شما متفاوت باشند):

cmake -D CMAKE_INSTALL_PREFIX:string=/usr .
make
make install # اختیاری
src/conky

سازگاری Conky با استانداردهای C99 C و C++0x C++ آزمایش شده است، با این حال به جز با کامپایلر gcc با مورد دیگری تست نشده و تضمینی برای کارکرد با سایر کامپایلرها وجود ندارد.

نکته: سعی کنید به جای استفاده صرف از `cmake'، برنامه Conky را با `ccmake' یا `cmake-gui' پیکربندی نمایید.

نکات قابل توجه (YOU SHOULD KNOW)

برنامه Conky عموماً از نظر مصرف منابع بسیار بهینه عمل می‌کند. با این حال، هرچه وظایف بیشتری بر دوش Conky بگذارید، منابع بیشتری نیز مصرف خواهد کرد.

یک راه ساده برای اجبار Conky به بارگذاری مجدد فایل ~/.config/conky/conky.conf: دستور "killall -SIGUSR1 conky"; است. این کار شما را از زحمت متوقف کردن و اجرای مجدد برنامه بی‌نیاز می‌کند.

گزینه‌ها (OPTIONS)

گزینه‌های خط فرمان بر تنظیمات مشخص‌شده در فایل پیکربندی اولویت دارند و آن‌ها را بازنویسی می‌کنند.

-a | --alignment= ALIGNMENT: تراز متن روی صفحه، {top,bottom,middle}_{left,right,middle} یا none. همچنین می‌تواند با حروف ابتدایی موقعیت به صورت مخفف مشخص شود، مثلاً tr برای top_right. تنها با فعال بودن فلگ ساخت BUILD_X11 در دسترس است.
-b | --double-buffer: استفاده از بافر دوگانه (double buffering) برای حذف پرش و چشمک‌زدن تصویر ("flicker"). تنها با فعال بودن فلگ ساخت BUILD_X11 در دسترس است.
-c | --config= FILE: فایل پیکربندی که باید به جای ~/.config/conky/conky.conf بارگذاری شود.
-C | --print-config: چاپ پیکربندی پیش‌فرض داخلی در خروجی استاندارد (stdout). برای اطلاعات بیشتر، بخش EXAMPLES (مثال‌ها) را نیز ببینید. تنها با فعال بودن فلگ ساخت BUILD_BUILTIN_CONFIG در دسترس است.
-d | --daemonize: تبدیل Conky به دیمن (انشعاب به پس‌زمینه).
-D | --debug: افزایش خروجی اشکال‌زدایی؛ برای نمونه -DD برای اشکال‌زدایی بیشتر.
-f | --font= FONT: قلم مورد استفاده. تنها با فعال بودن فلگ ساخت BUILD_X11 در دسترس است.
-h | --help: راهنمای خط فرمان را چاپ می‌کند و خارج می‌شود.
-i COUNT: تعداد دفعات به‌روزرسانی Conky (و سپس خروج از برنامه).
-o | --own-window: ایجاد یک پنجره اختصاصی برای رسم و نمایش. تنها با فعال بودن فلگ ساخت BUILD_X11 در دسترس است.
-p | --pause= SECONDS: مدت زمان مکث/انتظار (به ثانیه) پیش از شروع به کار واقعی Conky.
-q | --quiet: اجرای Conky در «حالت بی‌صدا» ('quiet mode'؛ به معنی عدم نمایش خروجی).
-t | --text= TEXT: متن برای رندر شدن؛ به خاطر داشته باشید که باید از نقل‌قول تکی (کوتاسیون) استفاده کنید، مانند -t ' $uptime '.
-u | --interval= SECONDS: فاصله زمانی به‌روزرسانی (به ثانیه).
-U | --unique: اگر فرآیند دیگری از Conky از قبل در حال اجرا باشد، Conky شروع نخواهد شد. فقط برای Linux، FreeBSD، NetBSD، OpenBSD و Haiku پیاده‌سازی شده است.
-v | -V | --version: اطلاعات نسخه، اطلاعات ساخت و اطلاعات عمومی را چاپ می‌کند. پس از چاپ خارج می‌شود.
-w | --window-id= WIN_ID: شناسه پنجره (Window id) برای رسم روی آن. تنها با فعال بودن فلگ ساخت BUILD_X11 در دسترس است.
-x X_COORDINATE: موقعیت افقی (مختصات X).
-X | --display= DISPLAY: نمایشگر X11 مورد استفاده. تنها با فعال بودن فلگ ساخت BUILD_X11 در دسترس است.
-y Y_COORDINATE: موقعیت عمودی (مختصات Y).

تنظیمات پیکربندی (CONFIGURATION SETTINGS)

این فهرست گزینه‌های پیکربندی سراسری Conky است. این گزینه‌ها در بخش conky.config فایل پیکربندی شما، پیش از conky.text قرار می‌گیرند.

محل پیش‌فرض فایل پیکربندی ~/.config/conky/conky.conf یا ${sysconfdir}/conky/conky.conf است. در اکثر سیستم‌ها، $sysconfdir برابر با /etc است، و می‌توانید نمونه فایل پیکربندی را در /etc/conky/conky.conf پیدا کنید.

شاید مایل باشید فایل پیکربندی پیش‌فرض را به ~/.config/conky/conky.conf رونوشت کرده و آن را در آنجا ویرایش کنید. پیکربندی‌های ارائه‌شده توسط کاربران را می‌توانید در نشانی زیر بیابید: https://github.com/brndnmtthws/conky/wiki/Configs

آرگومان‌های اختیاری معمولاً با پرانتز مشخص می‌شوند، برای نمونه (optional).

alignment: تراز روی صفحه. می‌تواند none یا یکی از موارد زیر باشد:

top_left (یا tl)	top_middle (یا tm)	top_right (یا tr)
middle_left (یا ml)	middle_middle (یا mm)	middle_right (یا mr)
bottom_left (یا bl)	bottom_middle (یا bm)	bottom_right (یا br)

برای پنجره‌های panel و dock، ممکن است استفاده از یکی از نام‌های مستعار زیر مفیدتر باشد:

Alias	Value
top	top_middle
left	middle_left
right	middle_right
bottom	bottom_middle
center	middle_middle

همچنین تنظیمات gap_x و gap_y را ببینید.

append_file: پیوست کردن فایلی که به عنوان آرگومان داده شده است.
background: مقدار بولی (Boolean). اگر true باشد، Conky هنگام شروع به کار در پس‌زمینه منشعب (fork) می‌شود.
border_inner_margin: حاشیه درونی کادر به پیکسل (فاصله بین کادر و متن).
border_outer_margin: حاشیه بیرونی کادر به پیکسل (فاصله بین کادر و لبه پنجره).
border_width: عرض کادر به پیکسل.
colorN: تعریف اولیه یک رنگ برای استفاده در بخش‌های conky.text. به جای N رقمی بین 0 تا 9 (شامل خود آن‌ها) قرار دهید. هنگام مشخص کردن مقدار رنگ در مبنای شانزده (hex)، علامت # ابتدای آن را حذف کنید.
console_bar_fill: نویسه‌ای برای پر کردن نوارهای کنسول.

پیش‌فرض: #

console_bar_unfill: نویسه‌ای برای بخش خالی نوارهای کنسول.

پیش‌فرض: .

console_graph_ticks: فهرستی از رشته‌ها (جداشده با کاما) برای استفاده به عنوان میله‌های نموداری که در کنسول یا شل رندر می‌شود. نخستین مورد فهرست برای حداقل ارتفاع میله و آخرین مورد برای حداکثر ارتفاع استفاده می‌شود، به عنوان مثال ",_,=,#".
cpu_avg_samples: تعداد نمونه‌ها برای میانگین‌گیری در پایش پردازنده (CPU).
default_bar_height: تعیین ارتفاع پیش‌فرض برای نوارها.

پیش‌فرض: 6

default_bar_width: تعیین عرض پیش‌فرض برای نوارها. در صورت عدم تعیین، مقدار پیش‌فرض 0 است که باعث می‌شود نوار به اندازه عرض پنجره Conky گسترش یابد. اگر out_to_console = true تنظیم شود، مقدار پیش‌فرض برای نسخه متنی نوار برابر با 10 خواهد بود.
default_color: رنگ پیش‌فرض متن و کادر.
default_gauge_height: تعیین ارتفاع پیش‌فرض برای درجه‌ها (gauges).

پیش‌فرض: 25

default_gauge_width: تعیین عرض پیش‌فرض برای درجه‌ها (gauges).

پیش‌فرض: 40

default_graph_height: تعیین ارتفاع پیش‌فرض برای نمودارها.

پیش‌فرض: 25

default_graph_width: تعیین عرض پیش‌فرض برای نمودارها. در صورت عدم تعیین، مقدار پیش‌فرض 0 است که باعث می‌شود نمودار به اندازه عرض پنجره Conky گسترش یابد. اگر out_to_console = true تنظیم شود، نسخه متنی نمودار عملاً هیچ عرضی نخواهد داشت و لازم است یک مقدار پیش‌فرض مناسب تعیین کنید یا ارتفاع و عرض هر نمودار را به صورت جداگانه تنظیم نمایید.
default_outline_color: رنگ خط دور (outline) پیش‌فرض.
default_shade_color: رنگ سایه پیش‌فرض و رنگ سایه کادر.
detect_battery: یک یا چند باتری برای بررسی جهت استفاده از update_interval_on_battery (جداشده با کاما).

پیش‌فرض: BAT0

disable_auto_reload: فعال‌سازی این گزینه قابلیت بارگذاری خودکار پیکربندی مبتنی بر inotify را غیرفعال می‌کند.
diskio_avg_samples: تعداد نمونه‌ها برای میانگین‌گیری در پایش ورودی/خروجی (I/O) دیسک.
display: مشخص کردن نمایشگر X برای اتصال به آن.
double_buffer: استفاده از افزونه Xdbe؟ (حذف چشمک‌زدن تصویر) به شدت توصیه می‌شود همراه با این گزینه از پنجره اختصاصی (own window) استفاده کنید تا بافر دوگانه بیش از حد بزرگ نشود.
draw_blended: بولی؛ آیا هنگام رندر تصویر رسم‌شده ترکیب رنگ (blend) انجام شود؟ برخی تصاویر به نادرستی ترکیب می‌شوند و کانال آلفا را در حالت‌های بصری ARGB خراب می‌کنند. این گزینه با غیرفعال کردن ترکیب، یک راهکار جایگزین ممکن ارائه می‌دهد.

پیش‌فرض: True

draw_borders: رسم کادر در اطراف متن.
draw_graph_borders: رسم کادر در اطراف نمودارها.
draw_outline: رسم خطوط دور (outlines).
draw_shades: رسم سایه‌ها.
extra_newline: قرار دادن یک خط جدید اضافی در انتها هنگام نوشتن در خروجی استاندارد؛ برای نوشتن در wiboxهای مدیر پنجره awesome مفید است.
font: نام قلم در سامانه X؛ می‌توان از ابزار xfontsel برای انتخاب یک قلم مناسب استفاده کرد.
fontN: پیش‌تعریف قلمی که در بخش‌های conky.text استفاده می‌شود. مقدار N را با عددی بین 0 تا 9 (شامل هر دو) جایگزین کنید. از همان قالبی که برای متغیر font به کار می‌رود استفاده نمایید.
forced_redraw: مقدار بولی؛ در صورت تنظیم روی true، هنگام تعویض فضای کاری (میزکار)، Conky همه چیز را از نو بازطراحی می‌کند. این امر ممکن است در برخی از مدیرهای پنجره باعث تاخیر یا پرش تصویر شود.
format_human_readable: در صورت فعال بودن، مقادیری که بر حسب بایت هستند در قالبی خوانا برای انسان نمایش داده می‌شوند (مانند KiB، MiB و غیره). در صورت غیرفعال بودن، به جای آن تعداد بایت‌ها چاپ می‌شود.
gap_x: فاصله (بر حسب پیکسل) بین حاشیه راست یا چپ صفحه نمایش؛ معادل ارسال -x در خط فرمان، مانند gap_x 10. برای سایر موارد مرتبط با موقعیت، به alignment مراجعه کنید.
gap_y: فاصله (بر حسب پیکسل) بین حاشیه بالا یا پایین صفحه نمایش؛ معادل ارسال -y در خط فرمان، مانند gap_y 10. برای سایر موارد مرتبط با موقعیت، به alignment مراجعه کنید.
github_token: مشخص کردن توکن API برای اعلان‌های گیت‌هاب (GitHub).

یک توکن API در نشانی زیر ایجاد کنید: https://github.com/settings/tokens/new?scopes=notifications&description=conky

graph_gradient_mode (rgb|hcl|hsv): فضای رنگی مورد استفاده برای درون‌یابی را تغییر می‌دهد. آرگومان‌ها شامل hcl، hsv و rgb (پیش‌فرض) هستند.

پیش‌فرض: rgb

hddtemp_host: نام میزبان برای اتصال به اشیاء hddtemp.

پیش‌فرض: 127.0.0.1

hddtemp_port: پورت مورد استفاده برای اتصالات hddtemp.

پیش‌فرض: 7634

http_port: پورت شنود برای اتصالات HTTP. مقدار پیش‌فرض 10080 است، اما توسط Firefox و Chrome مسدود شده است، بنابراین بهتر است حتماً آن را تغییر دهید.

پیش‌فرض: 10080

http_refresh: هنگامی که این گزینه تنظیم شود، صفحه تولید شده با out_to_http به طور خودکار در هر بازه زمانی تازه‌سازی خواهد شد.
if_up_strictness: میزان سخت‌گیری if_up هنگام بررسی فعال بودن یک رابط شبکه چقدر باشد؟ مقدار می‌تواند یکی از گزینه‌های up (پیش‌فرض)، link یا address باشد؛ برای بررسی این‌که رابط شبکه صرفاً بالا (up) است، بالا بوده و پیوند (link) برقرار است، یا بالا بوده، پیوند دارد و یک آدرس IP به آن تخصیص یافته است.

پیش‌فرض: up

imap host user pass [`-i interval (in seconds)'] [“-f `folder'”] [`-p port'] [“-e `command'”] [`-r retries']: سرور پیش‌فرض سراسری IMAP. پورت پیش‌فرض 143، پوشه پیش‌فرض `INBOX`، بازه زمانی پیش‌فرض 5 دقیقه، و تعداد تلاش مجدد پیش‌فرض قبل از انصراف 5 است. اگر گذرواژه به صورت ’*’ وارد شود، هنگام شروع Conky از شما خواسته می‌شود گذرواژه را وارد نمایید.
imlib_cache_flush_interval: بازه زمانی (بر حسب ثانیه) برای تخلیه حافظه موقت (کش) Imlib2.
imlib_cache_size: اندازه حافظه موقت (کش) تصویر Imlib2 بر حسب بایت. اگر از متغیر $image زیاد استفاده می‌کنید، این مقدار را افزایش دهید. برای غیرفعال کردن کش تصویر، مقدار را روی 0 قرار دهید.

پیش‌فرض: 4194304

lowercase: مقدار بولی؛ در صورت تنظیم روی true، متن با حروف کوچک نمایش داده می‌شود.
lua_draw_hook_post function_name [`function arguments']: این تابع، در صورت تعریف، در هر تکرار پس از رسم روی پنجره توسط Conky فراخوانی خواهد شد. به خروجی گرافیکی (X11 یا Wayland) نیاز دارد. هر تعداد آرگومان اختیاری را می‌پذیرد. از این قلاب برای رسم موارد روی چیزهایی که Conky رسم می‌کند استفاده کنید. برنامه Conky پیشوند `conky_` را در ابتدای function_name قرار می‌دهد تا از فراخوانی تصادفی تابع اشتباه جلوگیری شود، مگر اینکه خودتان `conky_` را در ابتدای آن قرار داده باشید. برای به دست آوردن سطح رسم جاری، از conky_surface() درون این قلاب استفاده کنید.
lua_draw_hook_pre function_name [`function arguments']: این تابع، در صورت تعریف، در هر تکرار پیش از رسم روی پنجره توسط Conky فراخوانی خواهد شد. به خروجی گرافیکی (X11 یا Wayland) نیاز دارد. هر تعداد آرگومان اختیاری را می‌پذیرد. از این قلاب برای رسم موارد روی چیزهایی که Conky رسم می‌کند استفاده کنید. برنامه Conky پیشوند `conky_` را در ابتدای function_name قرار می‌دهد تا از فراخوانی تصادفی تابع اشتباه جلوگیری شود، مگر اینکه خودتان `conky_` را در ابتدای آن قرار داده باشید. برای به دست آوردن سطح رسم جاری، از conky_surface() درون این قلاب استفاده کنید.
lua_load: فهرستی از مسیرهای اسکریپت Lua که در زمان راه‌اندازی بارگذاری می‌شوند تا توابع Lua را برای سایر قلاب‌ها فراهم کنند. فایل‌های فهرست‌شده قبل از `lua_startup_hook` بارگذاری (اجرا) می‌شوند و می‌توانند (اگرچه نباید) کدهایی را در دامنه سراسری (global scope) اجرا کنند.

مسیرها با `;` (نقطه‌ویرگول) از هم جدا می‌شوند و می‌توانند به صورت نسبی به مسیر فایل پیکربندی یا مطلق باشند.

مسیرها پیش‌تر با ’ ’ (فاصله) جدا می‌شدند؛ این عملکرد در صورتی که `;` پیدا نشود هنوز پشتیبانی می‌شود، اما منسوخ شده است و در نسخه‌های بعدی حذف خواهد شد. مسیرهای خالی نادیده گرفته می‌شوند، بنابراین `./example file.lua;` معتبر است.

lua_mouse_hook function_name: این تابع، در صورت تعریف، با دریافت رویدادهای ماوس از X یا Wayland توسط Conky فراخوانی خواهد شد. جدولی حاوی اطلاعات رویداد به عنوان آرگومان اول به این تابع ارسال می‌شود. از این قلاب برای تشخیص ورودی ماوس و پاسخ به آن استفاده نمایید. برنامه Conky نیازمند آن است که در تعریف تابع پیشوند `conky_` وجود داشته باشد تا از فراخوانی تصادفی تابع اشتباه جلوگیری شود.
lua_shutdown_hook function_name [`function arguments']: این تابع، در صورت تعریف، هنگام خاموش شدن Conky یا هنگام بارگذاری مجدد پیکربندی فراخوانی خواهد شد. از این قلاب برای پاکسازی منابع استفاده کنید، مانند آزادسازی حافظه‌ای که توسط کتابخانه‌های خارجی از طریق Lua تخصیص داده شده است. برنامه Conky پیشوند `conky_` را در ابتدای function_name قرار می‌دهد تا از فراخوانی تصادفی تابع اشتباه جلوگیری شود، مگر اینکه خودتان `conky_` را در ابتدای آن قرار داده باشید.
lua_startup_hook function_name [`function arguments']: این تابع، در صورت تعریف، در زمان راه‌اندازی Conky یا هنگام بارگذاری مجدد پیکربندی فراخوانی خواهد شد. از این قلاب برای مقداردهی اولیه مقادیر یا برای هر برنامه‌ای که فقط یک‌بار باید اجرا شود استفاده کنید. برنامه Conky پیشوند `conky_` را در ابتدای function_name قرار می‌دهد تا از فراخوانی تصادفی تابع اشتباه جلوگیری شود، مگر اینکه خودتان `conky_` را در ابتدای آن قرار داده باشید.
mail_spool: اسپول ایمیل (Mail spool) برای بررسی ایمیل‌ها.
max_port_monitor_connections: به هر ناظر پورت اجازه می‌دهد حداکثر این تعداد اتصال را ردیابی کند.

پیش‌فرض: 256

max_text_width integer_number: هنگامی که یک خط در خروجی شامل `width` کاراکتر باشد و هنوز به انتها نرسیده باشد، کاراکتر بعدی در یک خط جدید آغاز خواهد شد. اگر می‌خواهید مطمئن شوید که خطوط شکسته نمی‌شوند، `width` را روی 0 تنظیم کنید.
max_user_text integer_number: حداکثر اندازه بافر متن کاربر بر حسب بایت، یعنی متن درون بخش conky.text در فایل پیکربندی.

پیش‌فرض: 16384

maximum_width integer_number: حداکثر عرض پنجره.
minimum_height integer_number: حداقل ارتفاع پنجره.
minimum_width integer_number: حداقل عرض پنجره.
mpd_host: میزبان سرور MPD.
mpd_password: گذرواژه سرور MPD.
mpd_port: پورت سرور MPD.
music_player_interval: بازه زمانی به‌روزرسانی رشته (thread) پخش‌کننده موسیقی.

پیش‌فرض: update interval

mysql_db: پایگاه‌داده MySQL برای استفاده.

پیش‌فرض: mysql

mysql_host: میزبان سرور MySQL.

پیش‌فرض: localhost

mysql_password: گذرواژه کاربر MySQL. آن را بین کاراکترهای " قرار دهید. در صورتی که تنظیم نشود، هیچ گذرواژه‌ای استفاده نخواهد شد.
mysql_port: پورت سرور MySQL.
mysql_user: نام کاربری MySQL برای استفاده هنگام اتصال به سرور. به طور پیش‌فرض نام کاربری شما خواهد بود.
net_avg_samples: تعداد نمونه‌ها برای میانگین‌گیری داده‌های شبکه.
no_buffers: کسر بافرهای (سیستم‌فایل) از حافظه مصرفی.
nvidia_display: نمایشگری که متغیر nvidia از آن استفاده خواهد کرد.

پیش‌فرض: $DISPLAY

out_to_console: چاپ متن در خروجی استاندارد (stdout).
out_to_http: به conky اجازه می‌دهد به عنوان یک سرور کوچک http عمل کرده و متن خود را ارائه دهد.
out_to_ncurses: چاپ متن در کنسول، اما با استفاده از ncurses تا conky بتواند متن به‌روزرسانی جدید را روی متن قبلی چاپ کند. (در آینده قابلیت‌های مفیدتری را فراهم خواهد کرد).
out_to_stderr: چاپ متن در خطای استاندارد (stderr).
out_to_wayland: باز کردن یک پنجره Wayland برای نمایش خروجی.
out_to_x: هنگامی که روی no تنظیم شود، هیچ خروجی‌ای در سامانه پنجره X وجود نخواهد داشت (هنگامی مفید است که از مواردی مانند out_to_console نیز استفاده می‌کنید). اگر آن را روی no تنظیم می‌کنید، مطمئن شوید که پیش از تمام تنظیمات مرتبط با X قرار گرفته باشد (برای اطمینان، آن را در اولین خط فایل پیکربندی خود قرار دهید).

پیش‌فرض: True

override_utf8_locale: اجبار به استفاده از UTF8. به XFT نیاز دارد.
overwrite_file: بازنویسی فایلی که به عنوان آرگومان داده شده است.
own_window: مقدار بولی؛ رسم conky در پنجره اختصاصی خود به جای رسم روی پنجره ریشه (root window).
own_window_class: تنظیم دستی نام WM_CLASS.

پیش‌فرض: Conky

own_window_colour color: تنظیم رنگ پس‌زمینه پنجره. یک مقدار هگزادسیمال همراه با آلفای اختیاری می‌پذیرد (مانند '#fff'، '#8000'، '#8fff')، یا یک نام معتبر RGB (مشاهده کنید: /usr/lib/X11/rgb.txt).

کانال آلفا میزان کدر بودن پس‌زمینه را کنترل می‌کند. به عنوان مثال، '#0000' کاملاً شفاف و '#f000' سیاه کاملاً کدر است. پس‌زمینه‌های نیمه‌شفاف در X11 به یک کامپوزیتور نیاز دارند.

پیش‌فرض: black

own_window_hints hint(,hint)*: اگر own_window تنظیم شده باشد، در X11 می‌توانید راهنماهای مدیر پنجره (hints) را که با کاما از هم جدا شده‌اند مشخص کنید تا بر نحوه نمایش Conky تأثیر بگذارند.

موارد زیر برخی از نشانه‌های استاندارد مشخصات مدیر پنجره هستند:

above نشان می‌دهد که conky باید بالاتر از اکثر پنجره‌ها قرار گیرد.
below نشان می‌دهد که conky باید پایین‌تر از اکثر پنجره‌ها قرار گیرد.
skip_pager نشان می‌دهد که conky نباید در پیجر (Pager) گنجانده شود. به طور ضمنی اعمال می‌شود اگر own_window_type برابر `dock` یا `panel` باشد.
skip_taskbar نشان می‌دهد که conky نباید در نوار وظیفه (taskbar) گنجانده شود. به طور ضمنی اعمال می‌شود اگر own_window_type برابر `dock` یا `panel` باشد.
sticky نشان می‌دهد که مدیر پنجره باید موقعیت conky را بر روی صفحه نمایش ثابت نگه دارد، حتی زمانی که دسکتاپ مجازی پیمایش می‌شود.
undecorated نشان می‌دهد که conky نباید هیچ تزیینات پنجره‌ای (مانند نوار عنوان) داشته باشد. به طور ضمنی اعمال می‌شود اگر own_window_type برابر `dock` یا `panel` باشد. نکات:
از تنظیم own_window_type='desktop' به عنوان روشی دیگر برای اعمال ضمنی بسیاری از این راهنماها استفاده کنید.
اگر از own_window_type='override' استفاده کنید، راهنماهای مدیر پنجره هیچ معنایی نخواهند داشت و نادیده گرفته می‌شوند.

own_window_title: امکان تغییر و بازنویسی نام پنجره conky را فراهم می‌کند.

پیش‌فرض: conky ()

own_window_type (normal|desktop|dock|panel|utility|override): نوع پنجره‌ای را که conky به صورت آن نمایش داده می‌شود مشخص می‌کند. در X11 این مورد نیازمند تنظیم own_window است؛ در Wayland لایه wlr-layer-shell را که سطح روی آن سوار می‌شود انتخاب می‌کند (و برای dock/panel، اینکه آیا فضای صفحه نمایش را از طریق یک ناحیه انحصاری رزرو کند یا خیر). انواع موجود:

حالت normal باعث می‌شود conky به عنوان یک پنجره معمولی نمایش داده شود. این حالت می‌تواند با استفاده از تنظیم own_window_hints پیکربندی شود.
پنجره‌های desktop پنجره‌های ویژه‌ای هستند که هیچ تزیینات پنجره‌ای ندارند، همیشه روی میزکار قابل مشاهده هستند، در پیجر یا نوار وظیفه ظاهر نمی‌شوند و در تمام فضاهای کاری چسبنده هستند. بسیاری از محیط‌های رومیزی شامل پنجره‌های desktop برای پس‌زمینه، آیکون‌ها و منوی میزکار هستند، در این موارد شاید بهتر باشد از normal یا یکی از گزینه‌های زیر استفاده کنید، زیرا با کلیک روی آنها ممکن است روی conky را بپوشانند.
پنجره‌های dock روی لبه‌های صفحه نمایش قرار می‌گیرند. آن‌ها از اکثر جهات مشابه desktop هستند، اما بالاتر از پنجره‌های desktop و پایین‌تر از پنجره‌های normal رسم می‌شوند. برنامه Conky حاشیه‌های رزرو (struts) برای این نوع پنجره تعریف نمی‌کند، اما برخی از مدیران پنجره ممکن است همچنان به طور ضمنی از قرار دادن پنجره‌ها روی آن خودداری کنند.
پنجره‌های panel مشابه پنجره‌های dock هستند، اما علاوه بر آن، فضایی را نیز در امتداد لبه محیط کاری (مانند نوارهای وظیفه) رزرو می‌کنند و مانع از هم‌پوشانی پنجره‌های تمام‌صفحه با آنها می‌شوند. لبه بر اساس موقعیت و اندازه نهایی conky و ابعاد محیط کاری انتخاب می‌شود تا اطمینان حاصل شود که پنجره‌های معمولی بیشترین فضای آزاد را در دسترس دارند. برای مدیران پنجره‌ای که صفحه‌های کاملاً پوشانده‌شده را از ناحیه رزروشده جدا می‌کنند، لبه بر اساس تنظیم alignment انتخاب خواهد شد. در Wayland لبه رزروشده همواره از alignment مشتق می‌شود؛ تراز کاملاً مرکزی (mm) هیچ لبه‌ای برای رزرو ندارد، بنابراین از مقداری تراز شده با لبه استفاده کنید (مانند tm، bm، ml، mr).
پنجره‌های utility پنجره‌های کاربردی ماندگار هستند (مانند جعبه‌ابزار یا پالت). آن‌ها بالاتر از سایر پنجره‌ها (در همان گروه) ظاهر می‌شوند، اما در غیر این صورت رفتاری بسیار شبیه به پنجره‌های normal دارند.
پنجره‌های override مستقیماً روی پنجره ریشه (پس‌زمینه میزکار) کشیده می‌شوند و تحت کنترل مدیر پنجره نیستند. این پنجره‌ها در محیط‌های رومیزی که آیکون‌های دسکتاپ را از طریق پنل‌ها یا پنجره‌های سفارشی رسم می‌کنند کار نمی‌کنند، زیرا آن‌ها روی conky را می‌پوشانند. گزینه‌های own_window_hints برای پنجره‌های override نادیده گرفته می‌شوند. پس‌زمینه‌های نیمه‌شفاف با پنجره‌های override کار نمی‌کنند، زیرا کامپوزیتورها معمولاً پنجره‌های override-redirect را ترکیب نمی‌کنند. شفافیت کامل (آلفای 0) ممکن است از طریق شبه‌شفافیت (pseudo-transparency) کار کند.

برای سوار کردن conky روی پنجره ریشه، own_window را روی false تنظیم نمایید.

پیش‌فرض: normal

pad_percents: تکمیل درصدها تا این تعداد رقم اعشار (0 = بدون اعشار).
pop3 host user pass [`-i interval (in seconds)'] [`-p port'] [“-e `command'”] [`-r retries']: سرور پیش‌فرض سراسری POP3. آرگومان‌ها عبارتند از: host user pass [-i interval (in seconds)] [-p port] [-e 'command'] [-r retries]. پورت پیش‌فرض 110، بازه زمانی پیش‌فرض 5 دقیقه، و تعداد پیش‌فرض تلاش مجدد قبل از انصراف 5 است. اگر گذرواژه به صورت ’*’ وارد شود، هنگام شروع Conky از شما خواسته می‌شود گذرواژه را وارد کنید.
short_units: واحدها را به یک کاراکتر کوتاه می‌کند (مانند kiB->k، GiB->G و غیره).
show_graph_range: محدوده زمانی پوشش داده شده توسط نمودار را نشان می‌دهد.
show_graph_scale: حداکثر مقدار را در نمودارهای مقیاس‌بندی‌شده نشان می‌دهد.
stippled_borders: نقطه‌چین یا خط‌چین بودن حاشیه بر حسب پیکسل.
temperature_unit: واحد خروجی مورد نظر برای تمام اشیایی که دما را نمایش می‌دهند. پارامترها یا fahrenheit یا celsius هستند.

پیش‌فرض: celsius

templateN: تعریف یک الگو برای استفاده بعدی در بخش‌های conky.text. مقدار N را با رقمی بین 0 تا 9 (شامل هر دو) جایگزین کنید. مقدار این متغیر درون محتویات داخل conky.text در موقعیت مربوطه درج می‌شود، اما قبل از اینکه برخی جایگزینی‌ها اعمال شوند:

\\n -> خط جدید (newline)
\\ -> بک‌اسلش (backslash)
\\ -> فاصله (space)
\\N -> آرگومان N الگو (شروع از 1)

text_buffer_size integer_number: اندازه بافر استاندارد متن بر حسب بایت. این بافر برای متن‌های واسط مانند خطوط جداگانه، خروجی متغیرهای $exec و متغیرهای مختلف دیگر استفاده می‌شود. افزایش اندازه این بافر می‌تواند عملکرد Conky را به شدت کاهش دهد، اما امکان نمایش متن بیشتری را برای هر متغیر فراهم می‌کند. اندازه این بافر نمی‌تواند از مقدار پیش‌فرض 256 بایت کوچکتر باشد.

پیش‌فرض: 256

times_in_seconds: در صورت تنظیم روی true، متغیرهایی که زمان را در خروجی می‌آورند عددی را نشان می‌دهند که نمایانگر ثانیه است. این گزینه بر متغیرهای $time، $tztime و $utime تأثیری ندارد.
top_cpu_separate: در صورت تنظیم روی true، مقدار cpu در دستور top میزان مصرف توان یک پردازنده را نشان می‌دهد. در صورت تنظیم روی false، مقدار cpu در top مجموع مصرف توان تمام پردازنده‌ها را با هم نشان می‌دهد.
top_name_verbose: در صورت تنظیم روی true، مقدار top name کل خط فرمان هر پردازش را شامل آرگومان‌ها (در صورت امکان) نشان می‌دهد. در غیر این صورت، تنها نام پایه (basename) نمایش داده می‌شود.

پیش‌فرض: false

top_name_width: عرض مقدار $top name بر حسب کاراکتر.

پیش‌فرض: 15

total_run_times: تعداد کل دفعاتی که Conky قبل از خروج به‌روزرسانی می‌شود. مقدار صفر باعث می‌شود Conky برای همیشه اجرا شود.
units_spacer: رشته‌ای که باید بین مقادیر و واحدها قرار گیرد.

پیش‌فرض: ’’ (رشته خالی)

update_interval seconds: بازه زمانی به‌روزرسانی.
update_interval_on_battery seconds: بازه زمانی به‌روزرسانی هنگام کار با توان باتری.
uppercase: مقدار بولی؛ در صورت تنظیم روی true، متن با حروف بزرگ نمایش داده می‌شود.
use_spacer: افزودن فاصله در اطراف اشیای خاص برای جلوگیری از جابجا کردن سایر موارد توسط آن‌ها. می‌تواند none (پیش‌فرض)، left یا right باشد. مقادیر قدیمی true/false منسوخ شده‌اند و به ترتیب به صورت پیش‌فرض به right/none تبدیل می‌شوند. توجه داشته باشید که این گزینه فقط در صورتی کمک می‌کند که از قلم دارای عرض ثابت (مانند Bitstream Vera Sans Mono) استفاده کنید.

پیش‌فرض: none

use_xft: استفاده از Xft (قلم‌های دارای هموارسازی خطوط یا anti-aliased و امکانات مرتبط).
xftalpha: کانال آلفای قلم Xft. باید مقداری بین 0 و 1 یا برابر با آن‌ها باشد.
xinerama_head: مشخص کردن نمایشگر (head) در Xinerama.

اشیای سیستمی و متغیرها (OBJECTS/VARIABLES)

برای پیکربندی مواردی که Conky نمایش می‌دهد، باید متغیرهایی را در بخش conky.text از پیکربندی خود تعیین کنید. در این بخش فهرستی از متغیرهای موجود ارائه شده است. ممکن است کارکرد برخی از آن‌ها مستلزم فعال بودن گزینه‌های ساخت در زمان کامپایل باشد.

رنگ‌ها با استفاده از XParseColor() پردازش می‌شوند. فهرستی از رنگ‌های نام‌گذاری‌شده ممکن است در /usr/share/X11/rgb.txt موجود باشد. همچنین می‌توان رنگ‌ها را در قالب هگزادسیمال #rrggbb مشخص کرد.

برخی از اشیا ممکن است ریسه‌هایی (threads) ایجاد کنند، و گاهی اوقات این ریسه‌ها تا زمان پایان کار Conky از بین نمی‌روند. هیچ راهی برای بستن یا پاکسازی ریسه‌ها در زمان اجرای Conky وجود ندارد. به‌عنوان مثال، اگر از متغیر MPD استفاده کنید، ریسهٔ مربوط به MPD تا زمان خروج Conky به اجرای خود ادامه خواهد داد. برخی اشیای چندریسمانی از یکی از پارامترها به‌عنوان یک key (کلید) استفاده می‌کنند تا فقط یک ریسهٔ مرتبط در حال اجرا باشد (برای نمونه، اشیای $curl و $rss برای هر URI یک ریسه اجرا می‌کنند).

آرگومان‌های اختیاری معمولاً با پرانتز مشخص می‌شوند، به‌عنوان مثال (optional).

acpiacadapter (adapter): وضعیت آداپتور برق متناوب (AC) در ACPI. در لینوکس، گزینه adapter زیرپوشه‌ای از /sys/class/power_supply را مشخص می‌کند که حاوی اطلاعات وضعیت است. اگر آرگومانی داده نشود، مقادیر AC و ADP1 را امتحان می‌کند. سیستم‌های غیرلینوکسی آن را نادیده می‌گیرند.
acpifan: وضعیت فن ACPI.
acpitemp: دمای ACPI به درجه سلسیوس (سانتی‌گراد).
addr (interface): آدرس IP برای یک رابط شبکه، یا عبارت “No Address” در صورتی که هیچ آدرسی تخصیص نیافته باشد.
addrs (interface): آدرس‌های IP برای یک رابط شبکه (اگر فقط یکی باشد، مانند addr عمل می‌کند). تنها در لینوکس.
adt746xcpu: دمای پردازنده (CPU) از ماژول therm_adt746x.
adt746xfan: سرعت فن از ماژول therm_adt746x.
alignc (num): تراز کردن متن در مرکز (وسط‌چین).
alignr (num): راست‌چین کردن متن، با فاصله N.
apcupsd host port: برقراری اتصال با دیمن apcupsd. چیزی چاپ نمی‌کند.

پیش‌فرض: localhost:3551

apcupsd_cable: نوع اتصال UPS را چاپ می‌کند.
apcupsd_charge: ظرفیت فعلی باتری بر حسب درصد.
apcupsd_lastxfer: علت آخرین انتقال از برق شبکه به باتری.
apcupsd_linev: ولتاژ اسمی ورودی.
apcupsd_load: بار فعلی بر حسب درصد.
apcupsd_loadbar: نواری که بار فعلی را نمایش می‌دهد.
apcupsd_loadgauge (height),(width): نشانگری (گیج) که بار فعلی را نمایش می‌دهد.
apcupsd_loadgraph (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value): نمودار تاریخچهٔ بار فعلی.
apcupsd_model: مدل UPS را چاپ می‌کند.
apcupsd_name: نام تعریف‌شده توسط کاربر برای UPS را چاپ می‌کند.
apcupsd_status: وضعیت فعلی را چاپ می‌کند (on-line، on-battery).
apcupsd_temp: دمای داخلی فعلی.
apcupsd_timeleft: زمان باقی‌مانده برای کارکرد با باتری.
apcupsd_upsmode: حالت کاری UPS را چاپ می‌کند (مثلاً standalone).
apm_adapter: نمایش وضعیت آداپتور برق متناوب در APM. تنها در FreeBSD و OpenBSD.
apm_battery_life: نمایش درصد شارژ باقی‌مانده باتری در APM. تنها در FreeBSD و OpenBSD.
apm_battery_time: نمایش زمان باقی‌مانده باتری در APM به صورت hh:mm:ss یا “unknown” در صورتی که آداپتور برق متصل (online) یا در حال شارژ باشد. تنها در FreeBSD و OpenBSD.
audacious_bar (height),(width): نوار پیشرفت.
audacious_bitrate: بیت‌ریت (نرخ بیت) قطعهٔ فعلی.
audacious_channels: تعداد کانال‌های صوتی قطعهٔ فعلی.
audacious_filename: مسیر کامل و نام فایل قطعهٔ فعلی.
audacious_frequency: فرکانس نمونه‌برداری قطعهٔ فعلی.
audacious_length: مدت زمان کل قطعهٔ فعلی به صورت MM:SS.
audacious_length_seconds: مدت زمان کل قطعهٔ فعلی بر حسب ثانیه.
audacious_main_volume: میزان صدای فعلی گزارش‌شده توسط Audacious.
audacious_playlist_length: تعداد آهنگ‌ها در فهرست پخش (playlist).
audacious_playlist_position: موقعیت قطعهٔ فعلی در فهرست پخش.
audacious_position: موقعیت زمانی قطعهٔ فعلی (MM:SS).
audacious_position_seconds: موقعیت زمانی قطعهٔ فعلی بر حسب ثانیه.
audacious_status: وضعیت پخش‌کننده (Playing/Paused/Stopped/Not running).
audacious_title (max length): عنوان قطعهٔ فعلی به همراه تعیین اختیاری حداکثر طول رشته.
battery (num): وضعیت باتری و درصد ظرفیت باقی‌مانده برای باتری ACPI یا APM. شمارهٔ باتری ACPI می‌تواند به عنوان یک آرگومان مشخص شود.

پیش‌فرض: BAT0

battery_bar (height),(width) (num): درصد باقی‌مانده باتری ACPI در قالب یک نوار. شمارهٔ باتری ACPI می‌تواند به عنوان آرگومان داده شود (از all برای دریافت میانگین درصد باقی‌مانده تمام باتری‌ها استفاده کنید).

پیش‌فرض: BAT0

battery_percent (num): درصد باقی‌مانده برای باتری ACPI. شمارهٔ باتری ACPI می‌تواند به عنوان آرگومان داده شود (از all برای دریافت میانگین درصد باقی‌مانده تمام باتری‌ها استفاده کنید).

پیش‌فرض: BAT0

battery_power_draw (num): توان مصرفی باتری بر حسب وات.

پیش‌فرض: BAT0

battery_short (num): وضعیت باتری و درصد ظرفیت باقی‌مانده برای باتری ACPI یا APM. شمارهٔ باتری ACPI می‌تواند به عنوان آرگومان داده شود. این حالت یک وضعیت کوتاه نمایش می‌دهد: C برای در حال شارژ (charging)، D برای در حال تخلیه (discharging)، F برای پر (full)، N برای وجود نداشتن (not present)، E برای خالی (empty)، و U برای نامشخص (unknown).

پیش‌فرض: BAT0

battery_status (num): وضعیت باتری برای یک باتری ACPI. شمارهٔ باتری ACPI می‌تواند به عنوان آرگومان داده شود.

پیش‌فرض: BAT0

battery_time (num): زمان باقی‌مانده شارژ یا تخلیه باتری ACPI. شمارهٔ باتری ACPI می‌تواند به عنوان آرگومان داده شود.

پیش‌فرض: BAT0

blink text_and_other_conky_vars: چشمک زدن متن و متغیرهای مشخص‌شده (خاموش و روشن شدن `text_and_other_conky_vars`).
buffers: میزان حافظهٔ اختصاص‌یافته به بافرها (buffered).
cached: میزان حافظهٔ اختصاص‌یافته به کَش (cached).
cat file: یک فایل را می‌خواند و محتویات آن را در Conky نمایش می‌دهد. این ویژگی زمانی کاربرد دارد که فرآیندی مستقل خروجی‌ای تولید می‌کند که می‌خواهید آن را در Conky نمایش دهید.
catp file: یک فایل را می‌خواند و محتویات آن را در Conky نمایش می‌دهد. این ویژگی زمانی کاربرد دارد که فرآیندی مستقل خروجی‌ای تولید می‌کند که می‌خواهید آن را در Conky نمایش دهید. تفاوت این دستور با $cat در این است که محتویات فایل را پردازش (parse) می‌کند، بنابراین می‌توانید مواردی مانند ${color red}hi!${color} را در فایل خود قرار دهید و Conky آن را به درستی تفسیر کند.
cmdline_to_pid string: شناسهٔ فرآیند (PID) اولین فرآیندی که خط فرمان آن شامل رشتهٔ داده‌شده باشد.
cmus_aaa: چاپ وضعیت aaa در پخش‌کننده cmus (حالت‌های all/artist/album).
cmus_album: نام آلبوم آهنگ فعلی cmus را چاپ می‌کند.
cmus_artist: نام هنرمند آهنگ فعلی cmus را چاپ می‌کند.
cmus_curtime: زمان فعلی سپری‌شده از آهنگ فعلی cmus.
cmus_date: تاریخ انتشار آهنگ فعلی cmus را چاپ می‌کند.
cmus_file: نام فایل آهنگ فعلی cmus را چاپ می‌کند.
cmus_genre: نام سبک (ژانر) آهنگ فعلی cmus را چاپ می‌کند.
cmus_percent: درصد پیشرفت آهنگ در حال پخش.
cmus_progress (height),(width): نوار پیشرفت پخش در cmus.
cmus_random: وضعیت پخش تصادفی (Random) در cmus (فعال/غیرفعال - on/off).
cmus_repeat: وضعیت تکرار (Repeat) در cmus (حالت‌های song/all/off).
cmus_state: وضعیت کنونی cmus (مانند playing، paused، stopped و غیره).
cmus_timeleft: زمان باقی‌مانده از آهنگ فعلی cmus.
cmus_title: عنوان آهنگ فعلی cmus را چاپ می‌کند.
cmus_totaltime: مدت زمان کل آهنگ فعلی cmus.
cmus_track: شماره قطعه (ترک) آهنگ فعلی cmus را چاپ می‌کند.
color (color): تغییر رنگ رسم به color که می‌تواند نام یک رنگ یا کد هگزادسیمال همراه با # باشد، مانند #0A1B2C. در صورت استفاده از ncurses فقط رنگ‌های زیر پشتیبانی می‌شوند: red، green، yellow، blue، magenta، cyan، black و white.
colorN: تغییر رنگ رسم به گزینهٔ پیکربندی colorN، که در آن N عددی بین 0 تا 9 (شامل هر دو) است.
combine var1 var2: خطوط var2 را در سمت راست خطوط var1 قرار می‌دهد که با نویسه‌های درج‌شده بین var1 و var2 از یکدیگر جدا می‌شوند. به‌عنوان مثال: ${combine ${head /proc/cpuinfo 2} - ${head /proc/meminfo 1}} در خط اول خروجی cpuinfo_line1 - meminfo_line1 و در خط دوم خروجی cpuinfo_line2 - را می‌دهد. متغیرهای $combine همچنین می‌توانند به‌صورت تودرتو استفاده شوند تا متغیرهای بیشتری در کنار یکدیگر قرار گیرند.
conky_build_arch: معماری پردازنده‌ای (CPU) که Conky برای آن ساخته شده است.
conky_version: نسخهٔ Conky.
cpu (cpuN): میزان استفاده از پردازنده (CPU) بر حسب درصد. برای سیستم‌های چندپردازنده‌ای (SMP)، شمارهٔ CPU می‌تواند به عنوان یک آرگومان داده شود. ${cpu cpu0} کل میزان مصرف، و ${cpu cpuX} (که در آن X >= 1) میزان مصرف تک‌تک هسته‌ها/پردازنده‌ها است.
cpubar (cpuN) (height),(width): نواری که میزان مصرف پردازنده را نشان می‌دهد؛ height ارتفاع نوار بر حسب پیکسل است. برای اطلاعات بیشتر در مورد SMP به $cpu مراجعه کنید.
cpugauge (cpuN) (height),(width): نشانگر بیضوی (گیج) که میزان مصرف پردازنده را نشان می‌دهد؛ height و width به ترتیب محورهای عمودی و افقی نشانگر هستند. برای اطلاعات بیشتر در مورد SMP به $cpu مراجعه کنید.
cpugovernor (cpuN): گاورنر فعال تنظیم فرکانس پردازنده (CPU scaling governor)، که به‌طور پیش‌فرض اولین هسته است. برای اطلاعات بیشتر در مورد SMP به $cpu مراجعه کنید. تنها در لینوکس.
cpugraph (cpuN) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value): نمودار مصرف پردازنده، با رنگ‌های اختیاری در قالب هگزادسیمال (بدون #). برای اطلاعات بیشتر در مورد SMP به $cpu مراجعه کنید. در صورت استفاده از سوییچ -l از مقیاس لگاریتمی (برای مشاهده اعداد کوچک) استفاده می‌کند. سوییچ `-t' یک گرادیان دمایی اعمال می‌کند که باعث می‌شود مقادیر گرادیان بسته به دامنهٔ یک مقدار خاص در نمودار تغییر کند (امتحان کنید تا ببینید). فلگ `-x' محور x و فلگ `-y' محور y نمودار را معکوس می‌کند. فلگ `-m' یک حد پایین/حداقل غیرصفر تعیین می‌کند، و تضمین می‌نماید که تمام مقادیر حداقل برابر با حداقل تعیین‌شده باشند (به‌جز صفر).
curl url (interval_in_minutes): دانلود داده‌ها از URI با استفاده از Curl در بازهٔ زمانی مشخص‌شده. بازهٔ زمانی می‌تواند یک عدد اعشاری مثبت باشد (0 نیز مجاز است)، در غیر این صورت مقدار پیش‌فرض 15 دقیقه است. بیشترین کاربرد آن در ترکیب با Lua و API زبان Lua است. این شیء چندریسمانی (threaded) است و پس از ایجاد ریسه، نمی‌توان آن را به‌طور صریح از بین برد. برای هر URI مشخص‌شده یک ریسه اجرا خواهد شد. می‌توانید از هر پروتکلی که Curl پشتیبانی می‌کند استفاده کنید.
desktop: شمارهٔ میزمحیطی (دسکتاپ) که Conky در آن اجرا می‌شود یا پیام “Not running in X” در صورتی که در سرور X اجرا نشده باشد.
desktop_name: نام دسکتاپی که Conky در آن اجرا می‌شود یا پیام “Not running in X” در صورتی که در سرور X اجرا نشده باشد.
desktop_number: تعداد کل دسکتاپ‌ها یا پیام “Not running in X” در صورتی که در سرور X اجرا نشده باشد.
disk_protect device: وضعیت محافظت از دیسک، در صورت پشتیبانی (نیازمند وصلهٔ کرنل است). عبارت “frozen” یا “free” را چاپ می‌کند (به فاصله‌های پرکننده توجه کنید).
diskio (device): نمایش ورودی/خروجی (IO) فعلی دیسک. آرگومان device اختیاری است و برای /dev/sda به شکل sda مشخص می‌شود. برچسب یک دستگاه بلوکی را می‌توان با label:foo و شناسه‌یکتای پارتیشن (partuuid) آن را می‌توان با partuuid:40000000-01 مشخص کرد.
diskio_read (device): نمایش ورودی/خروجی (IO) فعلی خواندن دیسک. آرگومان device همانند diskio است.
diskio_write (device): نمایش ورودی/خروجی (IO) فعلی نوشتن روی دیسک. آرگومان device همانند diskio است.
diskiograph (device) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value): نمودار ورودی/خروجی دیسک، رنگ‌ها در قالب هگزادسیمال (بدون #) تعریف می‌شوند. اگر scale غیرصفر باشد، به عنوان مقیاس نمودار در نظر گرفته می‌شود. در صورت استفاده از سوییچ -l از مقیاس لگاریتمی (برای مشاهده اعداد کوچک) استفاده می‌کند. سوییچ `-t' یک گرادیان دمایی اعمال می‌کند که باعث می‌شود مقادیر گرادیان بسته به دامنهٔ یک مقدار خاص در نمودار تغییر کند (امتحان کنید تا ببینید). فلگ `-x' محور x و فلگ `-y' محور y نمودار را معکوس می‌کند. فلگ `-m' یک حد پایین/حداقل غیرصفر تعیین می‌کند، و تضمین می‌نماید که تمام مقادیر حداقل برابر با حداقل تعیین‌شده باشند (به‌جز صفر).
diskiograph_read (device) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value): نمودار ورودی/خروجی (IO) دیسک برای خواندن، رنگ‌ها به صورت هگزادسیمال و بدون # تعریف می‌شوند.

1.: اگر مقیاس (scale) غیرصفر باشد، به عنوان مقیاس نمودار در نظر گرفته می‌شود. دستگاه (Device) همانند diskio است. هنگام استفاده از سوییچ -l از یک مقیاس لگاریتمی (برای مشاهده اعداد کوچک) استفاده می‌کند. سوییچ `-t' را برای استفاده از گرادیان حرارتی می‌پذیرد که باعث می‌شود مقادیر گرادیان بسته به دامنه مقدار خاصی در نمودار تغییر کنند (امتحان کنید تا ببینید). فلگ `-x' محور x و `-y' محور y نمودار را معکوس می‌کند. فلگ `-m' یک مقدار حداقل/کران پایین غیرصفر تعیین می‌کند و تضمین می‌نماید که تمام مقادیر حداقل برابر با حداقل مشخص‌شده باشند (به جز صفر).

diskiograph_write (device) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value): نمودار ورودی/خروجی (IO) دیسک برای نوشتن، رنگ‌ها به صورت هگزادسیمال و بدون # تعریف می‌شوند.

1.: اگر مقیاس (scale) غیرصفر باشد، به عنوان مقیاس نمودار در نظر گرفته می‌شود. دستگاه (Device) همانند diskio است. هنگام استفاده از سوییچ -l از یک مقیاس لگاریتمی (برای مشاهده اعداد کوچک) استفاده می‌کند. سوییچ `-t' را برای استفاده از گرادیان حرارتی می‌پذیرد که باعث می‌شود مقادیر گرادیان بسته به دامنه مقدار خاصی در نمودار تغییر کنند (امتحان کنید تا ببینید). فلگ `-x' محور x و `-y' محور y نمودار را معکوس می‌کند. فلگ `-m' یک مقدار حداقل/کران پایین غیرصفر تعیین می‌کند و تضمین می‌نماید که تمام مقادیر حداقل برابر با حداقل مشخص‌شده باشند (به جز صفر).

distribution: نام توزیع لینوکس. مقدار NAME از فایل /etc/os-release خوانده می‌شود و در صورت عدم موفقیت از محتوای /proc/version به عنوان پشتیبان استفاده می‌گردد. در صورتی که اطلاعات گزارش‌شده نادرست است، یک گزارش مشکل (issue) ثبت کنید.
downspeed (net): سرعت بارگیری در واحدهای استاندارد و مناسب IEC.
downspeedf (net): سرعت بارگیری بر حسب KiB با یک رقم اعشار.
downspeedgraph (netdev) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m): نمودار سرعت بارگیری، رنگ‌ها به صورت هگزادسیمال و بدون # تعریف می‌شوند. اگر مقیاس (scale) غیرصفر باشد، حداکثر مقدار نمودار را (بر حسب بایت بر ثانیه) مشخص می‌کند. هنگام استفاده از سوییچ -l از یک مقیاس لگاریتمی (برای مشاهده اعداد کوچک) استفاده می‌کند. سوییچ `-t' را برای استفاده از گرادیان حرارتی می‌پذیرد که باعث می‌شود مقادیر گرادیان بسته به دامنه مقدار خاصی در نمودار تغییر کنند (امتحان کنید تا ببینید). فلگ `-x' محور x و `-y' محور y نمودار را معکوس می‌کند. فلگ `-m' یک مقدار حداقل/کران پایین غیرصفر تعیین می‌کند و تضمین می‌نماید که تمام مقادیر حداقل برابر با حداقل مشخص‌شده باشند (به جز صفر).
draft_mails (maildir) (interval): تعداد ایمیل‌های علامت‌گذاری‌شده به عنوان پیش‌نویس (draft) در صندوق پستی مشخص‌شده یا در صورت مشخص نشدن، در صف ایمیل (mail spool). تنها صندوق‌های پستی از نوع maildir پشتیبانی می‌شوند؛ نوع mbox مقدار -1 را بازمی‌گرداند.
else: متنی که اگر هیچ‌یک از شرایط بالا برقرار نباشند نمایش داده می‌شود.
endif: پایان دادن به یک بلوک $if.
entropy_avail: انتروپی موجود و در دسترس فعلی برای خوره‌های رمزنگاری.
entropy_bar (height),(width): نوار نرمال‌شده انتروپی موجود برای خوره‌های رمزنگاری.
entropy_perc: درصد انتروپی موجود در مقایسه با اندازه مخزن انتروپی (poolsize).
entropy_poolsize: اندازه کل مخزن انتروپی سیستم برای خوره‌های رمزنگاری.
eval string: رشته داده‌شده را طبق قواعد تفسیر conky.text ارزیابی می‌کند؛ یعنی تجزیه مشخصات هر شیء متنی موجود به خروجی آن، تبدیل هر `$′intoasingle^′^' و غیره. سپس خروجی دوباره تجزیه می‌شود.
exec command: یک دستور پوسته را اجرا می‌کند و خروجی را در conky نمایش می‌دهد. هشدار: این متغیر نسبت به سایر متغیرها منابع بسیار بیشتری مصرف می‌کند. پیشنهاد می‌کنم رفتار مورد نظر را در C/C++ کدنویسی کرده و یک وصله (patch) ارسال کنید.
execbar (height),(width) command: همانند exec است، با این تفاوت که اگر اولین مقدار بازگردانده‌شده عددی بین 0-100 باشد، از آن عدد برای رسم یک نوار افقی استفاده می‌کند. پارامترهای ارتفاع (height) و عرض (width) اختیاری هستند و به ترتیب به گزینه‌های پیکربندی default_bar_height و default_bar_width پیش‌فرض می‌شوند.
execgauge (height),(width) command: همانند exec است، با این تفاوت که اگر اولین مقدار بازگردانده‌شده عددی بین 0-100 باشد، از آن عدد برای رسم یک درجه دایره‌ای (بسیار شبیه به سرعت‌سنج خودرو) استفاده می‌کند. پارامترهای ارتفاع و عرض اختیاری هستند و به ترتیب به گزینه‌های پیکربندی default_gauge_height و default_gauge_width پیش‌فرض می‌شوند.
execgraph command (height),(width) (gradient color 1) (gradient color 2) (scale) (-t) (-l) (-x) (-y) (-m value): یک نمودار پیمایش‌شونده افقی با مقادیر 0-100 که روی محور عمودی ترسیم شده‌اند، رسم می‌کند. تمامی پارامترهای پس از دستور اختیاری هستند. رنگ‌های گرادیان را می‌توان به صورت مقادیر هگزادسیمال بدون پیشوند 0x یا # مشخص کرد. از سوییچ -t برای فعال‌سازی گرادیان حرارتی استفاده کنید، تا مقادیر کوچک با رنگ 1 «سرد» (“cold”) و مقادیر بزرگ با رنگ 2 «گرم» (“hot”) باشند. بدون سوییچ -t، رنگ‌ها یک گرادیان افقی در امتداد عرض نمودار ایجاد می‌کنند. پارامتر مقیاس (scale) حداکثر مقدار نمودار را تعیین می‌کند. از سوییچ -l برای فعال‌سازی یک مقیاس لگاریتمی استفاده کنید که به مشاهده مقادیر کوچک کمک می‌کند. اندازه پیش‌فرض نمودارها را می‌توان از طریق تنظیمات پیکربندی default_graph_height و default_graph_width کنترل کرد. فلگ `-x' محور x و `-y' محور y نمودار را معکوس می‌کند. فلگ `-m' یک مقدار حداقل/کران پایین غیرصفر تعیین می‌کند و تضمین می‌نماید که تمام مقادیر حداقل برابر با حداقل مشخص‌شده باشند (به جز صفر).

اگر نیاز به اجرای دستوری با فاصله دارید، چند گزینه پیش رو دارید:

1.: دستور خود را در نقل‌قول دوگانه (double-quotes) قرار دهید، یا
2.: دستور خود را در یک فایل جداگانه مانند ~/bin/myscript.sh قرار داده و از آن به عنوان دستور execgraph استفاده کنید.

به یاد داشته باشید که اسکریپت خود را قابل اجرا کنید!

در مثال زیر، execgraph را به گونه‌ای تنظیم می‌کنیم که ثانیه‌ها (0-59) را روی نموداری با ارتفاع 50 پیکسل و عرض 200 پیکسل، با استفاده از گرادیان حرارتی با رنگ‌های متغیر از قرمز برای مقادیر کوچک (FF0000) تا زرد برای مقادیر بزرگ (FFFF00) نمایش دهد. ما مقیاس را روی 60 تنظیم می‌کنیم.

${execgraph ~/seconds.sh 50,200 FF0000 FFFF00 60 -t}

execi interval command: همانند exec است، اما با یک بازه زمانی مشخص بر حسب ثانیه. این بازه زمانی نمی‌تواند کمتر از مقدار update_interval در پیکربندی شما باشد. همچنین $texeci را ببینید.
execibar interval (height),(width) command: همانند execbar است، اما با یک بازه زمانی.
execigauge interval (height),(width) command: همانند execgauge است، اما با یک بازه زمانی.
execigraph interval command (height),(width) (gradient color 1) (gradient color 2) (scale) (-t) (-l) (-x) (-y) (-m value): همانند execgraph است، اما با یک بازه زمانی.
execp command: یک دستور پوسته را اجرا می‌کند و خروجی را در conky نمایش می‌دهد. هشدار: این متغیر نسبت به سایر متغیرها منابع بسیار بیشتری مصرف می‌کند. پیشنهاد می‌کنم رفتار مورد نظر را در C/C++ کدنویسی کرده و یک وصله ارسال کنید. تفاوت آن با $exec در این است که خروجی دستور را تجزیه می‌کند، بنابراین می‌توانید مواردی مانند `${color red}hi!${color}` را در اسکریپت خود وارد کنید تا به درستی توسط Conky تجزیه شوند. نکات مهم: Conky خروجی $execp را در هر بار اجرای حلقه Conky تجزیه و ارزیابی می‌کند، و سپس تمام اشیاء را نابود می‌سازد. اگر سعی کنید از مواردی مانند $execi درون عبارت $execp استفاده کنید، عملاً در همان بازه زمانی اجرای عبارت $execp اجرا خواهد شد، چرا که در هر بازه ایجاد شده و از بین می‌رود.
execpi interval command: همانند execp است، اما با یک بازه زمانی. توجه داشته باشید که خروجی دستور $execpi همچنان در هر بازه زمانی تجزیه و ارزیابی می‌شود.
flagged_mails (maildir) (interval): تعداد ایمیل‌های علامت‌گذاری‌شده به عنوان پرچم‌دار (flagged) در صندوق پستی مشخص‌شده یا در صورت مشخص نشدن، در صف ایمیل (mail spool). تنها صندوق‌های پستی از نوع maildir پشتیبانی می‌شوند؛ نوع mbox مقدار -1 را بازمی‌گرداند.
font (font): مشخص کردن یک قلم متفاوت. این قلم جدید بر خط جاری و تمام خطوط پس از آن اعمال خواهد شد. می‌توانید از $font بدون آرگومان برای بازگشت به قلم پیش‌فرض استفاده کنید (بسیار شبیه به $color).
fontN: تغییر قلم به گزینه پیکربندی fontN، که در آن N رقمی بین 0 و 9 (شامل هر دو) است.
format_time seconds format: قالب‌بندی زمان داده‌شده بر حسب ثانیه. این متغیر تنها زمانی کار می‌کند که تنظیم پیکربندی times_in_seconds فعال باشد. قالب رشته‌ای است که باید با نویسه نقل‌قول دوگانه " شروع و پایان یابد. نویسه‌های نقل‌قول بخشی از خروجی نیستند؛ ,,,(,) و \ با هفته‌ها، روزها، ساعت‌ها، دقیقه‌ها، ثانیه‌ها، (، ) و جایگزین می‌شوند. اگر واحدی را حذف کنید، مقدار آن در بزرگ‌ترین واحد پایین‌تر از واحد حذف‌شده بیان می‌شود. متن بین نویسه‌های ()- در صورتی که واحد جایگزین‌شده در این متن 0 باشد، قابل مشاهده نخواهد بود. اگر ثانیه‌ها یک عدد اعشاری باشند، می‌توانید با استفاده از نویسه به همراه عددی که تعداد ارقام اعشار مورد نظر را مشخص می‌کند (حداکثر 9)، ارقام اعشار را مشاهده کنید. همچنین می‌توانید یک `x' در ادامه قرار دهید تا تمام ارقام بعد از اعشار بدون صفر’sهای پایانی نمایش داده شوند (همچنین حداکثر 9).
forwarded_mails (maildir) (interval): تعداد ایمیل‌های علامت‌گذاری‌شده به عنوان فورواردشده در صندوق پستی مشخص‌شده یا در صورت مشخص نشدن، در صف ایمیل (mail spool). تنها صندوق‌های پستی از نوع maildir پشتیبانی می‌شوند؛ نوع mbox مقدار -1 را بازمی‌گرداند.
free_bufcache: میزان حافظه بافرشده یا کَش‌شده، طبق گزارش دستور free. فقط لینوکس.
free_cached: میزان حافظه کَش‌شده، طبق گزارش دستور free. فقط لینوکس.
freq (n): فرکانس پردازنده شماره n را بر حسب مگاهرتز بازمی‌گرداند. شمارش پردازنده‌ها از 1 شروع می‌شود.

پیش‌فرض: 1

freq2 (n): سرعت کلاک پردازنده شماره n را از کد اسمبلی بر حسب مگاهرتز بازمی‌گرداند. شمارش پردازنده‌ها از 1 شروع می‌شود.

پیش‌فرض: 1

freq_g (n): فرکانس پردازنده شماره n را بر حسب گیگاهرتز بازمی‌گرداند. شمارش پردازنده‌ها از 1 شروع می‌شود.

پیش‌فرض: 1

fs_bar (height),(width) fs: نواری که نشان می‌دهد چه مقدار فضا در یک سیستم فایل استفاده شده است. height ارتفاع بر حسب پیکسل است. fs هر فایلی بر روی آن سیستم فایل است.
fs_bar_free (height),(width) fs: نواری که نشان می‌دهد چه مقدار فضا در یک سیستم فایل آزاد است. height ارتفاع بر حسب پیکسل است. fs هر فایلی بر روی آن سیستم فایل است.
fs_free (fs): فضای آزاد در یک سیستم فایل که در دسترس کاربران است.
fs_free_perc (fs): درصد فضای آزاد در یک سیستم فایل که در دسترس کاربران است.
fs_size (fs): اندازه سیستم فایل.
fs_type (fs): نوع سیستم فایل.
fs_used (fs): فضای استفاده‌شده سیستم فایل.
fs_used_perc (fs): درصد فضای استفاده‌شده سیستم فایل.
gid_name gid: نام گروه دارای این gid.
github_notifications: تعداد اعلان‌های گیت‌هاب (GitHub).
goto x: عنصر بعدی در موقعیت `x' چاپ خواهد شد.
gw_iface: رابط مسیر پیش‌فرض یا بر این اساس “multiple”/“none” را نمایش می‌دهد.
gw_ip: نشانی IP درگاه پیش‌فرض یا بر این اساس “multiple”/“none” را نمایش می‌دهد.
hddtemp (dev): دمای دیسک سخت انتخاب‌شده را طبق گزارش دیمن hddtemp نمایش می‌دهد. از hddtemp_host و hddtemp_port برای مشخص کردن میزبان و پورت برای تمامی اشیاء hddtemp استفاده کنید. اگر پارامتر dev داده نشود، اولین دیسک بازگردانده‌شده توسط دیمن hddtemp استفاده خواهد شد.
head logfile lines (next_check): تعداد N خط اول فایل متنی ارائه‌شده را نمایش می‌دهد. فایل در هر به‌روزرسانی `next_check' بررسی می‌شود. اگر next_check ارائه نشود، Conky به طور پیش‌فرض از 2 استفاده می‌کند. حداکثر 30 خط را می‌توان نمایش داد، یا تا زمانی که بافر متنی پر شود.
hr (height) (width): خط افقی، height ارتفاع بر حسب پیکسل است. از width می‌توان برای تنظیم عرض خط افقی بر حسب پیکسل استفاده کرد.
hwmon (dev) type n (factor offset): حسگر Hwmon از sysfs (لینوکس 2.6). پارامتر dev می‌تواند یکی از موارد زیر باشد:

1.: عدد. برای مثال 1 به معنی hwmon1 است.
2.: نام ماژول. برای مثال k10temp به معنی اولین دستگاه hwmon است که نام ماژول آن k10temp باشد.
3.: حذف شود. در این صورت از اولین دستگاه hwmon یعنی (hwmon0) استفاده خواهد شد.

پارامتر type یا in است یا vol به معنی ولتاژ؛ fan به معنی فن؛ temp به معنی دما. پارامتر n شماره حسگر است. مسیر /sys/class/hwmon/ را روی رایانه محلی خود ببینید. آرگومان‌های اختیاری factor و offset امکان محاسبه پیشاپیش ورودی خام را فراهم می‌کنند که به شکل زیر تغییر می‌یابد: input = input * factor + offset. توجه داشته باشید که آن‌ها باید به صورت مقادیر اعشاری داده شوند (یعنی حداقل دارای یک رقم اعشار باشند).

hwmonbar (height),(width) (dev) type n (factor offset): همانند hwmon است، اما مقدار خوانده‌شده حسگر را به صورت یک نوار افقی نمایش می‌دهد. از factor و offset برای تغییر مقیاس مقدار گزارش‌شده توسط hwmon به محدوده 0-100 استفاده کنید. مقادیر دما از قبل از میلی‌درجه تبدیل شده‌اند. ارتفاع و عرض به ترتیب به صورت پیش‌فرض برابر با default_bar_height و default_bar_width هستند.
i2c (dev) type n (factor offset): حسگر I2C از sysfs (لینوکس 2.6). اگر فقط یک دستگاه I2C دارید، پارامتر dev می‌تواند حذف شود. پارامتر type یا in است یا vol به معنی ولتاژ؛ fan به معنی فن؛ temp به معنی دما. پارامتر n شماره حسگر است. مسیر /sys/bus/i2c/devices/ را روی رایانه محلی خود ببینید. آرگومان‌های اختیاری factor و offset امکان محاسبه پیشاپیش ورودی خام را فراهم می‌کنند که به شکل زیر تغییر می‌یابد: input = input * factor + offset. توجه داشته باشید که آن‌ها باید به صورت مقادیر اعشاری داده شوند (یعنی حداقل دارای یک رقم اعشار باشند).
i2cbar (height),(width) (dev) type n (factor offset): همانند i2c است، اما مقدار خوانده‌شده حسگر را به صورت یک نوار افقی نمایش می‌دهد. از factor و offset برای تغییر مقیاس مقدار گزارش‌شده توسط i2c به محدوده 0-100 استفاده کنید. مقادیر دما از قبل از میلی‌درجه تبدیل شده‌اند. ارتفاع و عرض به ترتیب به صورت پیش‌فرض برابر با default_bar_height و default_bar_width هستند.
i8k_ac_status: در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، وضعیت متصل بودن برق متناوب (AC) را مطابق با /proc/i8k (ترجمه‌شده به حالت خوانا برای انسان) نمایش می‌دهد. توجه داشته باشید که این ویژگی به صورت پیش‌فرض توسط خود i8k فعال نیست.
i8k_bios: در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، نسخه بایوس (BIOS) را مطابق با /proc/i8k نمایش می‌دهد.
i8k_buttons_status: در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، وضعیت دکمه‌های میزان صدا را مطابق با /proc/i8k نمایش می‌دهد.
i8k_cpu_temp: در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، دمای پردازنده را بر حسب سلسیوس، طبق گزارش /proc/i8k نمایش می‌دهد.
i8k_left_fan_rpm: در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، سرعت چرخش فن چپ را بر حسب دور بر دقیقه (RPM) مطابق با /proc/i8k نمایش می‌دهد. توجه داشته باشید که در برخی لپ‌تاپ‌ها، i8k این فن‌ها را با ترتیب معکوس گزارش می‌کند.
i8k_left_fan_status: در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، وضعیت فن چپ را مطابق با /proc/i8k (ترجمه‌شده به حالت خوانا برای انسان) نمایش می‌دهد. توجه داشته باشید که در برخی لپ‌تاپ‌ها، i8k این فن‌ها را با ترتیب معکوس گزارش می‌کند.
i8k_right_fan_rpm: در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، سرعت چرخش فن راست را بر حسب دور بر دقیقه (RPM) مطابق با /proc/i8k نمایش می‌دهد. توجه داشته باشید که در برخی لپ‌تاپ‌ها، i8k این فن‌ها را با ترتیب معکوس گزارش می‌کند.
i8k_right_fan_status: در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، وضعیت فن راست را مطابق با /proc/i8k (ترجمه‌شده به حالت خوانا برای انسان) نمایش می‌دهد. توجه داشته باشید که در برخی لپ‌تاپ‌ها، i8k این فن‌ها را با ترتیب معکوس گزارش می‌کند.
i8k_serial: در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، شماره سریال لپ‌تاپ شما را مطابق با /proc/i8k نمایش می‌دهد.
i8k_version: در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، قالب‌بندی نسخه /proc/i8k را نمایش می‌دهد.
ibm_brightness: در صورت اجرای IBM ACPI، میزان روشنایی صفحه‌نمایش LCD لپ‌تاپ را نمایش می‌دهد (0-7).
ibm_fan: در صورت اجرای IBM ACPI، سرعت فن را نمایش می‌دهد.
ibm_temps N: در صورت اجرای IBM ACPI، دماها را از حسگرهای دمای IBM نمایش می‌دهد (N=0..7). حسگر 0 روی CPU و حسگر 3 روی GPU قرار دارد.
ibm_thinklight: در صورت اجرای IBM ACPI، وضعیت ThinkLight™ شما را نمایش می‌دهد. مقدار آن یکی از موارد `on'، `off' یا `unknown' است.
ibm_volume: در صورت اجرای IBM ACPI، میزان صدای اصلی (“master”) را که توسط کلیدهای میزان صدا کنترل می‌شود نمایش می‌دهد (0-14).
ical number file: عنوان رویداد شماره `number' را در فایل ical (RFC 5545) با نام `file' نمایش می‌دهد. رویدادها ابتدا بر اساس زمان شروع مرتب می‌شوند؛ رویدادهایی که در گذشته آغاز شده‌اند نادیده گرفته می‌شوند. رویدادهایی که نمایش داده می‌شوند VEVENTها هستند، عنوانی که نشان داده می‌شود SUMMARY است و زمان شروع استفاده‌شده برای مرتب‌سازی DTSTART می‌باشد.
iconv_start codeset_from codeset_to: تبدیل متن از یک مجموعه‌کد به مجموعه‌کد دیگر با استفاده از GNU iconv. باید با iconv_stop متوقف شود.
iconv_stop: توقف تبدیل مجموعه نویسه (codeset) توسط iconv.
if_empty (var): اگر متغیرِ کانکی VAR خالی باشد، تمام موارد بین $if_empty و $endif متناظر نمایش داده می‌شود.
if_existing file (string): اگر FILE وجود داشته باشد، تمام موارد بین if_existing و $endif متناظر نمایش داده می‌شود. پارامتر اختیاری دوم وجود رشته مشخص‌شده در FILE را بررسی کرده و تمام موارد بین $if_existing و $endif متناظر را چاپ می‌کند.
if_gw: اگر حداقل یک درگاه پیش‌فرض (default gateway) وجود داشته باشد، تمام موارد بین $if_gw و $endif متناظر نمایش داده می‌شود.
if_match expression: عبارت بولی داده‌شده را ارزیابی کرده و بسته به درست (true) بودن یا نبودن نتیجه، تمام موارد بین $if_match و $endif متناظر را چاپ می‌کند. عبارت‌های معتبر شامل یک سمت چپ، یک عملگر و یک سمت راست هستند. سمت چپ و راست پیش از ارزیابی، برای اشیاء متنی موجود در آن‌ها تجزیه می‌شوند.

انواع معتبر و شناخته‌شده برای سمت چپ و راست عبارتند از:

double: آرگومان فقط از ارقام و یک نقطه تشکیل شده است.
long: آرگومان فقط شامل ارقام است.
string: آرگومان درون علامت نقل‌قول (") قرار دارد.

عملگرهای معتبر عبارتند از:

< یا >
<= یا >=
== یا !=

if_mixer_mute (mixer): اگر میکسر موجود [و بی‌صدا] باشد، تمام موارد بین $if_mixer_mute و $endif متناظر را نمایش می‌دهد. اگر هیچ مکسری مشخص نشود، از “Vol” استفاده می‌شود.
if_mounted (mountpoint): اگر نقطه اتصال MOUNTPOINT متصل (مونت) شده باشد، تمام موارد بین $if_mounted و $endif متناظر نمایش داده می‌شود.
if_mpd_playing: اگر mpd در حال پخش یا مکث باشد، تمام موارد بین $if_mpd_playing و $endif متناظر را نمایش می‌دهد.
if_pa_sink_muted: اگر سینک پیش‌فرض PulseAudio بی‌صدا (muted) باشد، تمام موارد بین $if_pa_sink_muted و $else یا $endif متناظر را نمایش می‌دهد.
if_pa_source_muted: اگر سورس پیش‌فرض PulseAudio (مانند میکروفون شما) بی‌صدا باشد، تمام موارد بین $if_pa_source_muted و $else یا $endif متناظر را نمایش می‌دهد.
if_pa_source_running: اگر سورس پیش‌فرض PulseAudio در حال کار باشد (مثلاً برنامه‌ای در حال دسترسی به میکروفون شما باشد)، تمام موارد بین $if_pa_source_running و $else یا $endif متناظر را نمایش می‌دهد.
if_running (process): اگر PROCESS در حال اجرا باشد، تمام موارد بین $if_running و $else یا $endif متناظر را نمایش می‌دهد. توجه داشته باشید که PROCESS می‌تواند یک خط فرمان کامل به همراه آرگومان‌ها (بدون پیشوند دایرکتوری)، یا صرفاً نام یک فایل اجرایی باشد. به عنوان مثال، در صورت در حال اجرا بودن فرآیندی با خط فرمان /usr/bin/conky -u 5, هر یک از موارد زیر درست خواهد بود:

${if_running conky -u 5} یا
${if_running conky}

مهم است که فاصله‌های پایانی قرار داده نشوند. به عنوان مثال، ${if_running conky } نادرست خواهد بود.

if_smapi_bat_installed (INDEX): هنگام استفاده از smapi، اگر باتری با نمایه INDEX نصب شده باشد، تمام موارد بین $if_smapi_bat_installed و $endif متناظر را نمایش می‌دهد.
if_up (interface): اگر INTERFACE وجود داشته و فعال (up) باشد، تمام موارد بین $if_up و $endif متناظر را نمایش می‌دهد.
if_updatenr (updatenr): اگر UPDATENR-امین باری باشد که کانکی به‌روزرسانی می‌شود، تمام موارد بین $if_updatenr و $endif متناظر را نمایش می‌دهد. با رسیدن به بالاترین UPDATENR، شمارنده بازنشانی می‌شود.

مثال: {$if_updatenr 1}foo$endif{$if_updatenr 2}bar$endif{$if_updatenr 4}$endif در ۲۵٪ مواقع foo، پس از آن در ۲۵٪ مواقع bar، و در نصف دیگر زمان هیچ‌چیز را نشان نمی‌دهد.

if_xmms2_connected: اگر xmms2 در حال اجرا باشد، تمام موارد بین $if_xmms2_connected و $endif متناظر را نمایش می‌دهد.
iface (number): نام‌های رابط شبکه را با شروع از شماره ۱ نمایش می‌دهد؛ مانند ${iface 1}.
image (-p x,y) (-s WxH) (-n) (-f interval): تصویری را از مسیر مشخص‌شده با استفاده از Imlib2 رندر می‌کند. ۴ آرگومان اختیاری می‌پذیرد: موقعیت، اندازه، سوییچ عدم ذخیره در حافظه پنهان (no-cache)، و فاصله زمانی پاکسازی حافظه پنهان. تغییر موقعیت x,y محل قرارگیری تصویر را تغییر می‌دهد و تغییر WxH تصویر را مقیاس‌بندی می‌کند. اگر گزینه عدم ذخیره در حافظه پنهان (-n) را مشخص کنید، تصویر در حافظه پنهان ذخیره نخواهد شد. همچنین می‌توانید از سوییچ -f int برای مشخص کردن فاصله زمانی پاکسازی حافظه پنهان برای یک تصویر خاص استفاده کنید. مثال: ${image /home/brenden/cheeseburger.jpg -p 20,20 -s 200x200} تصویر `cheeseburger.jpg' را در موقعیت (20,20) با اندازه ۲۰۰×۲۰۰ پیکسل رندر می‌کند. کانکی هیچ تلاشی برای تنظیم موقعیت (یا هر قالب‌بندی دیگری) از تصاویر نمی‌کند؛ آن‌ها صرفاً طبق آرگومان‌های ارائه‌شده رندر می‌شوند. تنها دلیل اینکه $image بخشی از بخش conky.text است، فراهم آوردن امکان تغییرات در زمان اجرا از طریق $execp ،$lua_parse یا روش‌های دیگر است.
imap_messages (args): به‌طور پیش‌فرض تعداد پیام‌های موجود در صندوق ورودی سراسری IMAP شما را نمایش می‌دهد. می‌توانید صندوق‌های ورودی IMAP مجزا را با ارسال آرگومان‌ها به این شیء، به صورت جداگانه تعریف کنید. آرگومان‌ها عبارتند از: “host user pass [-i interval (in seconds)] [-f `folder'] [-p port] [-e `command'] [-r retries]”. پورت پیش‌فرض ۱۴۳، پوشه پیش‌فرض `INBOX'، فاصله زمانی پیش‌فرض ۵ دقیقه، و تعداد تلاش‌های مجدد پیش‌فرض قبل از انصراف ۵ است. اگر گذرواژه به صورت ’*’ داده شود، هنگام شروع کانکی از شما خواسته می‌شود گذرواژه را وارد کنید.
imap_unseen (args): به‌طور پیش‌فرض تعداد پیام‌های دیده‌نشده در صندوق ورودی سراسری IMAP شما را نمایش می‌دهد. می‌توانید صندوق‌های ورودی IMAP مجزا را با ارسال آرگومان‌ها به این شیء، به صورت جداگانه تعریف کنید. آرگومان‌ها عبارتند از: “host user pass [-i interval (in seconds)] [-f `folder'] [-p port] [-e `command'] [-r retries]”. پورت پیش‌فرض ۱۴۳، پوشه پیش‌فرض `INBOX'، فاصله زمانی پیش‌فرض ۵ دقیقه، و تعداد تلاش‌های مجدد پیش‌فرض قبل از انصراف ۵ است. اگر گذرواژه به صورت ’*’ داده شود، هنگام شروع کانکی از شما خواسته می‌شود گذرواژه را وارد کنید.
intel_backlight: روشنایی نور پس‌زمینه اینتل (Intel backlight) را بر حسب درصد نمایش می‌دهد.
ioscheduler disk: زمان‌بند ورودی/خروجی (ioscheduler) فعلی مورد استفاده برای نام دیسک مشخص‌شده (مانند “hda” یا “sdb”) را چاپ می‌کند.
irc server(:port) #channel (max_msg_lines): هر آنچه را که در کانال #channel روی سرور IRC به نام `server' گفته می‌شود نمایش می‌دهد. در صورت عدم تعیین `port'، از پورت TCP شماره ۶۶۶۷ برای اتصال استفاده می‌شود. همه پیام‌ها از آخرین بار یا در صورت مشخص شدن، آخرین ورودی‌های `max_msg_lines' را نشان می‌دهد.
journal (lines) (type): N خط آخر ژورنال systemd را نمایش می‌دهد. در صورت حذف N، مقدار پیش‌فرض آن ۱ است. از ۰ برای نمایش تمام خطوط موجود استفاده کنید. مقادیر منفی به ۱ محدود می‌شوند. نوع اختیاری type ژورنال مورد خواندن را فیلتر می‌کند: `system' فقط ژورنال سیستم را نشان می‌دهد، `user' فقط ژورنال کاربر جاری را نشان می‌دهد، `runtime' فقط ژورنال زمان اجرا را نشان می‌دهد، و `local' تمام ژورنال‌های محلی را نشان می‌دهد (حالت پیش‌فرض، مشابه حذف type). خروجی توسط اندازه بافر متنی محدود می‌شود.
kernel: نسخه هسته (کرنل).
key_caps_lock: نشانگری برای کلید قفل حروف بزرگ (Caps Lock).
key_num_lock: نشانگری برای کلید قفل اعداد (Num Lock).
key_scroll_lock: نشانگری برای کلید قفل پیمایش (Scroll Lock).
keyboard_layout: چیدمان صفحه‌کلید را نمایش می‌دهد.
laptop_mode: مقدار فایل /proc/sys/vm/laptop_mode.
legacymem: میزان حافظه مصرفی، محاسبه‌شده به همان شیوه در برنامه free.
lines textfile: تعداد خطوط موجود در فایل داده‌شده را نمایش می‌دهد.
loadavg (1|2|3): میانگین بار سیستم؛ عدد ۱ برای ۱ دقیقه گذشته، ۲ برای ۵ دقیقه گذشته و ۳ برای ۱۵ دقیقه گذشته است. بدون آرگومان، هر سه مقدار را جداشده با فاصله چاپ می‌کند.
loadgraph (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value): نمودار میانگین بار ۱ دقیقه‌ای (Load1)، شبیه به xload، با رنگ‌های اختیاری در قالب هگز بدون علامت #. هنگام استفاده از سوییچ -l، از مقیاس لگاریتمی (برای مشاهده مقادیر کوچک) استفاده می‌کند. سوییچ `-t' را برای استفاده از طیف دمایی می‌پذیرد، که باعث می‌شود مقادیر طیف بسته به دامنه مقدار نمودار تغییر کنند (امتحان کنید تا ببینید). گزینه `-x' محور x و `-y' محور y نمودار را معکوس می‌کند. گزینه `-m' یک حد پایین/حداقل غیرصفر تعیین می‌کند و اطمینان می‌دهد که تمام مقادیر حداقل برابر با حداقلِ مشخص‌شده باشند (به جز صفر).
lowercase text: تمام حروف را به حروف کوچک تبدیل می‌کند.
lua function_name (function parameters): یک تابع Lua را با پارامترهای داده‌شده اجرا می‌کند، سپس رشته بازگردانده‌شده را چاپ می‌کند. همچنین برای نحوه بارگذاری اسکریپت‌ها به `lua_load' مراجعه کنید. کانکی پیشوند `conky_' را به ابتدای function_name اضافه می‌کند تا از فراخوانی تصادفی تابع اشتباه جلوگیری کند، مگر اینکه خودتان `conky_' را در ابتدای آن قرار داده باشید.
lua_bar (height,width) function_name (function parameters): یک تابع Lua را با پارامترهای داده‌شده اجرا می‌کند و یک نوار رسم می‌کند. انتظار می‌رود مقدار نتیجه یک عدد صحیح بین ۰ و ۱۰۰ باشد. همچنین برای نحوه بارگذاری اسکریپت‌ها به `lua_load' مراجعه کنید. کانکی پیشوند `conky_' را به ابتدای function_name اضافه می‌کند تا از فراخوانی تصادفی تابع اشتباه جلوگیری کند، مگر اینکه خودتان `conky_' را در ابتدای آن قرار داده باشید.
lua_gauge (height,width) function_name (function parameters): یک تابع Lua را با پارامترهای داده‌شده اجرا می‌کند و یک سنجه (gauge) رسم می‌کند. انتظار می‌رود مقدار نتیجه یک عدد صحیح بین ۰ و ۱۰۰ باشد. همچنین برای نحوه بارگذاری اسکریپت‌ها به `lua_load' مراجعه کنید. کانکی پیشوند `conky_' را به ابتدای function_name اضافه می‌کند تا از فراخوانی تصادفی تابع اشتباه جلوگیری کند، مگر اینکه خودتان `conky_' را در ابتدای آن قرار داده باشید.
lua_graph function_name (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value): یک تابع Lua را اجرا می‌کند و نموداری رسم می‌نماید. انتظار می‌رود مقدار نتیجه هر عددی باشد، و به‌طور پیش‌فرض برای نمایش کل محدوده مقیاس‌بندی می‌شود. همچنین برای نحوه بارگذاری اسکریپت‌ها به `lua_load' مراجعه کنید. سوییچ `-t' را برای استفاده از طیف دمایی می‌پذیرد، که باعث می‌شود مقادیر طیف بسته به دامنه مقدار نمودار تغییر کنند (امتحان کنید تا ببینید). کانکی پیشوند `conky_' را به ابتدای function_name اضافه می‌کند تا از فراخوانی تصادفی تابع اشتباه جلوگیری کند، مگر اینکه خودتان `conky_' را در ابتدای آن قرار داده باشید. گزینه `-x' محور x و `-y' محور y نمودار را معکوس می‌کند. گزینه `-m' یک حد پایین/حداقل غیرصفر تعیین می‌کند و اطمینان می‌دهد که تمام مقادیر حداقل برابر با حداقلِ مشخص‌شده باشند (به جز صفر).
lua_parse function_name (function parameters): یک تابع Lua را با پارامترهای داده‌شده مانند $lua اجرا می‌کند، سپس مقدار نتیجه را مطابق با نحو (سینتکس) بخش conky.text تجزیه و چاپ می‌کند. همچنین برای نحوه بارگذاری اسکریپت‌ها به `lua_load' مراجعه کنید. کانکی پیشوند `conky_' را به ابتدای function_name اضافه می‌کند تا از فراخوانی تصادفی تابع اشتباه جلوگیری کند، مگر اینکه خودتان `conky_' را در ابتدای آن قرار داده باشید.
machine: معماری ماشین؛ مانند i686 یا x86_64.
mails (mailbox) (interval): تعداد نامه‌های موجود در صندوق پستی مشخص‌شده یا در صورت عدم تعیین، در صف نامه‌های (mail spool) شما. هر دو نوع صندوق پستی mbox و maildir پشتیبانی می‌شوند. می‌توانید از برنامه‌ای مانند fetchmail برای دریافت نامه‌ها از یک سرور با استفاده از پروتکل مورد علاقه خود استفاده کنید. همچنین به new_mails مراجعه کنید.
mboxscan (-n number of messages to print) (-fw from width) (-sw subject width) mbox: خلاصه‌ای از پیام‌های اخیر را در یک صندوق پستی با فرمت mbox چاپ می‌کند. پارامتر mbox نام فایل صندوق پستی است (می‌تواند با استفاده از ’“’ احاطه شود، یعنی ${mboxscan -n 10”/home/brenden/some box”}
mem: مقدار حافظه در حال استفاده.
memactive: مقدار حافظه فعال (active). فقط در FreeBSD.
memavail: مقدار حافظه در دسترس، طبق آنچه در /proc/meminfo ثبت شده است. فقط در لینوکس ۳.۱۴ به بالا.
membar (height),(width): نواری که مقدار حافظه در حال استفاده را نمایش می‌دهد.
memdirty: مقدار حافظه بازنویسی‌شده یا اصطلاحاً کثیف (“dirty”). فقط در لینوکس.
memeasyfree: مقدار حافظه آزاد شامل حافظه‌ای که بسیار آسان آزاد می‌شود (بافرها/کاشه‌ها).
memfree: مقدار حافظه آزاد.
memgauge (height),(width): سنجه‌ای که مقدار حافظه در حال استفاده را نشان می‌دهد (cpugauge را ببینید).
memgraph (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value): نمودار مصرف حافظه. هنگام استفاده از سوییچ -l، از مقیاس لگاریتمی (برای مشاهده مقادیر کوچک) استفاده می‌کند. سوییچ `-t' را برای استفاده از طیف دمایی می‌پذیرد، که باعث می‌شود مقادیر طیف بسته به دامنه مقدار نمودار تغییر کنند (امتحان کنید تا ببینید). گزینه `-x' محور x و `-y' محور y نمودار را معکوس می‌کند. گزینه `-m' یک حد پایین/حداقل غیرصفر تعیین می‌کند و اطمینان می‌دهد که تمام مقادیر حداقل برابر با حداقلِ مشخص‌شده باشند (به جز صفر).
meminactive: مقدار حافظه غیرفعال (inactive). فقط در FreeBSD.
memlaundry: مقدار حافظه موجود در صف laundry. فقط در FreeBSD.
memmax: مقدار کل حافظه.
memperc: درصد حافظه در حال استفاده.
memwired: مقدار حافظه سیم‌کشی‌شده (wired). فقط در FreeBSD.
memwithbuffers: مقدار حافظه در حال استفاده، شامل حافظه مصرف‌شده توسط بافرها و کاشه‌های سیستم.
memwithbuffersbar (height),(width): نواری که مقدار حافظه در حال استفاده را نشان می‌دهد (شامل حافظه مصرف‌شده توسط بافرها و کاشه‌های سیستم).
memwithbuffersgraph (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m value): نمودار مصرف حافظه شامل حافظه مصرف‌شده توسط بافرها و کاشه سیستم. هنگام استفاده از سوییچ -l، از مقیاس لگاریتمی (برای مشاهده مقادیر کوچک) استفاده می‌کند. سوییچ `-t' را برای استفاده از طیف دمایی می‌پذیرد، که باعث می‌شود مقادیر طیف بسته به دامنه مقدار نمودار تغییر کنند (امتحان کنید تا ببینید). گزینه `-x' محور x و `-y' محور y نمودار را معکوس می‌کند. گزینه `-m' یک حد پایین/حداقل غیرصفر تعیین می‌کند و اطمینان می‌دهد که تمام مقادیر حداقل برابر با حداقلِ مشخص‌شده باشند (به جز صفر).
mixer (device): مقدار میکسر گزارش‌شده توسط سیستم‌عامل را چاپ می‌کند. در لینوکس، این متغیر از شبیه‌سازی OSS استفاده می‌کند، بنابراین باید ماژول کرنل مناسب بارگذاری شده باشد. میکسر پیش‌فرض “Vol” است، اما می‌توانید یکی از کنترل‌های موجود در OSS را مشخص کنید: “Vol”، “Bass”، “Trebl”، “Synth”، “Pcm”، “Spkr”، “Line”، “Mic”، “CD”، “Mix”، “Pcm2”، “Rec”، “IGain”، “OGain”، “Line1”، “Line2”، “Line3”، “Digital1”، “Digital2”، “Digital3”، “PhoneIn”، “PhoneOut”، “Video”، “Radio” و “Monitor”.

پیش‌فرض: Vol

mixerbar (device): مقدار میکسر گزارش‌شده توسط سیستم‌عامل را در یک نوار نمایش می‌دهد. برای جزئیات بیشتر در مورد آرگومان‌ها، مستندات $mixer را ببینید.
mixerl (device): مقدار میکسر کانال چپ را طبق گزارش سیستم‌عامل چاپ می‌کند. برای جزئیات بیشتر در مورد آرگومان‌ها، مستندات $mixer را ببینید.
mixerlbar (device): مقدار میکسر کانال چپ را طبق گزارش سیستم‌عامل در یک نوار نمایش می‌دهد. برای جزئیات بیشتر در مورد آرگومان‌ها، مستندات $mixer را ببینید.
mixerr (device): مقدار میکسر کانال راست را طبق گزارش سیستم‌عامل چاپ می‌کند. برای جزئیات بیشتر در مورد آرگومان‌ها، مستندات $mixer را ببینید.
mixerrbar (device): مقدار میکسر کانال راست را طبق گزارش سیستم‌عامل در یک نوار نمایش می‌دهد. برای جزئیات بیشتر در مورد آرگومان‌ها، مستندات $mixer را ببینید.
moc_album: آلبوم آهنگ جاری در MOC.
moc_artist: هنرمند (خواننده) آهنگ جاری در MOC.
moc_bar (height),(width): نوار پیشرفت آهنگ جاری در MOC.
moc_bitrate: نرخ بیت (bitrate) در آهنگ جاری MOC.
moc_avgbitrate: میانگین نرخ بیت در آهنگ جاری MOC.
moc_curtime: زمان سپری‌شده آهنگ جاری در MOC.
moc_cursec: زمان سپری‌شده آهنگ جاری در MOC به ثانیه.
moc_file: نام فایل آهنگ جاری در MOC.
moc_percent: درصد پیشرفت آهنگ جاری در MOC.
moc_rate: نرخ نمونه‌برداری آهنگ جاری در MOC.
moc_song: نام آهنگ در حال پخش در MOC.
moc_state: وضعیت جاری MOC؛ در حال پخش (playing)، متوقف (stopped) و غیره.
moc_timeleft: زمان باقی‌مانده از آهنگ جاری در MOC.
moc_title: عنوان آهنگ جاری در MOC.
moc_totaltime: مدت‌زمان کل آهنگ جاری در MOC.
moc_totalsec: مدت‌زمان کل آهنگ جاری در MOC برحسب ثانیه.
monitor: شماره مانیتوری که conky روی آن در حال اجرا است، یا پیام “Not running in X” در صورتی که این‌گونه باشد.
monitor_number: تعداد مانیتورها، یا پیام “Not running in X” در صورتی که این‌گونه باشد.
mouse_speed: نمایش سرعت ماوس.
mpd_album: نام آلبوم آهنگ جاری در MPD.
mpd_albumartist: هنرمند آلبوم آهنگ جاری در MPD.
mpd_artist: هنرمند آهنگ جاری در MPD؛ باید در زمان کامپایل فعال شده باشد.
mpd_bar (height),(width): نوار پیشرفت پخش در MPD.
mpd_bitrate: نرخ بیت (بیت‌ریت) آهنگ جاری.
mpd_comment (max-length): توضیحات (کامنت) آهنگ جاری در MPD.
mpd_date: تاریخ آهنگ جاری.
mpd_elapsed: زمان سپری‌شده از آهنگ.
mpd_file: نام فایل آهنگ جاری در MPD را چاپ می‌کند.
mpd_length: مدت‌زمان آهنگ.
mpd_name: فیلد نام را در MPD چاپ می‌کند.
mpd_percent: درصد پیشرفت آهنگ.
mpd_random: وضعیت پخش تصادفی (روشن/خاموش - On/Off).
mpd_repeat: وضعیت تکرار (روشن/خاموش - On/Off).
mpd_smart (max length): نام آهنگ را بسته به اطلاعات موجود، به شکل “artist - title” یا نام فایل چاپ می‌کند.
mpd_status: در حال پخش، متوقف‌شده، و غیره.
mpd_title (max length): عنوان آهنگ جاری در MPD.
mpd_track: فیلد ترک (شماره آهنگ) را در MPD چاپ می‌کند.
mpd_vol: میزان بلندی صدای MPD.
mysql query: اولین فیلد از نخستین ردیف نتیجه کوئری را نشان می‌دهد.
nameserver (index): یک سرور نام دامنه (nameserver) را از /etc/resolv.conf چاپ می‌کند.
new_mails (mailbox) (interval): تعداد نامه‌های خوانده‌نشده در صندوق پستی مشخص‌شده یا در صورت تعیین نشدن، در mail spool. هر دو نوع صندوق پستی mbox و maildir پشتیبانی می‌شوند.
no_update text: متن را نمایش داده و متغیرهای درون آن را پردازش می‌کند، اما آن‌ها را به‌روزرسانی نمی‌کند. از این قابلیت برای مواردی استفاده کنید که در طول اجرای conky تغییر نمی‌کنند، مانند $machine ،$conky_version و... با به‌روزرسانی نکردن این موارد می‌توانید در مصرف منابع صرفه‌جویی کنید.
nodename: نام هاست (Hostname).
nodename_short: نام کوتاه هاست (مشابه دستور شل `hostname -s').
nvidia argument (GPU_ID): اطلاعات کارت گرافیک Nvidia از طریق کتابخانه XNVCtrl یا کتابخانه NVML.

دماها به‌صورت اعشاری (float) و سایر مقادیر به‌صورت عدد صحیح چاپ می‌شوند.

GPU_ID: پارامتر اختیاری برای انتخاب GPU مورد استفاده به‌صورت 0,1,2,3,.. پارامتر پیش‌فرض 0 است

آرگومان‌های ممکن:

آرگومان	نام مستعار	توضیحات	XNVCtrl	NVML
gputemp	temp	دمای پردازنده گرافیکی (GPU)	✅	✅
gputempthreshold	threshold	آستانه دمایی که در آن پردازنده گرافیکی فرکانس کاری (کلاک) خود را کاهش می‌دهد	✅	✅
ambienttemp	ambient	دمای محیط پیرامون کارت گرافیک	✅	❌
gpufreqcur	gpufreq	فرکانس کاری (کلاک) فعلی GPU	✅	✅
gpufreqmin		حداقل فرکانس کاری GPU	✅	✅
gpufreqmax		حداکثر فرکانس کاری GPU	✅	✅
memfreqcur	memfreq	فرکانس کاری فعلی حافظه	✅	✅
memfreqmin		حداقل فرکانس کاری حافظه	✅	✅
memfreqmax		حداکثر فرکانس کاری حافظه	✅	✅
mtrfreqcur	mtrfreq	فرکانس کاری فعلی نرخ انتقال داده حافظه	✅	❌
mtrfreqmin		حداقل فرکانس کاری نرخ انتقال داده حافظه	✅	❌
mtrfreqmax		حداکثر فرکانس کاری نرخ انتقال داده حافظه	✅	❌
perflevelcur	perflevel	سطح عملکرد (کارایی) فعلی	✅	✅
perflevelmin		پایین‌ترین سطح عملکرد	✅	✅
perflevelmax		بالاترین سطح عملکرد	✅	✅
perfmode		حالت عملکرد (Performance mode)	✅	❌
gpuutil		درصد استفاده از پردازنده گرافیکی (GPU)	✅	✅
membwutil		درصد استفاده از پهنای باند حافظه	✅	❌
videoutil		درصد استفاده از موتور ویدیویی	✅	❌
pcieutil		درصد استفاده از پهنای باند PCIe	✅	❌
memused	mem	میزان حافظه مصرف‌شده	✅	✅
memfree	memavail	میزان حافظه آزاد	✅	✅
memmax	memtotal	کل میزان حافظه	✅	✅
memutil	memperc	درصد استفاده از حافظه	✅	✅
fanspeed		سرعت فن	✅	✅
fanlevel		درصد سطح فن	✅	✅
imagequality		کیفیت تصویر	✅	❌
modelname		نام مدل کارت گرافیک	✅	✅
driverversion		نسخه درایور	✅	✅
arch		نام معماری پردازنده گرافیکی (GPU)	❌	✅
powerlimit		محدودیت توان مصرفی برحسب وات	❌	✅
powerinstant		توان مصرفی لحظه‌ای برحسب وات	❌	✅
poweravg		میانگین توان مصرفی طی یک ثانیه برحسب وات	❌	✅

nvidiabar (height),(width) argument (GPU_ID): مشابه با nvidia، با این تفاوت که خروجی را در یک نوار افقی رسم می‌کند. پارامترهای ارتفاع و عرض اختیاری هستند و به ترتیب مقادیر پیش‌فرض تنظیمات پیکربندی default_bar_height و default_bar_width را می‌گیرند.

GPU_ID: پارامتر اختیاری برای انتخاب پردازنده گرافیکی (GPU) مورد استفاده به‌صورت 0,1,2,3,.. پارامتر پیش‌فرض 0 است.

توجه داشته باشید که آرگومان‌های زیر ناسازگار هستند:

gputempthreshold (threshold)
gpufreqmin
gpufreqmax
memfreqmin
memfreqmax
mtrfreqmin
mtrfreqmax
perflevelmin
perflevelmax
perfmode
memtotal (memmax)
fanspeed
powerlimit

nvidiagauge (height),(width) argument (GPU_ID): مشابه با nvidiabar، با این تفاوت که یک عقربه دایره‌ای (بسیار شبیه به سرعت‌سنج خودرو) رسم می‌کند. پارامترهای ارتفاع و عرض اختیاری هستند و به ترتیب مقادیر پیش‌فرض تنظیمات پیکربندی default_gauge_height و default_gauge_width را می‌گیرند.

GPU_ID: پارامتر اختیاری برای انتخاب پردازنده گرافیکی (GPU) مورد استفاده به‌صورت 0,1,2,3,.. پارامتر پیش‌فرض 0 است.

برای آرگومان‌های ممکن، nvidia و nvidiabar را ببینید.

nvidiagraph argument (height),(width) (gradient color 1) (gradient color 2) (scale) (-t) (-l) (-x) (-y) (-m) GPU_ID: مشابه با nvidiabar، با این تفاوت که یک نمودار با پیمایش افقی است که مقادیر 0-100 روی محور عمودی آن رسم می‌شوند. پارامترهای ارتفاع و عرض اختیاری هستند و به ترتیب مقادیر پیش‌فرض تنظیمات پیکربندی default_graph_height و default_graph_width را می‌گیرند.

GPU_ID: اختیاری نیست. این پارامتر امکان انتخاب پردازنده گرافیکی مورد استفاده را به‌صورت 0,1,2,3,.. فراهم می‌کند.

برای آرگومان‌های ممکن، nvidia و nvidiabar را ببینید. برای کسب اطلاعات بیشتر درباره گزینه‌های -t -l -x -y و رنگ‌های گرادیان، execgraph را ببینید.

offset (pixels): جابه‌جایی متن به اندازه N پیکسل به جلو. همچنین $voffset را ببینید.
outlinecolor (color): تغییر رنگ خط دور (outline).
pa_card_active_profile: پروفایل فعال کارت پیش‌فرض PulseAudio.
pa_card_name: نام کارت پیش‌فرض PulseAudio.
pa_sink_active_port_description: توضیحات درگاه فعال سینک (sink) پیش‌فرض PulseAudio.
pa_sink_active_port_name: نام درگاه فعال سینک (sink) پیش‌فرض PulseAudio.
pa_sink_description: توضیحات سینک (sink) پیش‌فرض PulseAudio.
pa_sink_volume: درصد حجم صدای سینک (sink) پیش‌فرض PulseAudio.
pa_sink_volumebar: نوار حجم صدای سینک (sink) پیش‌فرض PulseAudio.
password (length): تولید گذرواژه‌های تصادفی.
pb_battery item: در صورت اجرا روی Apple powerbook/ibook، اطلاعات وضعیت باتری را نمایش می‌دهد. پارامتر item مشخص می‌کند چه اطلاعاتی نمایش داده شود. دقیقاً باید یک مورد مشخص شود. موارد معتبر عبارتند از:

مورد (Item)	توضیحات
status	نمایش وضعیت شارژ کامل، در حال شارژ، در حال دشارژ (تخلیه) یا عدم وجود باتری (کار با برق مستقیم AC).
percent	نمایش درصد شارژ باتری در صورت شارژ شدن یا تخلیه شدن. اگر باتری کاملاً شارژ شده باشد یا وجود نداشته باشد، چیزی نمایش داده نمی‌شود.
time	نمایش زمان باقی‌مانده تا شارژ کامل یا تخلیه کامل باتری با نرخ فعلی. اگر باتری وجود نداشته باشد یا موجود باشد اما کاملاً شارژ شده و در حال تخلیه نباشد، چیزی نمایش داده نمی‌شود.

pid_chroot pid: پوشه‌ای که به عنوان پوشه ریشه توسط فرایند استفاده می‌شود (این مقدار برابر “/” خواهد بود مگر آنکه فرایند فراخوان سیستمی chroot را انجام داده باشد).
pid_cmdline pid: خط فرمانی که این فرایند با آن فراخوانی شده است.
pid_cwd pid: پوشه کاری جاری فرایند.
pid_egid pid: شناسه گروه موثر (effective gid) فرایند.
pid_environ pid varname: محتوای یک متغیر محیطی فرایند.
pid_environ_list pid: فهرست متغیرهای محیطی که برای فرایند قابل مشاهده هستند.
pid_euid pid: شناسه کاربر موثر (effective uid) فرایند.
pid_exe pid: مسیر دستور اجراشده که فرایند را آغاز کرده است.
pid_fsgid pid: شناسه گروه سیستم‌فایل (file system gid) فرایند.
pid_fsuid pid: شناسه کاربر سیستم‌فایل (file system uid) فرایند.
pid_gid pid: شناسه گروه واقعی (real gid) فرایند.
pid_nice pid: مقدار نایس (nice) فرایند.
pid_openfiles pid: فهرست پرونده‌هایی که فرایند باز نگه داشته است.
pid_parent pid: شناسه فرایند والد (parent pid) این فرایند.
pid_priority pid: اولویت فرایند (`priority' را در “man 5 proc” ببینید).
pid_read pid: تعداد کل بایت‌های خوانده‌شده توسط فرایند.
pid_sgid pid: شناسه گروه ذخیره‌شده (saved set gid) فرایند.
pid_state pid: وضعیت فرایند.
pid_state_short pid: یکی از نویسه‌های موجود در “RSDZTW” که نمایانگر وضعیت فرایند است؛ که در آن R در حال اجرا، S در خواب با انتظار با قابلیت وقفه، D در حال انتظار در خواب غیرقابل وقفه دیسک، Z زامبی، T ردیابی‌شده یا متوقف‌شده (با یک سیگنال) و W پیجینگ است.
pid_stderr pid: توصیف‌گر پرونده متصل به STDERR فرایند.
pid_stdin pid: توصیف‌گر پرونده متصل به STDIN فرایند.
pid_stdout pid: توصیف‌گر پرونده متصل به STDOUT فرایند.
pid_suid pid: شناسه کاربر ذخیره‌شده (saved set uid) فرایند.
pid_thread_list pid: فهرستی شامل شناسه‌های فرایند (PID) ریسمان‌های این فرایند.
pid_threads pid: تعداد ریسمان‌های موجود در فرایندی که شامل این ریسمان است.
pid_time pid: مجموع $pid_time_kernelmode و $pid_time_usermode.
pid_time_kernelmode pid: مدت زمانی که فرایند در حالت هسته (kernel mode) زمان‌بندی شده است بر حسب ثانیه.
pid_time_usermode pid: مدت زمانی که فرایند در حالت کاربر (user mode) زمان‌بندی شده است بر حسب ثانیه.
pid_uid pid: شناسه کاربر واقعی (real uid) فرایند.
pid_vmdata pid: اندازه بخش داده (data segment) فرایند.
pid_vmexe pid: اندازه بخش متن یا کد (text segment) فرایند.
pid_vmhwm pid: اوج اندازه مجموعه مقیم در حافظه (“high water mark”) فرایند.
pid_vmlck pid: اندازه حافظه قفل‌شده فرایند.
pid_vmlib pid: اندازه کد کتابخانه اشتراکی فرایند.
pid_vmpeak pid: اوج اندازه حافظه مجازی فرایند.
pid_vmpte pid: اندازه ورودی‌های جدول صفحه (PTE) فرایند.
pid_vmrss pid: اندازه مجموعه مقیم در حافظه (RSS) فرایند.
pid_vmsize pid: اندازه حافظه مجازی فرایند.
pid_vmstk pid: اندازه بخش پشته (stack segment) فرایند.
pid_write pid: تعداد کل بایت‌های نوشته‌شده توسط فرایند.
platform (dev) type n (factor offset): حسگر پلتفرم از sysfs (لینوکس 2.6). در صورتی که تنها یک دستگاه پلتفرم دارید، پارامتر dev می‌تواند نادیده گرفته شود. نوع پلتفرم (Platform type) یکی از مقادیر in یا vol به معنی ولتاژ؛ fan به معنی فن؛ و temp به معنی دما است. پارامتر n شماره حسگر است. مسیر /sys/bus/platform/devices/ را در رایانه محلی خود ببینید. آرگومان‌های اختیاری factor و offset امکان پیش‌محاسبه ورودی خام را فراهم می‌کنند که به‌صورت زیر تغییر می‌یابد: input = input * factor + offset. توجه داشته باشید که آن‌ها باید به‌صورت مقادیر اعشاری داده شوند (یعنی حداقل شامل یک رقم اعشار باشند).
platformbar (height),(width) (dev) type n (factor offset): مشابه با platform، با این تفاوت که خوانش حسگر را در یک نوار افقی نمایش می‌دهد. از factor و offset برای مقیاس‌بندی مقدار گزارش‌شده توسط platform به محدوده 0-100 استفاده کنید. مقادیر دما از قبل از میلی‌درجه تبدیل شده‌اند. ارتفاع و عرض به ترتیب مقادیر پیش‌فرض default_bar_height و default_bar_width را می‌گیرند.
pop3_unseen (args): به‌طور پیش‌فرض تعداد پیام‌های دیده‌نشده در صندوق ورودی سراسری POP3 شما را نمایش می‌دهد. می‌توانید با ارسال آرگومان‌ها به این شیء، صندوق‌های ورودی POP3 جداگانه را به‌طور مستقل تعریف کنید. آرگومان‌ها عبارتند از: “host user pass [-i interval (in seconds)] [-p port] [-e `command'] [-r retries]”. پورت پیش‌فرض 110، بازه زمانی پیش‌فرض 5 دقیقه، و تعداد پیش‌فرض تلاش‌های مجدد قبل از انصراف 5 است. اگر گذرواژه به‌صورت ’*’ داده شود، هنگام شروع Conky از شما خواسته می‌شود گذرواژه را وارد کنید.
pop3_used (args): به‌طور پیش‌فرض مقدار فضای استفاده‌شده (بر حسب مبی‌بایت، 2^20) در صندوق ورودی سراسری POP3 شما را نمایش می‌دهد. می‌توانید با ارسال آرگومان‌ها به این شیء، صندوق‌های ورودی POP3 جداگانه را به‌طور مستقل تعریف کنید. آرگومان‌ها عبارتند از: “host user pass [-i interval (in seconds)] [-p port] [-e `command'] [-r retries]”. پورت پیش‌فرض 110، بازه زمانی پیش‌فرض 5 دقیقه، و تعداد پیش‌فرض تلاش‌های مجدد قبل از انصراف 5 است. اگر گذرواژه به‌صورت ’*’ داده شود، هنگام شروع Conky از شما خواسته می‌شود گذرواژه را وارد کنید.
processes: تعداد کل فرایندها (در خواب و در حال اجرا).
read_tcp (host) port: به یک درگاه (پورت) tcp در یک میزبان (پیش‌فرض localhost است) متصل می‌شود، تمام نویسه‌های موجود در آن لحظه را می‌خواند و آن‌ها را نشان می‌دهد.
read_udp (host) port: به یک درگاه (پورت) udp در یک میزبان (پیش‌فرض localhost است) متصل می‌شود، تمام نویسه‌های موجود در آن لحظه را می‌خواند و آن‌ها را نشان می‌دهد.
replied_mails (maildir) (interval): تعداد نامه‌های علامت‌گذاری‌شده به عنوان پاسخ‌داده‌شده در صندوق پستی مشخص‌شده یا در صورت عدم تعیین، در mail spool. تنها صندوق‌های پستی نوع maildir پشتیبانی می‌شوند، نوع mbox مقدار -1 برمی‌گرداند.
rss uri interval_in_seconds action (num_par (spaces_in_front)): بارگیری و تجزیه فیدهای RSS. بازه زمانی (interval) می‌تواند یک مقدار (ممیز شناور) بزرگ‌تر از 0 باشد. کنش (action) می‌تواند یکی از موارد زیر باشد: feed_title، item_title (همراه با num par)، item_desc (همراه با num par) و item_titles (هنگام استفاده از این کنش و در صورت تعیین spaces_in_front، کانکی آن تعداد فاصله را در جلوی هر مورد قرار می‌دهد). این شیء به‌صورت چندریسمانی (threaded) کار می‌کند و پس از ایجاد یک ریسمان، نمی‌توان آن را به‌طور صریح نابود کرد. به ازای هر URI مشخص‌شده یک ریسمان اجرا خواهد شد. می‌توانید از هر پروتکلی که Curl پشتیبانی می‌کند استفاده کنید.
rstrip text: تمام فاصله‌های خالی انتهایی را از ورودی حذف می‌کند.
running_processes: فرایندهای در حال اجرا (نه در حال خواب). نیازمند لینوکس 2.6 است.
running_threads: تعداد ریسمان‌های در حال اجرا (قابل اجرا - runnable). تنها در لینوکس.
scroll (direction) length (step) (interval) text: پیمایش `text' به اندازه `step' نویسه به سمت چپ یا راست (تنظیم `direction' به `left' یا `right' یا `wait') در حالی که تعداد `length' نویسه به‌طور همزمان نمایش داده می‌شود. متن می‌تواند شامل متغیرها نیز باشد. مقدار `step' اختیاری است و در صورت عدم تنظیم، پیش‌فرض آن 1 است. مقدار `direction' اختیاری است و در صورت عدم تنظیم، پیش‌فرض آن left است. هنگامی که direction برابر `wait' باشد، متن به سمت چپ پیمایش می‌شود و در ابتدا و انتهای متن به اندازه `interval' تکرار درنگ می‌کند. اگر یک متغیر در چندین خط خروجی تولید کند، آن خطوط پشت سر یکدیگر و با علامت `|' از هم جدا می‌شوند. اگر رنگ متن (textcolor) را درون $scroll تغییر دهید، در انتهای $scroll به‌طور خودکار به مقدار قبلی خود بازمی‌گردد. پایان و آغاز متن به تعداد `length' فاصله از یکدیگر جدا خواهند شد، مگر اینکه direction برابر `wait' باشد.
seen_mails (maildir) (interval): تعداد نامه‌های علامت‌گذاری‌شده به عنوان دیده‌شده در صندوق پستی مشخص‌شده یا در صورت عدم تعیین، در mail spool. تنها صندوق‌های پستی نوع maildir پشتیبانی می‌شوند، نوع mbox مقدار -1 برمی‌گرداند.
shadecolor (color): تغییر رنگ سایه (shading color).
shmem: میزان حافظه اشتراکی. تنها در لینوکس.
sip_status (switch): اطلاعات مربوط به محافظت از یکپارچگی سیستم (System Integrity Protection یا SIP) در macOS را چاپ می‌کند. اگر هیچ سوییچی داده نشود، وضعیت SIP را چاپ می‌کند (فعال / غیرفعال)، در غیر این صورت، وضعیت ویژگی خاص SIP مربوط به سوییچ داده‌شده را چاپ می‌کند.

در زیر سوییچ‌های موجود نشان داده شده‌اند:

SWITCH	RESULT	STATUS
0	apple internal	YES/NO
1	forbid untrusted kexts	YES/NO
2	forbid task-for-pid	YES/NO
3	restrict filesystem	YES/NO
4	forbid kernel-debugger	YES/NO
5	restrict dtrace	YES/NO
6	restrict nvram	YES/NO
7	forbid device-configuration	YES/NO
8	forbid any-recovery-os	YES/NO
9	forbid user-approved-kexts	YES/NO

آیا از پیکربندی پشتیبانی‌نشده استفاده می‌کند؟: اگر بله، عبارت “unsupported configuration, beware!” و در غیر این صورت “configuration is ok” را چاپ می‌کند.

کاربرد (USAGE):

$ conky -t '${sip_status}'
# چاپ وضعیت SIP
$ conky -t '${sip_status 0}'
# چاپ اینکه آیا apple-internal مجاز است یا خیر؟ Yes یا No؟

نکات (NOTES):

برای تمامی نسخه‌های macOS در دسترس است (حتی نسخه‌های قبل از El Capitan که SIP برای اولین بار در آن معرفی شد)
در صورت اجرا روی نسخه‌های قبل از El Capitan، قابلیت SIP در دسترس نیست و در نتیجه فقط “unsupported” دریافت خواهید کرد.

smapi (ARGS): هنگام استفاده از smapi، محتوای دایرکتوری /sys/devices/platform/smapi را نمایش می‌دهد. شناسه‌های ARGS یا به‌صورت (FILENAME) یا bat (INDEX) (FILENAME) هستند تا محتوای فایل‌های مربوطه نمایش داده شود. این یک روش بسیار خام برای دسترسی به مقادیر smapi است. در صورت در دسترس بودن، بهتر است به‌جای آن از یکی از متغیرهای smapi_* استفاده کنید.
smapi_bat_bar (INDEX),(height),(width): هنگام استفاده از smapi، ظرفیت باقی‌مانده باتری با شاخص INDEX را به‌صورت یک نوار نمایش می‌دهد.
smapi_bat_perc (INDEX): هنگام استفاده از smapi، ظرفیت باقی‌مانده باتری با شاخص INDEX را برحسب درصد نمایش می‌دهد. این یک متغیر جداگانه است زیرا از گزینه پیکربندی `use_spacer' پشتیبانی می‌کند.
smapi_bat_power INDEX: هنگام استفاده از smapi، توان فعلی باتری با شاخص INDEX را برحسب وات نمایش می‌دهد. این یک متغیر جداگانه است زیرا مقدار خوانده‌شده اصلی از mW تبدیل می‌شود. علامت خروجی نشان‌دهنده وضعیت شارژ شدن (مثبت) یا تخلیه شارژ (منفی) است.
smapi_bat_temp INDEX: هنگام استفاده از smapi، دمای فعلی باتری با شاخص INDEX را برحسب درجه سلسیوس نمایش می‌دهد. این یک متغیر جداگانه است زیرا مقدار خوانده‌شده اصلی از میلی‌درجه سلسیوس تبدیل می‌شود.
sony_fanspeed: در صورت فعال بودن پشتیبانی کرنل sony-laptop، اطلاعات سرعت فن Sony VAIO را نمایش می‌دهد. فقط در لینوکس.
startcase text: حرف اول هر کلمه را به حروف بزرگ تبدیل می‌کند.
stippled_hr (space) (height) (width): خط افقی نقطه‌چین (خط‌چین).
stock symbol data: داده‌های یک نماد سهام را نمایش می‌دهد. داده‌های زیر پشتیبانی می‌شوند:

نام	توضیحات
1ytp	قیمت هدف ۱ ساله
200ma	میانگین متحرک ۲۰۰ روزه
50ma	میانگین متحرک ۵۰ روزه
52weekhigh
52weeklow
52weekrange
adv	میانگین حجم روزانه
ag	سود سالانه‌شده
ahcrt	تغییر پس از ساعات کاری به صورت بلادرنگ
ask
askrt	نرخ پیشنهادی فروش (Ask) به صورت بلادرنگ
asksize
bid
bidrt	نرخ پیشنهادی خرید (Bid) به صورت بلادرنگ
bidsize
bookvalue
c200ma	تغییر نسبت به میانگین متحرک ۲۰۰ روزه
c50ma	تغییر نسبت به میانگین متحرک ۵۰ روزه
c52whigh	تغییر نسبت به بالاترین قیمت ۵۲ هفته
c52wlow	تغییر نسبت به پایین‌ترین قیمت ۵۲ هفته
change
changert	تغییر به صورت بلادرنگ
cip	درصد تغییر
commission
cprt	درصد تغییر به صورت بلادرنگ
dayshigh
dayslow
dpd	تاریخ پرداخت سود سهام
dr	دامنه نوسان روز
drrt	دامنه نوسان روز به صورت بلادرنگ
ds	سود تقسیمی به ازای هر سهم
dvc	تغییر ارزش روز
dvcrt	تغییر ارزش روز به صورت بلادرنگ
dy	بازدهی سود سهام
ebitda
edv	تاریخ بدون حق سود سهام (Ex-Dividend)
ei	نشانگر خطا
epsecy	تخمین EPS سال جاری
epsenq	تخمین EPS سه‌ماهه آینده
epseny	تخمین EPS سال آینده
es	درآمد به ازای هر سهم (EPS)
floatshares
hg	سود دارایی‌ها
hgp	درصد سود دارایی‌ها
hgprt	درصد سود دارایی‌ها به صورت بلادرنگ
hgrt	سود دارایی‌ها به صورت بلادرنگ
hl	حد بالا
hv	ارزش دارایی‌ها
hvrt	ارزش دارایی‌ها به صورت بلادرنگ
ll	حد پایین
ltd	تاریخ آخرین معامله
ltp	قیمت آخرین معامله
lts	حجم آخرین معامله
ltt	زمان آخرین معامله
mc	ارزش کل بازار (Market Capitalization)
mcrt	ارزش بازار به صورت بلادرنگ
moreinfo
name
notes
obrt	دفتر سفارش‌ها به صورت بلادرنگ
open
pb	نسبت قیمت به ارزش دفتری (P/B)
pc	قیمت پایانی پیشین
pc200ma	درصد تغییر نسبت به میانگین متحرک ۲۰۰ روزه
pc50ma	درصد تغییر نسبت به میانگین متحرک ۵۰ روزه
pc52whigh	درصد تغییر نسبت به بالاترین قیمت ۵۲ هفته
pc52wlow	درصد تغییر نسبت به پایین‌ترین قیمت ۵۲ هفته
pegr	نسبت PEG
pepsecy	نسبت قیمت به تخمین EPS سال جاری
pepseny	نسبت قیمت به تخمین EPS سال آینده
per	نسبت P/E
perrt	نسبت P/E به صورت بلادرنگ
pricepaid
ps	نسبت قیمت به فروش (P/S)
se	بورس اوراق بهادار
sharesowned
shortratio
symbol
tradedate
tradelinks
tt	روند نماد (Ticker Trend)
volume

swap: میزان حافظه مبادله (swap) در حال استفاده.
swapbar (height),(width): نواری که میزان حافظه مبادله در حال استفاده را نمایش می‌دهد.
swapfree: میزان حافظه مبادله آزاد.
swapmax: میزان کل حافظه مبادله.
swapperc: درصد حافظه مبادله در حال استفاده.
sysctlbyname (name): چاپ مقدار sysctl بر اساس نام. فقط در FreeBSD.
sysname: نام سیستم، برای نمونه Linux.
tab (width, (start)): یک تب با عرض مشخص‌شده، با شروع از ستون `start` قرار می‌دهد. واحد هر دو آرگومان پیکسل است.
tail logfile lines (next_check): نمایش N خط آخر پرونده متنی ارائه‌شده. پرونده در هر به‌روزرسانی `next_check` بررسی می‌شود. اگر next_check مشخص نشود، Conky به صورت پیش‌فرض از ۲ استفاده می‌کند. حداکثر ۳۰ خط، یا تا زمانی که بافر متن پر شود، قابل نمایش است.
tcp_ping host (port): تعداد میکروثانیه‌های لازم برای دریافت پاسخ پینگ به پورت tcp در `host` را نمایش می‌دهد. آرگومان `port` اختیاری است و مقدار پیش‌فرض آن ۸۰ است. این متغیر هم روی پورت‌های باز و هم روی پورت‌های بسته کار می‌کند، فقط مطمئن شوید که پورت پشت فایروال قرار نداشته باشد، در غیر این صورت پاسخ `down` دریافت خواهید کرد. بهتر است به جای یک پورت باز، یک پورت بسته را آزمایش کنید، زیرا پاسخ سریع‌تری دریافت خواهید کرد.
tcp_portmon port_begin port_end item (index): مانیتور پورت TCP (هم IPv6 و هم IPv4) برای پورت‌های محلی مشخص‌شده. شماره پورت‌ها باید در محدوده ۱ تا ۶۵۵۳۵ باشند. موارد معتبر عبارتند از:

مورد	توضیحات
count	تعداد کل اتصالات در محدوده
rip	آدرس IP دوردست
rhost	نام هاست دوردست
rport	شماره پورت دوردست
rservice	نام سرویس دوردست از /etc/services
lip	آدرس IP محلی
lhost	نام هاست محلی
lport	شماره پورت محلی
lservice	نام سرویس محلی از /etc/services

اندیس اتصال دسترسی به هر اتصال را در مانیتور پورت فراهم می‌کند. مانیتور اطلاعات را برای مقادیر اندیس از ۰ تا n-1 اتصال بازمی‌گرداند. مقادیر بزرگ‌تر از n-1 نادیده گرفته می‌شوند. برای مورد count، اندیس اتصال باید حذف شود (ذکر نشود). برای سایر موارد، وجود آن الزامی است.

مثال‌ها:

مثال	توضیحات
${tcp_portmon 6881 6999 count}	تعداد اتصالات در محدوده پورت bittorrent را نمایش می‌دهد
${tcp_portmon 22 22 rip 0}	آدرس IP هاست دوردست اولین اتصال sshd را نمایش می‌دهد
${tcp_portmon 22 22 rip 9}	آدرس IP هاست دوردست دهمین اتصال sshd را نمایش می‌دهد
${tcp_portmon 1 1024 rhost 0}	نام هاست دوردست اولین اتصال روی یک پورت مجاز/ممتاز (privileged) را نمایش می‌دهد
${tcp_portmon 1 1024 rport 4}	پورت هاست دوردست پنجمین اتصال روی یک پورت مجاز/ممتاز را نمایش می‌دهد
${tcp_portmon 1 65535 lservice 14}	نام سرویس محلی پانزدهمین اتصال در محدوده تمام پورت‌ها را نمایش می‌دهد

توجه داشته باشید که متغیرهای مانیتور پورت که محدوده پورت یکسانی دارند در واقع به همان مانیتور اشاره می‌کنند، بنابراین ارجاعات متعدد به یک محدوده پورت واحد برای موارد و اندیس‌های مختلف همگی در درون برنامه از یک مانیتور استفاده می‌کنند. به عبارت دیگر، برنامه از ایجاد مانیتورهای زائد و تکراری جلوگیری می‌کند.

templateN (arg1) (arg2) (arg3 ...): محتوای متغیر پیکربندی templateN را (که در آن N مقداری بین ۰ و ۹ شامل خود آن‌ها است) ارزیابی کرده و جایگزینی‌ها را مطابق با آنچه در مستندات متغیر پیکربندی متناظر توضیح داده شده است اعمال می‌کند. تعداد آرگومان‌ها اختیاری است، اما باید با بالاترین اندیس ارجاع‌شده در قالب مطابقت داشته باشد. می‌توانید در هر آرگومان از همان دنباله‌های ویژه‌ای استفاده کنید که برای تعریف قالب معتبر هستند، برای نمونه جهت مجاز دانستن وجود فاصله در یک آرگومان. همچنین تودرتوسازی ساده قالب‌ها به این روش امکان‌پذیر است.

در اینجا چند مثال از تعاریف قالب آورده شده است، توجه داشته باشید که آن‌ها به جای ... بین [[ ... ]] قرار می‌گیرند:

template0 = [[$12]]
template1 = [[1: ${fs_used 2} / ${fs_size 2}]]
template2 = [[1 2]]

فهرست زیر کاربرد نمونه‌ای از قالب‌های تعریف‌شده در بالا را با نحو معادل در زمان عدم استفاده از هیچ قالبی نشان می‌دهد:

با استفاده از قالب	همان بدون قالب
${template0 node name}	$nodename
${template1 root /}	root: ${fs_free /} / ${fs_size /}
${template1 ${template2 disk root} /}	disk root: ${fs_free /} / ${fs_size /}
———————————————	——————————————

texeci interval command: دستوری را در یک بازه زمانی درون یک ریسه اجرا کرده و خروجی را نمایش می‌دهد. همانند $execi است، با این تفاوت که دستور درون یک ریسه اجرا می‌شود. اگر اسکریپتی کند دارید، برای تداوم به‌روزرسانی Conky از این متغیر استفاده کنید. باید بازه زمانی را کمی بیشتر از مدت‌زمان لازم برای اجرای اسکریپت خود در نظر بگیرید. برای مثال، اگر اسکریپتی دارید که اجرای آن ۵ ثانیه طول می‌کشد، باید بازه زمانی را حداقل ۶ ثانیه قرار دهید. همچنین $execi را ببینید. این شیء هنگام نابودی، ریسه مربوطه را پاکسازی می‌کند، بنابراین می‌توان با اطمینان از آن به شکل تودرتو استفاده کرد، هرچند ممکن است در صورت استفاده به این شکل، رفتار مطلوب حاصل نشود.
texecpi interval command: همانند execpi است، با این تفاوت که دستور درون یک ریسه اجرا می‌شود.
threads: تعداد کل ریسه‌ها.
time (format): زمان محلی، برای دریافت اطلاعات بیشتر درباره قالب، “man strftime” را ببینید.
to_bytes size: اگر `size` عددی باشد که در ادامه آن یک واحد اندازه (kilobyte، mb، GiB و...) آمده باشد، آنگاه اندازه را به بایت تبدیل کرده و آن را بدون واحد نمایش می‌دهد، در غیر این صورت فقط `size` را نشان می‌دهد.
top type num: این متغیر آرگومان‌هایی را به فرم top (name) (number) دریافت می‌کند. اساساً فرآیندها از بیشترین به کمترین میزان مصرف CPU رتبه‌بندی می‌شوند، که همان چیزی است که (num) نشان می‌دهد. انواع (type) عبارتند از: “name”، “pid”، “cpu”، “mem”، “mem_res”، “mem_vsize”، “time”، “uid”، “user”، “io_perc”، “io_read” و “io_write”. حداکثر ۱۰ فرآیند قابل فهرست شدن هستند.
top_io type num: همانند top است، با این تفاوت که بر اساس میزان ورودی/خروجی (I/O) انجام‌شده توسط فرآیند در طول بازه به‌روزرسانی مرتب می‌شود.
top_mem type num: همانند top است، با این تفاوت که به جای cpu، بر اساس میزان مصرف حافظه مرتب می‌شود.
top_time type num: همانند top است، با این تفاوت که به جای مصرف فعلی CPU، بر اساس کل زمان صرف‌شده در CPU مرتب می‌شود.
totaldown (net): کل بارگیری (دانلود)، در لینوکس با معماری ۳۲ بیتی در ۴ گیگابایت سرریز می‌کند و به نظر نمی‌رسد راهی وجود داشته باشد تا بدانیم پیش از شروع conky چند بار این اتفاق افتاده است.
totalup (net): کل بارگذاری (آپلود)، این مقدار نیز ممکن است سرریز کند.
trashed_mails (maildir) (interval): تعداد نامه‌های علامت‌گذاری‌شده به عنوان زباله (trashed) در صندوق پستی مشخص‌شده، یا در صورت عدم تعیین در mail spool. تنها صندوق‌های پستی از نوع maildir پشتیبانی می‌شوند؛ نوع mbox مقدار -1 را بازمی‌گرداند.
tztime (timezone (format)): زمان محلی برای منطقه زمانی مشخص‌شده، برای کسب اطلاعات بیشتر درباره قالب، man strftime را ببینید. آرگومان منطقه زمانی به شیوه‌ای مشابه متغیر محیطی TZ مشخص می‌شود. برای راهنمایی، به /usr/share/zoneinfo نگاه کنید. مانند US/Pacific، Europe/Zurich و غیره.
uid_name uid: نام کاربریِ کاربرِ دارای این uid.
unflagged_mails (maildir) (interval): تعداد نامه‌هایی که به عنوان نشانه‌دار (flagged) در صندوق پستی مشخص‌شده یا در صورت عدم تعیین در mail spool علامت‌گذاری نشده‌اند. تنها صندوق‌های پستی از نوع maildir پشتیبانی می‌شوند؛ نوع mbox مقدار -1 را بازمی‌گرداند.
unforwarded_mails (maildir) (interval): تعداد نامه‌هایی که به عنوان بازفرستاده‌شده (forwarded) در صندوق پستی مشخص‌شده یا در صورت عدم تعیین در mail spool علامت‌گذاری نشده‌اند. تنها صندوق‌های پستی از نوع maildir پشتیبانی می‌شوند؛ نوع mbox مقدار -1 را بازمی‌گرداند.
unreplied_mails (maildir) (interval): تعداد نامه‌هایی که به عنوان پاسخ‌داده‌شده (replied) در صندوق پستی مشخص‌شده یا در صورت عدم تعیین در mail spool علامت‌گذاری نشده‌اند. تنها صندوق‌های پستی از نوع maildir پشتیبانی می‌شوند؛ نوع mbox مقدار -1 را بازمی‌گرداند.
unseen_mails (maildir) (interval): تعداد نامه‌های جدید یا دیده‌نشده در صندوق پستی مشخص‌شده یا در صورت عدم تعیین در mail spool. تنها صندوق‌های پستی از نوع maildir پشتیبانی می‌شوند؛ نوع mbox مقدار -1 را بازمی‌گرداند.
updates Number of updates: جهت اشکال‌زدایی.
uppercase text: همه حروف را به حروف بزرگ انگلیسی تبدیل می‌کند.
upspeed (net): سرعت بارگذاری (آپلود) در واحدهای مناسب IEC.
upspeedf (net): سرعت بارگذاری بر حسب KiB با یک رقم اعشار.
upspeedgraph (netdev) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l) (-x) (-y) (-m): نمودار سرعت بارگذاری، رنگ‌ها با فرمت هگزادسیمال، بدون علامت # تعریف می‌شوند. اگر مقیاس (scale) غیر صفر باشد، حداکثر مقدار نمودار را (بر حسب بایت بر ثانیه) مشخص می‌کند. هنگام استفاده از سوییچ `-l` از یک مقیاس لگاریتمی (برای دیدن اعداد کوچک) استفاده می‌کند. سوییچ `-t` را برای استفاده از طیف دمایی دریافت می‌کند، که باعث می‌شود مقادیر طیف بسته به دامنه یک مقدار نموداریِ خاص تغییر کنند (امتحان کنید تا ببینید). فلگ `-x` محور x و `-y` محور y نمودار را معکوس می‌کند. فلگ `-m` یک حداقل/کران پایین غیر صفر را تنظیم می‌کند و اطمینان می‌دهد که تمام مقادیر حداقل برابر با حداقل مشخص‌شده باشند (به جز صفر).
uptime: مدت زمان کارکرد سیستم (Uptime).
uptime_short: مدت زمان کارکرد سیستم در قالبی کوتاه‌تر.
user_names: فهرست کردن نام‌های کاربرانی که وارد سیستم شده‌اند.
user_number: تعداد کاربرانی که وارد سیستم شده‌اند.
user_terms: کنسول‌های در حال استفاده را فهرست می‌کند.
user_time console: فهرست می‌کند که کاربر برای کنسول داده‌شده چه مدت وارد سیستم بوده است.
user_times: مدت زمانی را که کاربران وارد سیستم بوده‌اند فهرست می‌کند.
utime (format): نمایش زمان به وقت هماهنگ جهانی (UTC).
v6addrs (-n) (-s) (interface): آدرس‌های IPv6 برای یک رابط شبکه، که در صورت تعیین -n با netmask و در صورت تعیین -s با دامنه (scope) دنبال می‌شود. دامنه‌ها عبارتند از Global(G)، Host-local(H)، Link-local(L)، Site-local(S)، Compat(C) و Unspecified(/). فقط در لینوکس.
version: شماره نسخه گیت. فقط در DragonFly.
voffset (pixels): تغییر آفست عمودی به اندازه N پیکسل. مقادیر منفی باعث همپوشانی متن می‌شوند. همچنین $offset را ببینید.
voltage_mv (n): ولتاژ پردازنده شماره n را بر حسب میلی‌ولت (mV) بازمی‌گرداند. شمارش پردازنده‌ها از ۱ آغاز می‌شود.

پیش‌فرض: 1

voltage_v (n): ولتاژ پردازنده شماره n را بر حسب ولت (V) بازمی‌گرداند. شمارش پردازنده‌ها از ۱ آغاز می‌شود.

پیش‌فرض: 1

wireless_ap (net): آدرس MAC نقطه دسترسی بی‌سیم (Access Point). فقط در لینوکس.
wireless_bitrate (net): نرخ بیت بی‌سیم (برای نمونه 11 Mb/s). فقط در لینوکس.
wireless_channel (net): کانال WLAN که دستگاه `net` در آن در حال شنود است.
wireless_essid (net): شناسه ESSID نقطه دسترسی بی‌سیم. فقط در لینوکس.
wireless_freq (net): فرکانسی که دستگاه `net` در آن در حال شنود است.
wireless_link_bar (net) (height),(width): نوار کیفیت پیوند بی‌سیم. فقط در لینوکس.
wireless_link_qual (net): کیفیت پیوند بی‌سیم. فقط در لینوکس.
wireless_link_qual_max (net): حداکثر مقدار کیفیت پیوند بی‌سیم. فقط در لینوکس.
wireless_link_qual_perc (net): کیفیت پیوند بی‌سیم بر حسب درصد. فقط در لینوکس.
wireless_mode (net): حالت بی‌سیم (Managed/Ad-Hoc/Master). فقط در لینوکس.
words textfile: تعداد کلمات موجود در پرونده داده‌شده را نمایش می‌دهد.
xmms2_album: نام آلبوم در آهنگ جاری XMMS2.
xmms2_artist: نام هنرمند در آهنگ جاری XMMS2.
xmms2_bar (height),(width): نوار پیشرفت پخش XMMS2.
xmms2_bitrate: نرخ بیت (Bitrate) آهنگ جاری.
xmms2_comment: توضیحات (کامنت) در آهنگ جاری XMMS2.
xmms2_date: تاریخ آهنگ را بازمی‌گرداند.
xmms2_duration: مدت زمان آهنگ جاری.
xmms2_elapsed: زمان سپری‌شده از آهنگ.
xmms2_genre: سبک (ژانر) در آهنگ جاری XMMS2.
xmms2_id: شناسه XMMS2 آهنگ جاری.
xmms2_percent: درصد پیشرفت پخش آهنگ.
xmms2_playlist: فهرست پخش (Playlist) برنامه XMMS2 را بازمی‌گرداند.
xmms2_size: اندازه پرونده آهنگ جاری.
xmms2_smart: نام آهنگ را بسته به اطلاعات موجود، به یکی از دو صورت “artist - title” یا نام پرونده چاپ می‌کند.
xmms2_status: وضعیت XMMS2 (شامل Playing، Paused، Stopped، یا Disconnected).
xmms2_timesplayed: تعداد دفعاتی که یک آهنگ پخش شده است (احتمالاً).
xmms2_title: عنوان آهنگ در آهنگ جاری XMMS2.
xmms2_tracknr: شماره قطعه (Track) در آهنگ جاری XMMS2.
xmms2_url: مسیر کامل به آهنگ جاری.

رابط برنامه‌نویسی لوآ (LUA API)

کانکی از یک رابط برنامه‌نویسی (API) لوآ پشتیبانی می‌کند و همچنین به همراه بایندینگ‌های لوآ برای برخی کتابخانه‌های کاربردی عرضه می‌شود. توجه داشته باشید که این بایندینگ‌ها به tolua++ نیاز دارند.

برای استفاده از لوآ با کانکی، ابتدا مطمئن شوید که نسخه‌ای از کانکی با پشتیبانی فعال از لوآ را در اختیار دارید (دستور conky -v این موضوع را گزارش می‌دهد). کانکی توابع و متغیرهای سراسری خاصی را تعریف می‌کند که می‌توان از طریق کدهای لوآ در حال اجرا در کانکی به آن‌ها دسترسی پیدا کرد. اسکریپت‌ها ابتدا باید با استفاده از گزینه پیکربندی lua_load بارگذاری شوند. سپس می‌توانید توابع لوآ را از طریق $lua، $lua_read و قلاب‌های لوآ در کانکی فراخوانی کنید.

هنگام ایجاد اشیاء چندریسه‌ای (threaded) از طریق رابط برنامه‌نویسی لوآ دقت کنید. اگر با هر تکرار یک ریسه ایجاد شود، ممکن است در نهایت با تعداد بسیار زیادی از ریسه‌های در حال اجرا مواجه شوید.

توجه: جهت سازگاری با قابلیت‌های خاصی در رابط برنامه‌نویسی کتابخانه Cairo، کانکی چند تابع اضافی را برای ایجاد ساختارهای مشخصی صادر (export) می‌کند. این موارد در ادامه مستند شده‌اند.

RsvgDimensionData:create(): این متد را برای بازگرداندن یک ساختار جدید RsvgDimensionData فراخوانی کنید. تابعی برای ایجاد این ساختار توسط رابط برنامه‌نویسی Rsvg ارائه نشده است.

پس از فراخوانی این متد، باید از tolua.takeownership(rect) روی مقدار بازگشتی استفاده کنید تا اطمینان حاصل شود که مالکیت به درستی منتقل شده است.

RsvgDimensionData:destroy(): این متد را برای آزادسازی حافظه تخصیص‌یافته توسط RsvgDimensionData:create فراخوانی کنید.

برای جلوگیری از آزادسازی دوگانه حافظه (double-free)، باید پیش از فراخوانی این تابع، دستور tolua.releaseownership(dd) را فراخوانی کنید، البته فقط در صورتی که پیش‌تر tolua.takeownership(dd) را صدا زده باشید.

RsvgDimensionData:get(): مقادیر یک ساختار موجود RsvgDimensionData را دریافت می‌کند.
RsvgDimensionData:set(x, y, width, height): مقادیر یک ساختار موجود RsvgDimensionData را تنظیم می‌کند.
RsvgRectangle:create(): این متد را برای بازگرداندن یک ساختار جدید RsvgRectangle فراخوانی کنید. تابعی برای ایجاد این ساختار توسط رابط برنامه‌نویسی Rsvg ارائه نشده است.

RsvgRectangle:destroy(): این متد را برای آزادسازی حافظه تخصیص‌یافته توسط RsvgRectangle:create فراخوانی کنید.

برای جلوگیری از آزادسازی دوگانه حافظه (double-free)، باید پیش از فراخوانی این تابع، دستور tolua.releaseownership(rect) را فراخوانی کنید، البته فقط در صورتی که پیش‌تر tolua.takeownership(rect) را صدا زده باشید.

RsvgRectangle:get(): مقادیر یک ساختار موجود RsvgRectangle را دریافت می‌کند.
RsvgRectangle:set(x, y, width, height): مقادیر یک ساختار موجود RsvgRectangle را تنظیم می‌کند.
cairo_font_extents_t:create(): این تابع را برای بازگرداندن یک ساختار جدید cairo_font_extents_t فراخوانی کنید. تابعی برای ایجاد این ساختار توسط رابط برنامه‌نویسی cairo ارائه نشده است.

پس از فراخوانی این تابع، باید از tolua.takeownership(cfe) روی مقدار بازگشتی استفاده کنید تا اطمینان حاصل شود که مالکیت به درستی منتقل شده است.

cairo_font_extents_t:destroy(structure): این تابع را برای آزادسازی حافظه تخصیص‌یافته توسط cairo_font_extents_t:create فراخوانی کنید.

برای جلوگیری از آزادسازی دوگانه حافظه (double-free)، باید پیش از فراخوانی این تابع، دستور tolua.releaseownership(cfe) را فراخوانی کنید، البته فقط در صورتی که پیش‌تر tolua.takeownership(cfe) را صدا زده باشید.

cairo_matrix_t:create(): این تابع را برای بازگرداندن یک ساختار جدید cairo_matrix_t فراخوانی کنید. تابعی برای ایجاد این ساختار توسط رابط برنامه‌نویسی cairo ارائه نشده است.

پس از فراخوانی این تابع، باید از tolua.takeownership(cm) روی مقدار بازگشتی استفاده کنید تا اطمینان حاصل شود که مالکیت به درستی منتقل شده است.

cairo_matrix_t:destroy(structure): این تابع را برای آزادسازی حافظه تخصیص‌یافته توسط cairo_matrix_t:create فراخوانی کنید.

برای جلوگیری از آزادسازی دوگانه حافظه (double-free)، باید پیش از فراخوانی این تابع، دستور tolua.releaseownership(cm) را فراخوانی کنید، البته فقط در صورتی که پیش‌تر tolua.takeownership(cm) را صدا زده باشید.

cairo_place_image(file, cr, x, y, width, height, alpha): تصویری را با استفاده از imlib2 بر روی یک cairo_t رندر می‌کند. در برخی موارد، استفاده از یک cairo_t و مختصات دقیق سودمندتر است.

آرگومان	توضیحات
file	مسیر تصویری که باید رندر شود.
cr	ساختار cairo_t که رندر روی آن انجام می‌شود.
x,y	موقعیت رسم تصویر.
width, height	عرض و ارتفاع برای رسم تصویر.
alpha	میزان شفافیت تصویر؛ 1.0 کاملاً مات و 0.0 کاملاً شفاف است.

دستور require(`cairo_imlib2_helper') را در فایل لوآی خود وارد کنید.

cairo_text_extents_t:create(): این تابع را برای بازگرداندن یک ساختار جدید cairo_text_extents_t فراخوانی کنید. تابعی برای ایجاد این ساختار توسط رابط برنامه‌نویسی cairo ارائه نشده است.

پس از فراخوانی این تابع، باید از tolua.takeownership(cte) روی مقدار بازگشتی استفاده کنید تا اطمینان حاصل شود که مالکیت به درستی منتقل شده است.

cairo_text_extents_t:destroy(structure): این تابع را برای آزادسازی حافظه تخصیص‌یافته توسط cairo_text_extents_t:create فراخوانی کنید.

برای جلوگیری از آزادسازی دوگانه حافظه (double-free)، باید پیش از فراخوانی این تابع، دستور tolua.releaseownership(cte) را فراخوانی کنید، البته فقط در صورتی که پیش‌تر tolua.takeownership(cte) را صدا زده باشید.

conky_build_arch: رشته‌ای حاوی معماری ساخت این نمونه از کانکی.
conky_build_info: رشته‌ای حاوی اطلاعات ساخت این نمونه از کانکی، شامل نسخه، تاریخ ساخت و معماری.
conky_config: رشته‌ای حاوی مسیر فایل پیکربندی فعلی کانکی.
conky_info: این جدول حاوی اطلاعاتی درباره داده‌های داخلی کانکی است. جدول زیر مقادیر موجود در آن را شرح می‌دهد:

کلید	مقدار
update_interval	فاصله زمانی به‌روزرسانی کانکی (به ثانیه).

conky_parse(string): این تابع رشته‌ای را دریافت می‌کند که مطابق با بخش TEXT کانکی ارزیابی می‌شود، و سپس رشته‌ای حاوی نتیجه را بازمی‌گرداند.
conky_set_update_interval(number): فاصله زمانی به‌روزرسانی کانکی (به ثانیه) را روی `number' تنظیم می‌کند.
conky_surface(): ساختار cairo_surface_t فعلی را برای خروجی نمایشگر فعال بازمی‌گرداند، یا اگر سطح گرافیکی در دسترس نباشد مقدار nil برمی‌گرداند. این روش، راهکار ترجیحی و مستقل از بک‌اند برای به‌دست آوردن سطح رسم جهت استفاده با Cairo است.

سطح بازگردانده‌شده فقط برای چرخه رسم فعلی معتبر است. آن را در فریم‌های مختلف کَش (ذخیره) نکنید؛ هر بار که قلاب رسم شما فراخوانی می‌شود، تابع conky_surface() را فراخوانی کنید.

نمونه استفاده:

require('cairo')
function conky_draw()
  local surface = conky_surface()
  if not surface then return end
  local cr = cairo_create(surface)
  -- draw ...
  cairo_destroy(cr)
end

conky_version: رشته‌ای حاوی نسخه نمونه فعلی کانکی.
conky_window: این جدول شامل اطلاعات فقط‌خواندنی درباره پنجره کانکی است. جدول زیر مقادیر موجود را شرح می‌دهد:

کلید	مقدار
drawable	منسوخ شده. شیء ترسیم‌پذیر پنجره (Xlib Drawable). به جای آن از conky_surface() استفاده کنید.
visual	منسوخ شده. ساختار دیداری پنجره (Xlib Visual). به جای آن از conky_surface() استفاده کنید.
display	منسوخ شده. نمایشگر پنجره (Xlib Display). به جای آن از conky_surface() استفاده کنید.
width	عرض پنجره بر حسب نقاط چیدمان (pt؛ منطقی).
height	ارتفاع پنجره بر حسب نقاط چیدمان (pt؛ منطقی).
pixel_size.x	عرض پنجره بر حسب پیکسل‌های دستگاه (px؛ فیزیکی).
pixel_size.y	ارتفاع پنجره بر حسب پیکسل‌های دستگاه (px؛ فیزیکی).
scale	ضریب مقیاس‌بندی بافر (dpi؛ نسبت pixel_size به size).
border_inner_margin	حاشیه درونی کادر پنجره (به پیکسل).
border_outer_margin	حاشیه بیرونی کادر پنجره (به پیکسل).
border_width	عرض کادر پنجره (به پیکسل).
text_start_x	مؤلفه x از مختصات شروع رسم متن.
text_start_y	مؤلفه y از مختصات شروع رسم متن.
text_width	عرض ناحیه رسم متن.
text_height	ارتفاع ناحیه رسم متن.

نکته: این جدول فقط زمانی تعریف می‌شود که یک خروجی رابط کاربری گرافیکی (GUI) فعال باشد. فیلدهای drawable، visual و display مختص X11 بوده و منسوخ شده‌اند.

ret_scale_x,ret_scale_y:cairo_draw_image(file, cs, x, y, scale_x, scale_y): تصویری را با استفاده از imlib2 بر روی یک cairo_surface_t رندر می‌کند. میزان مقیاس‌بندی اعمال‌شده روی تصویر را بازمی‌گرداند.

آرگومان	توضیحات
file	مسیر تصویری که باید رندر شود.
cs	ساختار cairo_surface_t که رندر روی آن انجام می‌شود.
x,y	موقعیت رسم تصویر.
scale_x, scale_y	میزان مقیاس‌بندی تصویر؛ مقدار 1.0 بدون تغییر مقیاس، مقدار 2.0 برای دو برابر اندازه و
	0.5 برای نصف اندازه و غیره. مقدار پیش‌فرض: بدون مقیاس‌بندی (1.0,1.0)

دستور require(`cairo_imlib2_helper') را در فایل لوآی خود وارد کنید.

cairo_text_hp_show(cr, x, y, text, font, font_size, alignment, language, script, direction): متن را با استفاده از HarfBuzz و FreeType بر روی یک cairo_t رندر می‌کند. این روش رندر متن را بسیار باکیفیت‌تر از توابع داخلی Cairo انجام می‌دهد.

آرگومان	توضیحات
cr	ساختار cairo_t که رندر روی آن انجام می‌شود.
x,y	موقعیت رسم متن.
text	متنی که باید رندر شود.
font	نام قلمی (فونتی) که باید استفاده شود؛ برای جستجوی قلم از Fontconfig استفاده می‌شود.
font_size	اندازه قلم (فونت).
alignment	یکی از مقادیر CAIRO_TEXT_ALIGN_LEFT، CAIRO_TEXT_ALIGN_RIGHT یا CAIRO_TEXT_ALIGN_CENTER. مقدار پیش‌فرض: CAIRO_TEXT_ALIGN_LEFT
language	رشته‌ای حاوی برچسب زبان BCP 47. مقدار پیش‌فرض: en
script	رشته‌ای حاوی برچسب خط ISO 15924. مقدار پیش‌فرض: تشخیص خودکار از روی متن
direction	رشته‌ای نشان‌دهنده جهت متن مانند LTR، RTL یا TTB. مقدار پیش‌فرض: تشخیص خودکار از روی متن، در غیر این صورت LTR

width,height:cairo_text_hp_text_size(text, font, font_size, language, script, direction): برای محاسبه تعداد پیکسل‌های مورد نیاز برای رندر یک رشته با تابع cairo_text_hp_show استفاده می‌شود و یک جفت عدد صحیح شامل width و height را بازمی‌گرداند.

آرگومان	توضیحات
cr	ساختار cairo_t که رندر روی آن انجام می‌شود.
text	متنی که باید رندر شود.
font	نام قلمی (فونتی) که باید استفاده شود؛ برای جستجوی قلم از Fontconfig استفاده می‌شود.
font_size	اندازه قلم (فونت).
language	رشته‌ای حاوی برچسب زبان BCP 47. مقدار پیش‌فرض: en
script	رشته‌ای حاوی برچسب خط ISO 15924. مقدار پیش‌فرض: تشخیص خودکار از روی متن
direction	رشته‌ای نشان‌دهنده جهت متن مانند LTR، RTL یا TTB. مقدار پیش‌فرض: تشخیص خودکار از روی متن، در غیر این صورت LTR

cairo_text_hp_delete_fonts(): هر دو تابع cairo_text_hp_show و cairo_text_hp_text_size جزئیات داخلی قلم را کَش (ذخیره موقت) می‌کنند؛ این تابع آن حافظه‌های موقت را پاکسازی می‌کند.

مثالها (EXAMPLES)

conky -t '${time %D %H:%M}' -o -u 30: اجرای Conky در پنجره اختصاصی خود با نمایش تاریخ و ساعت به صورت متنی و بازه به‌روزرسانی ۳۰ ثانیه‌ای.
conky -a top_left -x 5 -y 500 -d: اجرای Conky در پس‌زمینه در مختصات (5, 500).
conky -C > ~/.config/conky/conky.conf: برنامه Conky را اجرا نمی‌کند، بلکه فایل پیکربندی پیش‌فرض داخلی را در مسیر ~/.config/conky/conky.conf برای سفارشی‌سازی‌های بعدی خروجی می‌دهد.

فایلها (FILES)

${sysconfdir}/conky/conky.conf: فایل پیکربندی پیش‌فرض سراسری سیستم. مقدار ${sysconfdir} به گزینه‌های زمان کامپایل بستگی دارد (به احتمال زیاد /etc).
~/.config/conky/conky.conf: فایل پیکربندی پیش‌فرض شخصی.

اشکالات (BUGS)

رسم مستقیم روی پنجره ریشه (root) یا برخی پنجره‌های دیگر میزکار با تمام مدیرهای پنجره کار نمی‌کند. به‌ویژه با Gnome به خوبی کار نمی‌کند و گزارش شده است که با KDE نیز کار نمی‌کند. می‌توان از رسم Nautilus روی میزکار با برنامه gconf-editor جلوگیری کرد. گزینه show_desktop را در مسیر /apps/nautilus/preferences/ غیرفعال کنید. در Conky سوییچ -w برای تنظیم یک شناسه پنجره مشخص وجود دارد. ممکن است دستور xwininfo -tree برای یافتن پنجره‌ای که می‌خواهید روی آن رسم کنید مفید باشد. همچنین می‌توانید از آرگومان -o استفاده کنید که باعث می‌شود Conky پنجره اختصاصی خود را ایجاد کند. اگر اجرای Conky در پنجره اختصاصی خود را امتحان می‌کنید، حتماً درباره تنظیمات own_window_type مطالعه کرده و آن را بیازمایید.

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

https://github.com/brndnmtthws/conky

کپیرایت و تکثیر (COPYING)

کپی‌رایت (c) 2005-2026 Brenden Matthews، Philip Kovacs و دیگران. هرگونه کد اصلی torsmo تحت مجوز BSD منتشر شده است (برای دریافت یک نسخه، فایل LICENSE.BSD را ببینید). تمامی کدهای نوشته‌شده از زمان انشعاب (fork) torsmo تحت مجوز GPL منتشر شده‌اند (برای دریافت یک نسخه، فایل LICENSE.GPL را ببینید)، مگر در مواردی که به صورت متفاوت ذکر شده باشد (مانند کدهای portmon و audacious که تحت مجوز LGPL هستند، و prss که دارای مجوزی از نوع MIT است).

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

تیم توسعه Conky (برای مشاهده فهرست کامل مشارکت‌کنندگان فایل AUTHORS را ببینید).

2026-09-04