نکات اساسی برای کانکی

This page is a translated version of the page Basic Tips for conky and the translation is 22% complete.
Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎português do Brasil • ‎русский • ‎فارسی

نصب و راه‌اندازی

کانکی را می توان با استفاده از مدیربسته نصب کرد:

user $ pamac install conky COPY TO CLIPBOARD


پیکربندی

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

پرونده‌های پیکربندی

فایل تنظیمات پیش فرض در این مکان قرار دارد /usr/share/doc/conky-1.11.5_pre/conky.conf کانکی به راحتی قابل تغییر است. کانکی یک پوشه کانکی محلی ایجاد نمی کند، بنابراین باید خودتان یکی ایجاد کنید

user $ mkdir -p ~/.config/conky COPY TO CLIPBOARD

سپس پرونده پیش‌فرض را در home/ کپی کنید

user $ cp /usr/share/doc/conky-1.11.5_pre/conky.conf ~/.config/conky/conky.conkyrc COPY TO CLIPBOARD


فایل پیکربندی یک فایل متنی ساده است که محتوای آن با استفاده از لوآ نوشته شده است و به دو بخش تقسیم می شود.

  • پیکربندی
  • متن

پیکربندی کانکی

قسمت اول/بالا شامل تمام تنظیمات پیکربندی برای کل کانکی است. مواردی مانند موقعیت کانکی روی صفحه، تنظیمات شفافیت، تنظیمات حاشیه، فونت پیش‌فرض و اندازه آن، و تعداد دفعات به‌روزرسانی مخزن شما. کل پیکربندی بین براکت هایی مانند این تعلق دارد

~/.config/conky/conky.conkyrc
conky.config = { };

برخی از قوانین باید رعایت شوند :

  • هر خط با , پایان می‌یابد
  • مقدار غیرعددی باید بین ' قرار گیرد
  • نظر، یا کامنت، با -- شروع می‌شود

1. با این کار رنگ فونت پیش‌فرض کانکی شما روی سفید تنظیم می‌شود. علاوه بر این، یک color1 با استفاده از یک کد رنگ Html روی آبی روشن تنظیم می شود:

~/.config/conky/conky.conkyrc
conky.config = {
...
 default_color = 'white',
 -- White defaul
 color color1 = '0ab1ff',
 -- Light blue 
... 
};

2. این Xft را فعال می کند، فونت پیش‌فرض را تنظیم می کند (LiberationMono)، آن را پررنگ می‌کند و اندازه آن را تنظیم می‌کند (8):

~/.config/conky/conky.conkyrc
conky.config = { ... use_xft = true, font = 'LiberationMono:bold:size=8', ... };

3. برای اینکه کانکی خود را روی صفحه‌نمایش قرار دهید، این تنظیمات را تغییر دهید:

~/.config/conky/conky.conkyrc
conky.config = { ... alignment = 'top_right', -- Conky gets placed in the top right corner of your desktop gap_x 18, -- with a horizontal gap of 18 pixels (to your right screen edge) gap_y 20, -- and a vertical gap of 20 pixels (to your top screen edge). ...};

4. در برخی موارد می توانید چندین مقدار برای یک تنظیم داشته باشید، آنها با کاما از هم جدا می شوند:

~/.config/conky/conky.conkyrc
conky.config = { ... own_window_hints = 'undecorated,sticky,skip_taskbar,skip_pager,below', ... };

از دستور man conky استفاده کنید و به بخش CONFIGURATION SETTINGS نگاه کنید تا همه تنظیمات موجود را ببینید.

Conky text

The second part contains the displayed conky code. Every code line corresponds to one displayed line on your desktop. There are a lot of available for displaying and modifying all kinds of information. Use the command: man conky, and look into the OBJECTS/VARIABLES section to see every objects/variables available.

Info
The lines in the conky.text section is printed exactly as is. E.g. if you create an empty line between sections - conky will display an empty line.

The whole code belong between these two double bracket:

~/.config/conky/conky.conf
conky.text = [[
]];

Examples

1. You can choose the color of your font using one of the following variables:

