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 YES/NO kexts 2 forbid task-for-pid YES/NO 3 restrict filesystem YES/NO 4 forbid YES/NO kernel-debugger 5 restrict dtrace YES/NO 6 restrict nvram YES/NO 7 forbid YES/NO device-configuration 8 forbid YES/NO any-recovery-os 9 forbid YES/NO user-approved-kexts آیا از پیکربندی پشتیبانی‌نشده استفاده می‌کند؟: اگر بله، عبارت “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 تعداد اتصالات در محدوده پورت bittorrent را نمایش 6999 count} می‌دهد ${tcp_portmon 22 22 آدرس IP هاست دوردست اولین اتصال sshd را نمایش rip 0} می‌دهد ${tcp_portmon 22 22 آدرس IP هاست دوردست دهمین اتصال sshd را نمایش rip 9} می‌دهد ${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 ارائه نشده است. پس از فراخوانی این متد، باید از tolua.takeownership(rect) روی مقدار بازگشتی استفاده کنید تا اطمینان حاصل شود که مالکیت به درستی منتقل شده است. 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, میزان مقیاس‌بندی تصویر؛ مقدار 1.0 بدون تغییر مقیاس، مقدار scale_y 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 conky(1)