1
edit
Difference between revisions of "Basic Tips for conky"
Correct file name is conky.conf, not conky.conkyrc
m (add template BoxInfo) |
(Correct file name is conky.conf, not conky.conkyrc) |
||
| Line 13: | Line 13: | ||
{{UserCmd|command=mkdir -p ~/.config/conky}} | {{UserCmd|command=mkdir -p ~/.config/conky}} | ||
Then copy the default to home | Then copy the default to home | ||
{{UserCmd|command=cp /usr/share/doc/conky-1.11.5_pre/conky.conf ~/.config/conky/conky. | {{UserCmd|command=cp /usr/share/doc/conky-1.11.5_pre/conky.conf ~/.config/conky/conky.conf}} | ||
The configuration file is a simple text file and the content written using [[https://www.lua.org/ |LUA syntax]] and is split into two parts | The configuration file is a simple text file and the content written using [[https://www.lua.org/ |LUA syntax]] and is split into two parts | ||
| Line 22: | Line 22: | ||
===Conky configuration=== <!--T:40--> | ===Conky configuration=== <!--T:40--> | ||
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. | {{File|file=~/.config/conky/conky.conf| | ||
content=<pre>conky.config = { | content=<pre>conky.config = { | ||
};</pre> | };</pre> | ||
| Line 33: | Line 33: | ||
===Examples=== <!--T:41--> | ===Examples=== <!--T:41--> | ||
'''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. | {{File|file=~/.config/conky/conky.conf| | ||
content=<pre>conky.config = { | content=<pre>conky.config = { | ||
... | ... | ||
| Line 42: | Line 42: | ||
}} | }} | ||
'''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): | ||
{{File|file=~/.config/conky/conky. | {{File|file=~/.config/conky/conky.conf| | ||
content=<pre>conky.config = { | content=<pre>conky.config = { | ||
... | ... | ||
| Line 51: | Line 51: | ||
}} | }} | ||
'''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: | ||
{{File|file=~/.config/conky/conky. | {{File|file=~/.config/conky/conky.conf| | ||
content=<pre>conky.config = { | content=<pre>conky.config = { | ||
... | ... | ||
| Line 61: | Line 61: | ||
}} | }} | ||
'''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: | ||
{{File|file=~/.config/conky/conky. | {{File|file=~/.config/conky/conky.conf| | ||
content=<pre>conky.config = { | content=<pre>conky.config = { | ||
... | ... | ||
| Line 75: | Line 75: | ||
The whole code belong between these two double bracket: | The whole code belong between these two double bracket: | ||
{{File|file=~/.config/conky/conky. | {{File|file=~/.config/conky/conky.conf| | ||
content=<pre>conky.text = [[ | content=<pre>conky.text = [[ | ||
]];</pre> | ]];</pre> | ||
| Line 81: | Line 81: | ||
===Examples=== <!--T:43--> | ===Examples=== <!--T:43--> | ||
'''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. | {{File|file=~/.config/conky/conky.conf| | ||
content=<pre>conky.text = [[ | content=<pre>conky.text = [[ | ||
... | ... | ||
| Line 95: | Line 95: | ||
<!--T:45--> | <!--T:45--> | ||
'''2.''' You can call the default font (and it's size) with this command: | '''2.''' You can call the default font (and it's size) with this command: | ||
{{File|file=~/.config/conky/conky. | {{File|file=~/.config/conky/conky.conf| | ||
content=<pre>conky.text = [[ | content=<pre>conky.text = [[ | ||
... | ... | ||
| Line 102: | Line 102: | ||
]];</pre> | ]];</pre> | ||
}} | }} | ||
If you want a different font (DejaVuSerif) and font size (9) in your conky, use this command in your <code>. | If you want a different font (DejaVuSerif) and font size (9) in your conky, use this command in your <code>.conf</code> code: | ||
{{File|file=~/.config/conky/conky. | {{File|file=~/.config/conky/conky.conf| | ||
content=<pre>conky.text = [[ | content=<pre>conky.text = [[ | ||
... | ... | ||
| Line 111: | Line 111: | ||
}} | }} | ||
'''3.''' This code line displays the text "Kernel: " and the kernel you are using (using <code>$alignr</code> just yields a nicer formatting, it is not necessary: <code>$alignr</code> aligns all following text on the right of your conky): | '''3.''' This code line displays the text "Kernel: " and the kernel you are using (using <code>$alignr</code> just yields a nicer formatting, it is not necessary: <code>$alignr</code> aligns all following text on the right of your conky): | ||
{{File|file=~/.config/conky/conky. | {{File|file=~/.config/conky/conky.conf| | ||
content=<pre>conky.text = [[ | content=<pre>conky.text = [[ | ||
Kernel: ${alignr}${kernel} | Kernel: ${alignr}${kernel} | ||
| Line 117: | Line 117: | ||
}} | }} | ||
'''4.''' This variable gives you the latest 3 manjaro blog entry titles (using rss). It checks for updates every 60 minutes. | '''4.''' This variable gives you the latest 3 manjaro blog entry titles (using rss). It checks for updates every 60 minutes. | ||
{{File|file=~/.config/conky/conky. | {{File|file=~/.config/conky/conky.conf| | ||
content=<pre>conky.text = [[ | content=<pre>conky.text = [[ | ||
${rss http://manjaro.org/feed/ 60 item_titles 3} | ${rss http://manjaro.org/feed/ 60 item_titles 3} | ||
| Line 123: | Line 123: | ||
}} | }} | ||
'''5.''' Information about the root partition <code>/</code> of your manjaro installation is displayed using | '''5.''' Information about the root partition <code>/</code> of your manjaro installation is displayed using | ||
{{File|file=~/.config/conky/conky. | {{File|file=~/.config/conky/conky.conf| | ||
content=<pre>conky.text = [[ | content=<pre>conky.text = [[ | ||
Root: ${alignr}${fs_used /} of ${fs_size /} | Root: ${alignr}${fs_used /} of ${fs_size /} | ||
| Line 129: | Line 129: | ||
}} | }} | ||
'''6.''' Instead of example 3, you can use the following code to display the exact same information: | '''6.''' Instead of example 3, you can use the following code to display the exact same information: | ||
{{File|file=~/.config/conky/conky. | {{File|file=~/.config/conky/conky.conf| | ||
content=<pre>conky.text = [[ | content=<pre>conky.text = [[ | ||
Kernel: ${alignr}${execi 3600 uname -r} | Kernel: ${alignr}${execi 3600 uname -r} | ||
| Line 145: | Line 145: | ||
===Running conky=== <!--T:49--> | ===Running conky=== <!--T:49--> | ||
If you want to display a conky on your desktop a {{ic|~/.config/conky/conky. | If you want to display a conky on your desktop a {{ic|~/.config/conky/conky.conf}} 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. | {{UserCmd|command=conky -c ~/.config/conky/conky.conf}} | ||
or to run as background daemon | or to run as background daemon | ||
{{UserCmd|command=conky -d -c ~/.config/conky/conky. | {{UserCmd|command=conky -d -c ~/.config/conky/conky.conf}} | ||
<!--T:50--> | <!--T:50--> | ||
| Line 155: | Line 155: | ||
<!--T:51--> | <!--T:51--> | ||
{{UserCmd|command=conky -c ~/.config/conky/conky. | {{UserCmd|command=conky -c ~/.config/conky/conky.conf &}} | ||
{{UserCmd|command=sleep 20 && conky -c ~/.config/conky/conky. | {{UserCmd|command=sleep 20 && conky -c ~/.config/conky/conky.conf &}} | ||
<!--T:52--> | <!--T:52--> | ||
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. | {{UserCmd|command=killall conky && conky -c ~/.config/config/conky.conf}} | ||
===Troubleshooting & Tips=== <!--T:53--> | ===Troubleshooting & Tips=== <!--T:53--> | ||
| Line 172: | Line 172: | ||
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>. | 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>.conf</code> text section with the interface name(s) you retrieved from the above command. | ||
===Conky Manager=== <!--T:57--> | ===Conky Manager=== <!--T:57--> | ||