Difference between revisions of "Basic Tips for conky"

Updated style
(fix missing lua semantics)
(Updated style)
Line 1: Line 1:
<languages/>
__TOC__
__TOC__
==Installation==
{{SectionTemplate|<translate>Installation</translate>|<translate>Conky can be installed using the package manager</translate>
Conky can be installed using the package manager
{{UserCmd|command=pamac install conky}}}}
{{UserCmd|command=pamac install conky}}


==Configuration==
{{SectionTemplate|<translate>Configuration</translate>|
All file names starting with a dot <code>.</code> are hidden files. If you want to see hidden files in your file manager, you need to make them visible. In most file managers this will be available in the options.
<translate>All file names starting with a dot <code>.</code> are hidden files. If you want to see hidden files in your file manager, you need to make them visible. In most file managers this will be available in the options.
 
</translate>
===Configuration file===
{{SubContentTemplate|<translate>Configuration file</translate>|
<translate>
The default configuration file is located in <code>/usr/share/doc/conky-1.11.5_pre/conky.conf</code> where version are subject to change.  
The default configuration file is located in <code>/usr/share/doc/conky-1.11.5_pre/conky.conf</code> where version are subject to change.  
Conky do not create a local conky folder so you will have to create beforehand
Conky do not create a local conky folder so you will have to create beforehand
Line 17: Line 18:
* Configuration
* Configuration
* Text
* Text
</translate>|4=1}}


===Conky configuration===
{{SubContentTemplate|<translate>Conky configuration</translate>|
<translate>
The first/upper part contains all the configuration settings for the entire conky. Things like the position of the conky on your screen, transparency settings, border settings, the default font and it's size, and how often your conky gets updated. The whole configuration belong between brackets like this
The first/upper part contains all the configuration settings for the entire conky. Things like the position of the conky on your screen, transparency settings, border settings, the default font and it's size, and how often your conky gets updated. The whole configuration belong between brackets like this
{{File|file=~/.config/conky/conky.conkyrc|
{{File|file=~/.config/conky/conky.conkyrc|
Line 29: Line 32:
* Non-boolean/numerical value should be placed between <code>'</code>
* Non-boolean/numerical value should be placed between <code>'</code>
* Comment start with <code>--</code>
* Comment start with <code>--</code>
</translate>
|4=1}}


====Examples====
 
}}
{{SectionTemplate|<translate>Examples</translate>|
<translate>
'''1.''' This will set the default font color of your conky to white. Additionally, a <code>color1</code> gets set using a [http://html-color-codes.info/ Html Color Code]to a light blue:
'''1.''' This will set the default font color of your conky to white. Additionally, a <code>color1</code> gets set using a [http://html-color-codes.info/ Html Color Code]to a light blue:
{{File|file=~/.config/conky/conky.conkyrc|
{{File|file=~/.config/conky/conky.conkyrc|
Line 68: Line 76:
}}
}}
Use the command: <code>man conky</code>, and look into the '''CONFIGURATION SETTINGS''' section to see every settings available.
Use the command: <code>man conky</code>, and look into the '''CONFIGURATION SETTINGS''' section to see every settings available.
</translate>
}}


===Conky text===
{{SectionTemplate|<translate>Conky text</translate>|
<translate>
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: <code>man conky</code>, and look into the '''OBJECTS/VARIABLES''' section to see every objects/variables available.
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: <code>man conky</code>, 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.}}
{{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.}}
Line 78: Line 89:
]];</pre>
]];</pre>
}}
}}
 
</translate>}}
====Examples====
{{SectionTemplate|<translate>Examples</translate>|
<translate>
'''1.''' You can choose the color of your font using one of the following variables:
'''1.''' You can choose the color of your font using one of the following variables:
{{File|file=~/.config/conky/conky.conkyrc|
{{File|file=~/.config/conky/conky.conkyrc|
Line 132: Line 144:
]];</pre>
]];</pre>
}}
}}
=====execi=====
</translate>
}}
 
