Difference between revisions of "Basic Tips for conky"
General clean-up, remove outdated links/references, formatting
imported>Yoy0 |
imported>Dalto (General clean-up, remove outdated links/references, formatting) |
||
| Line 1: | Line 1: | ||
__TOC__ | __TOC__ | ||
=Installation= | =Installation= | ||
Conky can be installed with this command: | Conky can be installed with this command: | ||
pamac install conky | |||
=Configuration= | |||
==Configuration file== | |||
Default Conky configuration file is located in: | Default Conky configuration file is located in: | ||
~/.config/conky/conky.conf | ~/.config/conky/conky.conf | ||
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 | 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. | ||
<code>conky.conf</code> can be edited with every text editor. It's code is split into two parts: | <code>conky.conf</code> can be edited with every text editor. It's code is split into two parts: | ||
==First Part - Window/Conky configuration== | ==First Part - Window/Conky configuration== | ||
| Line 26: | Line 27: | ||
conky.config = { | conky.config = { | ||
} | } | ||
Some rules to respect: | Some rules to respect: | ||
| Line 33: | Line 35: | ||
Comment start with <code>--</code> | Comment start with <code>--</code> | ||
===Examples:=== | ===Examples:=== | ||
'''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: | ||
conky.config = { | conky.config = { | ||
| Line 40: | Line 44: | ||
color1 = '0ab1ff', -- Light blue | color1 = '0ab1ff', -- Light blue | ||
} | } | ||
'''2.''' This enables Xft, set the default font (LiberationMono), make it bold and set it's size (8): | '''2.''' This enables Xft, set the default font (LiberationMono), make it bold and set it's size (8): | ||
conky.config = { | conky.config = { | ||
| Line 45: | Line 50: | ||
font = 'LiberationMono:bold:size=8', | font = 'LiberationMono:bold:size=8', | ||
} | } | ||
'''3.''' In order to position your conky on your screen, modify these settings: | '''3.''' In order to position your conky on your screen, modify these settings: | ||
conky.config = { | conky.config = { | ||
| Line 51: | Line 57: | ||
gap_y 20, -- and a vertical gap of 20 pixels (to your top screen edge). | gap_y 20, -- and a vertical gap of 20 pixels (to your top screen edge). | ||
} | } | ||
'''4.''' In some case you can have multiple values for one setting, they will be separated by a coma: | '''4.''' In some case you can have multiple values for one setting, they will be separated by a coma: | ||
conky.config = { | conky.config = { | ||
| Line 58: | Line 65: | ||
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. | ||
==Second Part - What is displayed by conky== | ==Second Part - What is displayed by conky== | ||
The second part contains the displayed conky code. Every code line corresponds to one displayed line on your desktop. There are a lot of | |||
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 whole code belong between these two double bracket: | The whole code belong between these two double bracket: | ||
conky.text = [[ | conky.text = [[ | ||
]] | ]] | ||
===Examples:=== | ===Examples:=== | ||
'''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: | ||
${color} | ${color} | ||
| Line 96: | Line 104: | ||
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. | ||
=Running conky= | =Running conky= | ||
| Line 121: | Line 130: | ||
pkill conky && conky | pkill conky && conky | ||
=Troubleshooting & Tips= | |||
==Missing rings== | |||
If (often colored) rings are missing in your conky, you may install the package {{ic|conky-lua}} from [[Arch_User_Repository|AUR]] using your favorite package manager or with the command: | |||
pamac build conky-lua | |||
==Missing network information== | |||
==Missing | |||
If network information is missing like download speed or network name (SSID), you need to replace the network card name in network variables in the <code>.conkyrc</code> file with your network card name. | If network information is missing like download speed or network name (SSID), you need to replace the network card name in network variables in the <code>.conkyrc</code> file with your network card name. | ||
| Line 150: | Line 151: | ||
In this case, <code>enp9s0</code> is the name of your ethernet card and <code>wlp2s0</code> is the name of your wireless network card. Replace all network card names (e.g. <code>wlan0</code>, <code>eth0</code>) in network variables in your <code>.conkyrc</code> file with your preferred network card name. | In this case, <code>enp9s0</code> is the name of your ethernet card and <code>wlp2s0</code> is the name of your wireless network card. Replace all network card names (e.g. <code>wlan0</code>, <code>eth0</code>) in network variables in your <code>.conkyrc</code> file with your preferred network card name. | ||
=Alternative: Conky Manager= | =Alternative: Conky Manager= | ||
For everybody, who does not like to look at conky code and mess around in config files or who just wants a quick and simple conky, Conky Manager is great. Conky Manager offers a simple GUI for managing and customizing conkys. Additional theme packs are available, too. | For everybody, who does not like to look at conky code and mess around in config files or who just wants a quick and simple conky, Conky Manager is great. Conky Manager offers a simple GUI for managing and customizing conkys. Additional theme packs are available, too. | ||
To install Conky Manager install the package {{ic|conky-manager}} from [[Arch_User_Repository|AUR]] using your favorite package manager or with the command: | |||
pamac build conky-manager | |||
[ | |||
=See Also= | |||
* The [https://github.com/brndnmtthws/conky/wiki Conky website] | |||
* The [https://wiki.archlinux.org/index.php/conky Arch Wiki] page for Conky | |||
[[Category:Contents Page]] | [[Category:Contents Page]] | ||