~/.config/conky/conky.conf
conky.text = [[
...
${color}
${color1}
...
]];

Every variable is marked with a $ sign and by { } brackets (only needed, if the variable contains more than one word).

2. You can call the default font (and it's size) with this command:

~/.config/conky/conky.conf
conky.text = [[
...
$font
...
]];

If you want a different font (DejaVuSerif) and font size (9) in your conky, use this command in your .conf code:

~/.config/conky/conky.conf
conky.text = [[
...
${font DejaVuSerif:size=9}
...
]];

3. This code line displays the text "Kernel: " and the kernel you are using (using $alignr just yields a nicer formatting, it is not necessary: $alignr aligns all following text on the right of your conky):

~/.config/conky/conky.conf
conky.text = [[
Kernel: ${alignr}${kernel}
]];

4. This variable gives you the latest 3 manjaro blog entry titles (using rss). It checks for updates every 60 minutes.

~/.config/conky/conky.conf
conky.text = [[
${rss http://manjaro.org/feed/ 60 item_titles 3}
]];

5. Information about the root partition / of your manjaro installation is displayed using

~/.config/conky/conky.conf
conky.text = [[
Root: ${alignr}${fs_used /} of ${fs_size /}
]];

6. Instead of example 3, you can use the following code to display the exact same information:

~/.config/conky/conky.conf
conky.text = [[
Kernel: ${alignr}${execi 3600 uname -r}
]];

execi

The variable ${execi 3600 XXXX} runs the XXXX bash code in your terminal every 3600 seconds and displays the result in your conky. The result of the uname -r bash command is your currently used kernel name.

Use any bash command instead of XXXX you can think of. The bash commands can be as long and complicated as you want.

Warning
Using complicated bash commands (e.g. which call other programs or use large files) with low intervals (e.g. ${execi 2 XXXX} runs the XXXX code once every 2 seconds and displays it's result in your conky) can use a lot of hardware resources and/or make your computer unresponsive.

Running conky

If you want to display a conky on your desktop a ~/.config/conky/conky.conf file with code in it is required. Next, open a terminal and run conky pointing to the file

user $ conky -c ~/.config/conky/conky.conf COPY TO CLIPBOARD

or to run as background daemon

user $ conky -d -c ~/.config/conky/conky.conf COPY TO CLIPBOARD


If you want to run conky automatically after each boot of your computer, you need to find out how to autostart a program. This depends on the Desktop Manager you are using. The next is examples of how to run conky from your system autostart folder/file/script/command. sleep 20 and -p 20 delay the start of conky by 20 seconds after your Desktop Environment has started. Adjust this value to your liking.

user $ conky -c ~/.config/conky/conky.conf & COPY TO CLIPBOARD

user $ sleep 20 && conky -c ~/.config/conky/conky.conf & COPY TO CLIPBOARD


When you change the running conky configuration file - conky will reload. But if you changed one of your dependency scripts (e.g. because you changed a variable and want to see the consequences) you will have to reload conky

user $ killall conky && conky -c ~/.config/config/conky.conf COPY TO CLIPBOARD

اشکال‌زدایی و نکته‌ها

Missing rings

To be able to use LUA scripts to execute drawing functions like clock rings - you will a conky package compiled with LUA support. Either build the package the package conky-lua from AUR or install the conky-lua-nv from the official repo.

Missing network information

If network information is missing like download speed or network name (SSID), you need to replace the network interfaces in the configuration file with your network interface name. To get the names of your interfaces - open a terminal and execute

user $ ip a COPY TO CLIPBOARD

Use the output from the command. Interface names starting with en is ethernet interface and names starting with wl is wireless interfaces. Replace all network interfaces names with (e.g. wlan0, eth0) in your .conf text section with the interface name(s) you retrieved from the above command.

Conky Manager

An application named Conky manager exist but has not been updated for years and the configurations found in the package may work or they may not. You may install it - it can be a used as an inspiration but you should not rely on it. If you still think you it is a must have - you can build the package conky-manager using AUR

user $ pamac build conky-manager COPY TO CLIPBOARD

جستارهای وابسته