{{SectionTemplate|<translate>execi</translate>|
<translate>
The variable <code>${execi 3600 XXXX}</code> runs the <code>XXXX</code> bash code in your terminal every 3600 seconds and displays the result in your conky. The result of the <code>uname -r</code> bash command is your currently used kernel name.  
The variable <code>${execi 3600 XXXX}</code> runs the <code>XXXX</code> bash code in your terminal every 3600 seconds and displays the result in your conky. The result of the <code>uname -r</code> bash command is your currently used kernel name.  


Line 138: Line 154:


Warning: Using complicated bash commands (e.g. which call other programs or use large files) with low intervals (e.g. <code>${execi 2 XXXX}</code> runs the <code>XXXX</code> 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.
Warning: Using complicated bash commands (e.g. which call other programs or use large files) with low intervals (e.g. <code>${execi 2 XXXX}</code> runs the <code>XXXX</code> 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.
</translate>}}


==Running conky==
{{SectionTemplate|<translate>Running conky</translate>|
<translate>
If you want to display a conky on your desktop a {{ic|~/.config/conky/conky.conkyrc}} file with code in it is required. Next, open a terminal and run conky pointing to the file
If you want to display a conky on your desktop a {{ic|~/.config/conky/conky.conkyrc}} file with code in it is required. Next, open a terminal and run conky pointing to the file
{{UserCmd|command=conky -c ~/.config/conky/conky.conkyrc}}
{{UserCmd|command=conky -c ~/.config/conky/conky.conkyrc}}
Line 153: Line 171:
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
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
{{UserCmd|command=killall conky && conky -c ~/.config/config/conky.conkyrc}}
{{UserCmd|command=killall conky && conky -c ~/.config/config/conky.conkyrc}}
</translate>}}


==Troubleshooting & Tips==
{{SectionTemplate|<translate>Troubleshooting & Tips</translate>|


===Missing rings===
{{SubContentTemplate|<translate>Missing rings</translate>|
<translate>
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 {{ic|conky-lua}} from [[Arch_User_Repository|AUR]] or install the {{ic|conky-lua-nv}} from the official repo.
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 {{ic|conky-lua}} from [[Arch_User_Repository|AUR]] or install the {{ic|conky-lua-nv}} from the official repo.
</translate>
|4=1}}


==Missing network information==
{{SubContentTemplate|<translate>Missing network information</translate>|
<translate>
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
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
{{UserCmd|command=ip a | grep ' state UP' | cut -d' ' -f2 | cut -d':' -f1}}
{{UserCmd|command=ip a | grep ' state UP' | cut -d' ' -f2 | cut -d':' -f1}}
Use the output from the command. Interface names starting with <code>en</code> is ethernet interface and names starting with <code>wl</code> is wireless interfaces. Replace all network interfaces names with (e.g. <code>wlan0</code>, <code>eth0</code>) in your <code>.conkyrc</code> text section with the interface name(s) you retrieved from the above command.
Use the output from the command. Interface names starting with <code>en</code> is ethernet interface and names starting with <code>wl</code> is wireless interfaces. Replace all network interfaces names with (e.g. <code>wlan0</code>, <code>eth0</code>) in your <code>.conkyrc</code> text section with the interface name(s) you retrieved from the above command.
</translate>
|4=1}}
}}


==Conky Manager==
{{SectionTemplate|<translate>Conky Manager</translate>|
<translate>
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 {{ic|conky-manager}} using [[Arch_User_Repository|AUR]]
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 {{ic|conky-manager}} using [[Arch_User_Repository|AUR]]
</translate>
{{UserCmd|command=pamac build conky-manager}}
{{UserCmd|command=pamac build conky-manager}}
}}


==See Also==
{{SectionTemplate|<translate>See Also</translate>|
 
* The [https://github.com/brndnmtthws/conky/wiki Conky website]
* The [https://github.com/brndnmtthws/conky/wiki Conky website]
* The [https://wiki.archlinux.org/index.php/conky Arch Wiki] page for Conky
* The [https://wiki.archlinux.org/index.php/conky Arch Wiki] page for Conky|Chmsee-icon.png}}


[[Category:Contents Page]]
[[Category:Contents Page{{#translation:}}]]