Go Back to Wiki Home

Table of Contents

• USAGE
• SYNTAX
• MUSIC SORT
• SCROLLER
• SHOWCOND
• THERMOMETER
• WXGRAPH
• BACKGROUND
• BARGRAPH
• ANEMOMETER
• BAROMETER
• VUMETER
• CREDITS

USAGE

• All options shown have to have a space a dash and a single small case character followed by a space and then the option value - for example -a 25 -p 2,25
• In conkyrc file add a line Before TEXT -- lua_load path_to/conkywx.lua
• Under TEXT or in conkywx template file use::
• ${lua main -n wxgraph -p 188,170 -d [GT] -c 0xEE4000}

SYNTAX

example

• ${lua main -n wxgraph -p 188,170 -d [GT] -c 0xEE4000}

explanation

• see wxgraph below

Function calls

Go To Top of Page

music sort

example

• ${lua main -n music_sort -f 14 -l 36 -s 5 -p 5,685 }

explanation

• This is a generic music track title extractor. the progran has smplayer and vlc player support.
• This line can be placed anywhere in the TEXT section.
• No data needs to be input
• Xlsclients is a utility for listing information about the client applications running on a display. It may be used to generate scripts representing a snapshot of the user's current session. [from man xlsclients] It is part of X installation.

options

Go To Top of Page

scroller

example

• ${lua main -n scroller -f 14 -l 36 -s 5 -p 170,20 -o ${template3}}
• template3 looks like::
• template3 /tmp/wx-username-conkywx-02.conf-pChA_r_27u0-m39/wxalert
• conky template and path to wxalert file in conkywx temp folder

explanation

• This line can be placed anywhere in the TEXT section.

options

Go To Top of Page

showcond

• showcond - is short for show condition - condition includes present weather condition, wind direction and the moon - you can display images as well as font characters.

Condition - example

• ${lua main -n showcond -p -5,90 -s 110 -w CI -t 1 -f [PIF] -c 0xFFD700 -i [PIC] -j 1 }

explanation

Note::

Windvane - example

• arrow colour option -l is blue
• ${lua main -n showcond -p 204, 0 -s 200 -w wi -f [BF] -d [WDD] -t 1 -e [WS] -i 1 -a 4 -j 1 -c 0x00ff00:1 -l 0x4169E1:1}
• arrow colour option -l is brown
• ${lua main -n showcond -p 204, 0 -s 200 -w wi -f [BF] -d [WDD] -t 1 -e [WS] -i 9 -a 5 -j 1 -c 0x00ff00:1 -l 0x8B4513:0.9 }
• arrow colour option -l is red
• ${lua main -n showcond -p 204, 0 -s 200 -w wi -f [BF] -d [WDD] -t 1 -e [WS] -i 16 -a 1 -j 1 -c 0x00ff00:1 -l 0xff0000:0.9 }
• star demo - star with lines with -c colour
• ${lua main -n showcond -p 204, 0 -s 200 -w wi -f [BF] -d [WDD] -t 1 -e [WS] -a 3 -j 1 -c 0x00ff00:1 -l 0xff0000:0.9 -y d }
• star demo - star filled with -c colour
• ${lua main -n showcond -p 204, 0 -s 200 -w wi -f [BF] -d [WDD] -t 1 -e [WS] -a 4 -j 1 -c 0x00ff00:1 -l 0xff0000:0.9 -y d -x f }
• see wind in 3D font - set -t 0 to see flat image
• ${lua main -n showcond -p 204, 0 -s 200 -w wf -f [BF] -d [WDD] -t 1 -e [WS] -j 1 -c 0x00ff00:1 -l 0xff5555:0.9 }

explanation

Moon - example

• ${lua main -n showcond -p -5, 312 -s 110 -w mi -f [MIF] -d [MROT] -i [MIC] -j 1 }

explanation

Go To Top of Page

thermometer

example

• ${lua main -n thermometer -p 442,218 -t [PT] -l Temperature -s 1 -u [UU]}

explanation

Go To Top of Page

wxgraph

• Note:: This replaces use of GnuPlot to display graph trends. This makes it use virtually zero overhead and see the graph trends ;-)

example

• ${lua main -n wxgraph -p 188,170 -d [GT] -c 0xEE4000:1}

explanation

trend graph conkywx element

• use [GT] for Temperature
• use [GD] for Dew Point
• use [GP] for Pressure
• use [GH] for Humidity
• use [GW] for Wind Speed

Go To Top of Page

background

example

• ${lua main -n background -r 25 -c 0x000000:0.2 -p NA,NA}

explanation

Go To Top of Page

bargraph

example

• ${lua main -n bargraph -p 117,275 -w 90 -s 3 -f cpu -a cpu1}
• ${lua main -n bargraph -p 190,503 -w 115 -s 1 -f fs_used_perc -a / -l 1 -x 70}

explanation

• - there are 5 styles numbered 1 to 5
• - they give a gradient colour change to alarm colour
• - if led effect is used you get a solid colour with alarms
• - style 1 is thin dashes
• - style 2 is thick dashes
• - style 3 is small vertical bars separated by 2 pixels
• - style 4 is small vertical bars separated by 1 pixels
• - style 5 is one continuous bar

• - conky variable like cpu, fs_used_perc, memperc etc
• - refer to http://conky.sourceforge.net/docs.html

• - this value can be omitted if LED effect is not desired
• - LED effect does not have gradient and has solid red alarm
• - this can be useful where alarm values are required like in
• file system warnings etc

• - This alarm value is only valid if LED effect is 1

Go To Top of Page

anemometer

example

• ${lua main -n anemometer -p 7, 0 -s 200 -r [WS] -t [WG] -u [UU] -w 1 -d [WDD] -i 4 -a 1 -j 1 }

explanation

• Note:
• Widget Auto-Scales:: Wind speeds of upto 300 mph are supported.
• Widget can be re-sized:: Size: smallest is about 70px - big as you like
• Windvane shown here is a subset and features shown below are available.

• Following are optional

Go To Top of Page

barometer

example

• ${lua main -n barometer -p 150, 209 -s 200 -r [BR] -t [PT] -u [UU]}

explanation

• Note:
• Widget Auto-Scales:: Pressure: from 10in [338.6hpa] to 34in [1151.4hpa]
• Widget can be re-sized:: Size: smallest is about 70px - big as you like

• Following are optional

Go To Top of Page

vumeter

example

• ${lua main -n vumeter -p 160,190 -d [UV] -u [UU] -o u -v h }

explanation

• -d [UV] -o U for UV info
• -d [VI] -o V for visibility
• -d [MV] -o M for moon visibility/illumination
• -d [HM] -o H for relative humidity
• -u [UU] units in use

• Following are optional

Go To Top of Page

credits

• Code here modified / part / fully written by Paramvir Likhari for conkywx. Original sources from Mr Peachy, wlourf, londonali1010 and probably others I am not aware off - Thanks to ALL !!!