Conky Weather Script - conkywx wiki


  • Information in this wiki may be a bit different from your version of conkywx. Refer to the help documentation included with your version of the program - at the terminal type conkywx and choose option 2.
  • Conkywx now supports display of data and conkywx messages in languages other than English. I have Italian set done - thanks to "Night Train". If you would like to assist in translating to your native language - please email me.

For latest updates for conkywx visit this Blog

Besides showing straight forward weather with forecasts from http://www.wunderground.com - The BEST weather site on the planet !!! - Conkywx ALSO shows following

  • Dynamic Moon
  • Font to Image
  • Trend Graphs
  • Scrolling Weather Alerts
  • Active Weather Alerts
  • Tropical Weather Storm Warnings
  • Moon Works for Both Hemispheres


Table of Contents



  • conkywx − Program to display weather information using conky


  • conkywx [-c or --config with path] [-t or --template with path]
    [-c or --config with path] [-d or --data element]
  • conkywx without options or parameters will launch Conkywx Weather Program Assistant


  • conkywx gets the weather data from wunderground website and displays the information using conky. This just helps in not having a web page open all the time. Having the web page open has it’s own benefits since not all the information is available here.
  • I have used other weather programs but all RSS or json feeds are too limited - one has to refer to the data on the web pages. Thus we have a solution which gets the job done in bash script. Like I have read many places bash script is quite under rated - but is very powerful if you can get a handle on it.
  • The program does it’s own calculations for:
    • Trends - 15 in all
    • UV condition text ( Low High etc )
    • Feels like or apparent temperature also known as heat index.
    • Astronomy Information a C module which gives out information required by conkywx - sun and moon rise, moon phase and more...
  • Conkywx will automatically check once every 24 hours for new release of conkywx.
  • conkywx now supports multiple languages for data display.

Go To Top of Page


To get Help

  • Type conkywx in the terminal - will give you conkywx assistant and type 2 to read the conkywx wiki documentation in your browser.
  • The astronomy module magellan is pre-compiled and will run on 64 bit, 32 bit and Atom systems.
    • If you are on an exotic system the source is included in compressed format.
    • For a 64 bit system - where uname -m output is x86_64 - name the file magellan_64
    • For the rest of the systems - name the file magellan_32

Stand Alone Version

  • Run conkywx_fonts_assistant.sh to install or remove conkywx fonts - located in the conkywx directory. It asks for user password as required.
  • To use conkywx - use the script conky-restart.sh - this is an example script.

Installation Version

  • Run /usr/share/conkywx/conky-restart.sh - this is an example script.


  • To get template based weather output from conkywx we need three files.
    • the rc file - passed to conky program
      • example conky -c conkyrc file
    • config file - passed to conkywx program in the rc file above
    • template file - passed to conkywx program in the rc file above
      • example conkywx -c config file -t template file
  • Make changes to conkywx config file to suit your Location, xml_ID etc - be guided by the CONFIG FILE OPTIONS section in this wiki.
  • There are many examples located in the examples directory in conkywx directory.
  • If you are using Gnome 3 - own_window_type in the *conkyrc.sh in examples directory needs to be changed to normal, desktop or dock - see what works for your system.
  • See Making Life Simpler in EXAMPLES below.

Go To Top of Page



  • will launch Conkywx Weather Program Assistant

--help - New in next version"

  • will launch the local copy of this wiki in your browser.

-v, --version

  • show conkywx version number

-c, --config

  • This defines the location and name of conkywx config file to use.
  • To use multiple locations - multiple conky config files can be used - but - you will also need separate conkyrc and template files.
  • Interestingly if you combine -c with -d you can have multiple locations updated in one conkyrc.

-t, --template

  • This defines the location and name of conkywx template file to use.
  • This program can use the template concept for updating a conky file. This is not to be confused with conky’s own in built user variable template. The benefits are that less code for the conkyrc file and the update is in one burst using a single call to execpi.
  • Template files are the same data that you would normally place in a conkyrc file but here you place it in a separate file and give its location in the conkyrc file - see the example directory. This gets rid of putting execpi call for each element that needs to be called and then shown. Using execpi is also said to be a huge resource hog as per the conky usage wiki.
  • Each weather element to be placed in square brackets like so [BF] for Bearing font character. Look in the example directory for ideas - but it will be like ${image [PIC] -p 12,20 -s 100x100} - the [PIC] will be automatially be replaced by the full path of the image.

-d, --data

  • This program can also use individual data elements in the conkyrc directly by placing element after -d or --data.
  • Multiple locations can also be checked by placing a separate config file for each required element in one conkyrc.
  • See examples below.


  • Using single -d or --data elements could be relatively slow.
  • Square brackets "[ ]" are only required in templates - where -d option is used no square brackets to be used.
  • For a list of data elements see below.
  • There is no bearing icon set as I have not found the ones I really like and the bearing font with ConkyWindNESW.otf does a fantastic job.

Go To Top of Page


This utility is there to assist you in certain tasks which are required under certain conditions. You will need to choose from numbers 1 to 7 as displayed below.

Available options are:

1 - Quick HELP with conkywx weather program

  • Show short help message and usage

2 - Refer to off-line conkywx WIKI Manual in your browser

  • Show conkywx help wiki local copy in your browser

3 - FORCE update conkywx data - Has changes in the new version - also refer to config file section below

  • Update and override minimum fetch time.
  • The list of active conf files will be presented to the user for selection.
  • conkywx will restart automatically to present you with updated information.

4 - Get detailed DEBUG information for conkywx - Has changes in the new version - also refer to config file section below

  • The list of active conf files will be presented to the user for selection.
  • This option will dump complete data set in various forms as it is collated in to a compressed log file named "wund_debug.log.bz2" in the conkywx temporary cache in the tmp directory. Complete path will be stated on completion.
  • This would be useful to see if the data being computed / collected is correct or perhaps the issue is in the source data at wunderground.

5 - Reset Forecast trend information

  • Trends that are seen on conky desktop are based on comparison between present values and these stored values.
  • The list of trend files will be presented to the user for selection.

6 - Reset Graphs trend information

  • Graphs data for temperature, pressure and dew point can be reset using this option.

Go To Top of Page



  • The location /etc/conkywx is no longer used - there is no default config file.
    • The program typically takes the config file from the -c option on the command line - this is useful when you have multiple conky weather instances for different locations - as each instance would require a separate config file.
    • If you specify the full path of the config file with the -c option then the config file can reside anywhere.
    • On the other hand you can place the config file in $HOME/.config/conkywx/conkywx.conf.
      • This is required if you do not give a -c option on the command line - for both the -t template option and the -d data option. Note the file name has to be conkywx.conf.
  • There are now 2 config files as described below.

CONFIG FILE - system.conf

  • system.conf is located at $HOME/.config/conkywx/system.conf.


  • Path to the conky starting script - Used by debug and force update.
  • This script must have a - killall conky - command before any conky process is started. This allows any conky process to be stopped and restarted.


  • Language to see Messages in
  • Comment this option if not required.
  • English is default

CONFIG FILE - conkywx.conf or config used with -c option


  • To use conkywx you need to set the Location.
  • Enter the location number from weather underground web page url - most locations have a location number - BUT some do not - like the US sites!!! in which case use the URL and set Location to url.
  • In our example for Perth, Western Australia http://www.wunderground.com/global/stations/94610 - Location=94610
  • In other cases - since wunderground is dynamically driven site now - the full URL may be required
  • For example for Scandriglia, Italy something like this works http://www.wunderground.com/cgi-bin/findweather/getForecast?query=Scandriglia Use the full URL Location=http://www.wunderground.com/cgi-bin/findweather/getForecast?query=Scandriglia
  • Location=url OR Location=number
  • Use only one location per config file! for more than one location - create a new config file and give the path to it with a -c command line option there are some test cases listed in the config file - just ensure only one location is uncommented. The lowest uncommented Location will be picked up in case more than one is uncommented.
  • If you cannot figure out the number just use the full url to that page.


  • Comment this option if not required.
  • This is optional - To use conkywx you need Location and for higher accuracy you can add a xml station.
  • If xml data is older than main data by more than 1 hour then main data is used. This happens sometimes when the private weather station stops uploading data to wunderground.
  • To get this xml_ID you need to visit the location of your interest which will give you the "Location" url [US] or number [rest of the world] at the bottom of the page you have a listing of private weather station feeding wunderground.
  • You will also notice a lot of them - under Type column - have Rapid Fire in green - ideally one of these would make a good choice and you can select one closest to your location.
  • For example Wanneroo, Wanneroo, WESTERN AUSTRALIA URL weather station looks like this: http://www.wunderground.com/weatherstation/WXDailyHistory.asp?ID=IWESTERN144 The xml_ID required is IWESTERN144
  • This link was obtained from the Perth, Western Australia web page http://www.wunderground.com/global/stations/94610 near the bottom of the web page under the Weather Stations section.
  • A good page to see the xml stations near your location is Wundermap. the page here can be zoomed in and out and the screen gets populated with existing stations. A good criteria to select a xml *Rapid Fire* station is that
  1. It provides very fast updates - the time conkywx calls for data - about that time the data at the website is updated - near real-time.
  2. If xml_ID is used then the primary site only provides Astronomical data and 8 day predictive weather.
  3. Some extra information like the UV info
  4. Most times the primary location is good enough. You will notice Rapid Fire notification on the web site.

User Position and Time Zone

  • This information is required by the conkywx astronomy module - which calculates the rise set twilight sun and moon data - which is localised basis user position.
  • Enter Latitude, Longitude and t_zone (time zone) in decimal format


  • Comment this if you want the value to be picked from the downloaded data.
  • Needs to have N or S after the value
  • eg: Latitude=23.45N for North location.


  • Comment this if you want the value to be picked from the downloaded data.
  • Needs to have E or W after the value
  • eg: Longitude=123.45W for West location.
  • Note:
    • If Latitude and/or Longitude values are not filled here - they will be picked from the main data downloaded. This will normally be a general position in 1 decimal place of the weather station.
    • To get more accurate information for your precise position the coordinates can be picked by using Google or visit this site for picking your position on google maps.


  • [1] Let conkywx figure it out based on your computer time zone information,
  • [2] Use the time zone information provided by wunderground for your weather Location station.[default]
  • OR - To Use custom time zone. State the time zone here example t_zone_pick='7.0'
  • Note:
    • There are places which use Daylight Saving Time. Your system should already have built in handling for the DST issue and therefore perhaps you could use option [1] below for setting time zone. You can refer to this blog which refers to the topic of updating daylight saving time on linux or if you are using Arch Linux this wiki on Time will guide you - basically set your hardware clock to UTC.
    • time zone value in decimal eg: 7, 7.0 are fine. If you are West of Greenwich Meridian you will need to add a "-" minus/dash character right before the number eg: -7.


  • This allows you to see the output data and conkywx messages in any supported language.
  • There are 2 files that require translation. One for desktop display and the other for messages. ex: en.lang and en.msgs for English - which is Default.
  • Display language file settings reside in each of your conkywx config files and you can choose if you speak multiple languages and if we have those supported - see each conkywx Desktop display in that language. This language file has translations of weather conditions etc.


  • [SI] for Metric
  • [IM] for Imperial


  • [SI] for Metric
  • [IM] for Imperial
  • Select this option to choose which Units you want to download the data in.


  • [1] see units like km/h etc
  • [0] or Comment to switch off all units.
  • You can show your own units in conkyrc or the template file.


  • [1] show Sun 27
  • [0] or Comment to show Sunday, 27.


  • [1] show popup notification
  • [0] or Comment to disable


  • [1] show Active Weather alerts
  • [0] or Comment to disable
  • Active Alerts - depending what action is happening at your location
  • Note: Active alerts at present time are only for the US. They will NOT warn you if a Tropical Storm is coming your way - Enable show_wx_Tropical_alerts for that.


  • [1] show Tropical Weather alerts
  • [0] or Comment to disable
  • Tropical Alerts - are Tropical Storm system information


  • [1] Check for new version of conkywx every 24 hours
  • [0] or Comment to disable


  • [1] for moon outline fonts
  • [0] or Comment for simple fonts
  • only used in font templates


  • View Moon image as it appears outside
  • Only works for Image Templates
  • Needs Imagemagick to be installed
  • [1] use your local time,
  • [2] use station local time for calculation
  • Note: Comment this option for static Moon images to be displayed


  • Choose weather icon / image set
  • [1] Enable icon set - [Default]
  • [2] Enable icon set
  • [3] Enable icon set
  • [4] Enable icon set
  • OR - To define custom icons - state full path here.
  • Note:
  • COMMENT font to image options below for using regular weather icons in image templates
  • To use you own icons - you need to follow the convention of naming the wx icons same as they are named in the program. If you have a nice set - please share it with the rest of us mortals ;-)

font to image

  • Convert ConkyWeather font to 3D images - state the colour here.
  • Use only for Image Templates
  • COMMENT these options for using in font templates
  • COMMENT these options for using regular weather icons in image templates
  • Needs Imagemagick to be installed
  • To see List of Colour Names visit http://www.imagemagick.org/script/color.php
  • Colour can be stated in any of the following formats - enclosed in single quotes
  • example for colour *lime* - 'lime' '#0f0' '#00ff00' 'rgb(0,255,0)' 'rgb(0,100%,0)'
  • fti_now='#fed577'
  • fti_wind='DarkSeaGreen1'
  • fti_fct='lime'

font to image tweaks

  • On some Linux Distros your generated images will appear white - Make changes as per table below - you may need to adjust them as well.
  • These are listed at the bottom of the conkywx.conf file and the Normal set is uncommented while the other set is commented - so it is easy for you :)
OptionNormalIf images are white

Trend Graphs

  • We have ability to generate graphs for temperature, pressure and dewpoint
  • You need gnuplot to be installed
  • comment these colour options do disable
  • colour can be in names or '#fed577' format if name gives white output
  • This seed data is generated by wunderground and rest is recorded by conkywx
  • graph_temp='red'
  • graph_pressure='green'
  • graph_dewpoint='cyan'

path_to_background_image No longer used

  • See the example templates for usage
  • copy of the bgrounds directory is made during run time in the conkywx temp directory
  • The program automatically uses that location for the [PTBI] element

pc_what_case How do you want to capitalize the present conditon

  • [1] first char each word uppercase [Default]
  • [2] all upper case
  • [3] all lower case or
  • [4] sentence case - only first character of the full present condition

use_pcondition_blacklist - not required See pcondition_blacklist option.


  • Comment this option if not required.
  • Use blacklist to shorten Present Condition text
  • example pcondition_blacklist=( "light:lt" "heavy:hvy" "Severe:svr" "Widespread:ws" pellets pellet Freezing "Thunderstorms:t-storms" "Thunderstorm:t-storms" "with:+" "and:+" "Patches of" "Low Drifting" Small Precipitation )
  • Enclose the word groups in ( ) brackets
  • Add words you want to remove from Present Condition text in this list - Separate words with space, if two words together then quote the words with " character.
  • To replace words use format "orginaltext:newtext" and quote text with " character
  • To replace everything use format "*orginaltext*:newtext" and quote text with " character
  • The list is not case sensitive.
  • The output will be based on pc_what_case

use_template_cleanup - not required See template_cleanup option.


  • Comment this option if not required.
  • Use this option to make changes to the final Displayed output by conky. Displayed word groups will be replaced with your word groups. Word groups can mean single words or sentences.
  • example template_cleanup=( 'Calm km/h:${offset 8}Calm' 'Calm mph:${offset 8}Calm' )
  • Enclose the word groups in ( ) brackets
  • Separate groups with space, separate data to change and data to change with using : colon character.
  • make sure it is in single quotes
  • to remove some part completely - at the end of the word group put a colon '0.0 mm:'

show_lowercase_ampm - not required See Time_format option

custom_time_format - not required See Time_format option


  • Use upper or lower case AM PM or am pm for 12 hour time format OR use 24 hour time format
  • [1] ALL UPPERCASE (example: 03:00 PM)
  • [2] all lowercase (example: 03:00 pm) [Default]
  • [3] Hide am pm (example: 03:00)
  • [4] all lowercase with no padding/spacing (example: 3:00pm)
  • [5] Use 24 hour time format [Default]
  • OR - To Use custom time format. State the format here.
  • example Time_format='%_I:%M %p'
  • Refer to *man strftime* for more date formats.


  • Show time with month and day for Moon Phases
  • [1] Show month day time (example: May 18 10:06 am) The time will follow the Time_format settings above.
  • [2] Show only month n day (example: May 18) [Default]
  • Refer to *man strftime* for more date formats.


  • Show degree symbol in forecast temps,
  • [1] Hide all deg symbols (example: 95/63)
  • [2] Show all deg symbols (example: 95°/63°)
  • [3] Show all deg symbols, depending on Unit_to_Use (metric: 35°C/17°C) (imperial: 95°F/63°F)
  • [4] Show deg symbol ONLY, after forecast pair (example: 95/63°)
  • [5] Show deg symbol AND unit, after forecast pair (example: 95/63°F) [Default]

Arrows to show forecast trends - qoute in single ' quotes - you can use unicode fonts in your script like DejaVu Sans ... if you want to change these values - test them first in terminal as example echo -e '\u2194' To show this in your template - see the Weather Data Elements options list below.

# Unicode fonts code
# risingtrend='\u2191'
# fallingtrend='\u2193'
# steadytrend='\u2194'
# Arrows font code


  • Refer to man strftime to get the formats you can use.


  • Default set to 870 seconds which is 14 min.


  • Only available in scroller template config file. The data is not output to screen but conkywx_scroller file in the conkywx tmp directory. This file data is displayed in the conkywx scroller.
  • [1] Enable this option
  • [0] or Comment to disable

Go To Top of Page


BRBarometer Reading / Atm PressureSDSnow Depth always in Inches
PIFwx Condition Font characterLNLocation ( City ) Name [New]
PICwx Condition imageSNStation Name - station used main and/or pws xml
PTPresent TempTDToday date
CTPresent Conditions TextVIVisibility
FLFeels Like TempWSWind Speed
DPDew Point tempWGWind Gusts
HMHumidityWDWind Direction
LFLast Fetch timeLULast Update time
BFBearing Font characterBIBearing Font to Image
METARMETAR information [See Note]CLDClouds
QOFQuality of Forecast [See Note]RFRain Fall
PTBIPath To Background ImageUVUV Index includes UV Text
GTTrend Graph for TemperatureGPTrend Graph for Pressure
GDTrend Graph for Dew Point
MIFMoon font characterNMNew Moon time
MICMoon imageMFQMoon First Quarter time
MPMoon PhaseFMFull moon time [See Note]
MP1Moon phase first partMLQMoon Last Quarter time
MP2Moon phase second partMAMoon Age
MP3Abbreviated Moon PhaseMVMoon Percent Illuminated
MRMoonRise timeMROCMoon % rate of change [See Note]
MSMoonSet timeMMTMoon Meridian Transit [See Note]
LODLength of DayCTRCivil Twilight rise [See Note]
LODNTomorrow will be XXm YYsCTSCivil Twilight set [See Note]
LODNMText shorter / longer / steadyNTRNautical Twilight rise [See Note]
LODNTtrend arrowNTSNautical Twilight set [See Note]
LOVLength of visible lightATRAstronomical Twilight rise[See Note]
SRSunRise timeATSAstronomical Twilight set[See Note]
SSSunSet timeSMTSun Meridian Transit [See Note]


FM ~ Element for Full Moon phase time:

  • This is one particular situation in the moon phases that moon never actually reaches a 100% mathematically - since the calculation are in decimals.
  • To get this information we round the 99.5 (+ -) (.995).
  • Actual Full Moon phase time is the tipping point from waxing to waning of the moon - therefore the shown illumination of 100% is about 18 hours (+ -) of this Full Moon time.

METAR ~ Element for Metar information:

  • METAR information can be shown and word folded in conkywx or your templates using following two methods.
  • both work equally well and both are part of GNU coreutils.
  • Refer to the EXAMPLES below for possible METAR data formatting in conky

QOF ~ Element for Quality of Forecast:

  • The quality of the forecast high temperature for that day is graded as Excellent, Good, Fair or poor.
  • Excellent Forecast Quality
    • The forecast temperature is usually less than 1.5 degrees C warmer or cooler than the observed forecast.
  • Good Forecast Quality
    • The forecast temperature is usually 1.5 to 2.5 degrees C warmer or cooler than the observed forecast.
  • Fair Forecast Quality
    • The forecast temperature is usually 2.5 to 3.5 degrees C warmer or cooler than the observed forecast.
  • Poor Forecast Quality
    • The forecast temperature is usually more than 3.5 degrees C warmer or cooler than the observed forecast.

SMT and MMT ~ Elements for Sun or Moon Meridian Transit:

  • N.M.T. = No Meridian Transit. The body will not pass overhead on your Longitude during the present 24 hour period.

SR, SS, MR and MS ~ Elements for Sun and Moon:

  • A.A.H. = Body is Always Above Horizon. This can mean that the Body will not Set within the present day 24 hour period, OR for a duration if you are in the Polar regions.
  • A.B.H. = Body is Always Below Horizon. This can mean that the Body will not Rise within the present day 24 hour period, OR for a duration if you are in the Polar regions.

CTR, CTS, NTR, NTS, ATR and ATS ~ Elements for Twilight times:

  • These events normally occur above the polar circles.
  • No Sun Rise = The day light is never Bright enough for this twilight to occur.
  • No Sun Set = The day light is never Dark enough for this twilight to occur.

MROC ~ Element for Moon Percent Illumination Rate of Change:

  • Interesting element - takes the illumination for today and the next day and the difference is your change per day.
  • This will vary sometimes like any real time element. Percent illumination for change may have taken place for today but not yet for next day same time - so you will see a drop in change but overall it gives you an interesting check at the speed at which our Moon moves.

Weather Alerts

  • If there is an Alert generated by wunderground - the Present Condition text will get "!" character before the text.
    • example ! Clear
  • If there are more than one alerts then a number after "!" will indicate the number of alerts at wunderground.
    • example !2 Overcast
  • Being an alert - it is always ON - you do not see the exclamation if there are no alerts.
  • A file named wxalert will be created in the conkywx tmp directory which can be used to have scrolling Alert information on conky display.
  • Refer to EXAMPLES below for conkywx weather alerts / warnings examples

Go To Top of Page


D1DtoD8Dday 1 to day 8 date - D1 information is for the present day till about 8 pm - when it switches to the next day
D1TtoD8Tday 1 to day 8 temperature
D1CtoD8Cday 1 to day 8 condition
D1FtoD8Fday 1 to day 8 condition font character
D1ItoD8Iday 1 to day 8 condition image
D1PtoD8Pday 1 to day 8 rain prob

Go To Top of Page


FCTPpressure trendFCTPFpressure trend font
FCTTtemperature trendFCTTFtemperature trend font
FCTWwind trendFCTWFwindspeed trend font
FCTHhumidity trendFCTHFHumidity trend font
FCTUUV trendFCTUFUV trend font
FCTDdewpoint trendFCTDFdewpoint trend font
FCTVvisibility trendFCTVFvisibility trend font
FCTMIpercent moon illuminated trendFCTMIFpercent moon illuminated trend font
FCTSRsunrise trendFCTSRFsunrise trend font
FCTSSsunset trendFCTSSFsunset trend font
FCTMRmoonrise trendFCTMRFmoonrise trend font
FCTMSmoonset trendFCTMSFmoonset trend font
FCTLLlength of visible light trendFCTLLFlength of visible light trend font
FCTLDlength of day trendFCTLDFlength of day trend font


  • There are 2 type of trends
    • Type 1 that are updated hourly - pressure, presenttemp, windspeed, humidity, UV, dewpoint, visibility.
    • Type 2 that are updated every 24 hours - Sunrise, Sunset, Moonrise, Moonset, length of Vis light, length of day, Moon Illumination.
  • You will not see trends for an element under certain conditions.
    • If the value of the Current data or the value of the stored data is N/A. This is because there is no way to get a comparison when one of the data is Not Available.
  • When you first start using these trend elements - you will start getting trends for these elements depending on when you started conkywx first time with these elements [ get reference data ] and the next update from wunderground for these elements.
  • Other trend elements update normally with each weather update.
  • If you are using Location - unless it is Rapid Fire type - the trends displayed for Type 1 trends will be Steady a lot of the time. This is because of the slow rate of updates that are received. If you see steady arrow <> for most of the type 1 trends - check the Last Update time - which will give you the reason. For example the last update I got was 8:30 pm and it is 10 pm now and all the type 1 trends are steady. To get faster updates - in the config file, use the use_xml=1 option and select appropriate xml_ID.

Go To Top of Page


Set of conky config and templates files in the *examples* directory


  • Each conkyrc file has documented information to comment for Font or Image template.
  • Just comment the Fonts section to get the Fonts template to work and same is the case with Image template.
  • The conkyrc file also has references to the required conkywx config file for you to edit.
  • The table below is a quick reference to see their link and usage.
Conky rc fileConkywx config fileFont templateImage template

Weather Condition icon sets

Icon set 1Original 12 by bharathp666, while complete new set of 24 icons done by me[Default]
Icon set 2origin not known
Icon set 3tick weather icons by xiao4
Icon set 4Sticker Weather Icons by Kortoik

Fonts installed in the system fonts directory

Arrows.otfJLH Fonts
ConkyWeather.otfBy Stanko Metodiev 2008
ConkyWindNESW.otfBy Nite 2008
MoonPhases.ttfBy Curtis Clark 1995

The program location

The program location is /usr/share/conkywx directory. There are two directories below this - examples, images. The images directory has bgrounds, wxicons and moonicons directories. See details below.


This file is in the program directory and is usable as is and will show system details on the right of the screen and on the left default location weather. By default the system conkyrc is commented out - to use uncomment the line.

Set of Background png images in the *images/bgrounds* directory

The name of the image gives you the hint with which template it is associated.

Go To Top of Page


  • These example statements come below the TEXT statement in conkyrc file.

-d --data option examples

  • path is the location of the file
    • Delhi: ${execpi conkywx -d CT -c path/delhi.conf}
    • Cape Town: ${execpi conkywx -d CT -c path/capetown.conf}
    • Svalbard: ${execpi conkywx -d CT -c path/svalbard.conf}

-t --template option examples

  • template statement is the last statement below the TEXT statement in conkyrc file.
    • ${execpi 900 conkywx -c "path/conkywx.conf" -t "path/wx-wu-font-template"}
  • If you want to use the default conf file then no need to state the -c option.
    • ${execpi 900 conkywx -t "path/wx-wu-font-template"}
  • For more see the conkyrc and template files in /usr/share/conkywx/examples directory.

METAR examples

  • ${exec echo "[METAR]" | exec fmt -u -w 55}
  • OR
  • ${exec echo "[METAR]" | exec fold -s -w 55}

Weather Alerts examples

  • By default Present Condition information automatically gives the user Alert Indication by placing an exclamation before the present condition like ! Clear . There is no user input required.
  • If there are more than one alerts - the exclamation is followed by the number of alerts.
  • Conkywx Weather Alerts also provide the user with the Heading of the Alerts.
    • conkywx creates a text file called wxalert in the conkywx temp directory. Each conkywx config file you use - conkywx uses a separate temp directory in the /tmp partition.
    • The idea is to enable you to use this wxalert text file for showing a scrolling text of all the Alert headings.
    • To use this element so that it shows up only if there is an alert add the following code to your conkywx_rc. The ${scroll} does NOT work inside a conkywx template!
    • template3 line looks like this - this is referenced below - this is placed above the TEXT area
template3 /tmp/wx-param-conkywx-02.conf-pChA_r_27u0-m39/wxalert
${font DejaVu Sans Mono:bold:size=11}${color1}Weather Real${if_existing ${template3}} \
${color8}Alert: ${if_match ${execi 60 expr length "$(cat ${template3})"}>=32}\
${color5}${scroll 30 10 ${execi 60 cat ${template3}}}${else}\
${color5}${execi 60 cat ${template3}}${endif}${endif} ${color4}${hr 2}${font}

This is showing the complete line of the code - the scroll auto-show code starts at ${if_existing} and ends with ${endif} The ${template3} is the full path of wxalert example /tmp/conkywx_tmp_directory_name/wxalert Make sure NOT to put this conkywx_tmp_path/filename in quotes - it does not work then. Refer to the conky documentation for understanding the commands used at http://conky.sourceforge.net/docs.html

Making Life Simpler

  • We make a directory in your $HOME directory called conkyweather - you can call it what you like. This directory will look like /home/username/conkyweather or if you want in a bin subdirectory /home/username/bin/conkyweather
  • Copy the /usr/share/conkywx/examples directory and /usr/share/conkywx/conky-restart.sh to conkyweather directory
  • In the conky-restart.sh there is a line #5 WX_DIR="/usr/share/conkywx"; export WX_DIR - change this line so it looks like WX_DIR="$HOME/conkyweather"; export WX_DIR . The path of conkyweather directory is placed as shown - if it is in a bin subdirectory your path will be WX_DIR="$HOME/bin/conkyweather"; export WX_DIR
  • Now you can play with the examples as you wish and change them to what you like.
  • In a terminal window run /home/username/conkyweather/conky-restart.sh to start conkywx
  • Conkywx works in a certain way - forget how other weather programs work - just follow the examples.


  • As you will notice that for each -d data element you will need to state an execpi call - in other words for 20 data elements execpi will be executed 20 times - which will be slower in relative terms to a single call of execpi in -t template format. That is why templates are so much faster.

Go To Top of Page


  • Your conky version must be 1.9 or above - use conky -v to check the version of your conky program.
  • With conkywx ONE version you will require to install Time::Piece perl module on *Fedora*. yum install "perl(Time::Piece)" This module has been in the perl core since 5.9.5 but for some reason Fedora does not have that.
  • If you have space in your path - directory or file name - you need to quote the string passed to conky and conkywx.
    • example:
      • conky -c "$WX_DIR/examples/short-conkyrc.sh" -d
      • template2 "\"$WX_DIR/examples/short font template.sh\"" If you notice here the inner quotes are escaped using \ character as we want to pass the inner quotes with the file name to conkywx.
      • ${execpi 900 "${template0}" -c "${template1}" -t "${template2}"
  • If you are not getting display - run the file /usr/share/conkywx/conky-restart.sh in a terminal as a normal user and see the error messages. Chances are you will sort the issues in no time
  • If you are using gnome3 or Mint you may need to change the own_window_type in conkyrc file to normal or dock and then see if display comes up.
  • Sometimes we are faced with issues such as wrong data displayed - most is now being handled by the program. You have to check the website to confirm is data is same or not.
  • But human error is always a possibility. Specially in the configuration file. Care must be taken in the URL or ID numbers entered.
  • Errors in the terminal window can be many.
  • In a terminal window type conkywx . This will start conkywx assistant. Select the Debug option.
  • This will generate a wund-debug.log file in the wx-username-conkywx.conf-pChA_r_27u0-m39. The conkywx.conf will change based on the configuration file used.
  • This file has all the data information that is used by the program. It is divided in sections and each section has source information. This source has Location data or xml data.
  • Sometimes it is difficult to replicate an error - such as during start of system - if no display - use conkywx assistant and force update using option 3 to get website data updated.
  • The best way is to check the actual website if that has information.
  • Sometimes other problems may occur which we have no knowledge of yet
    • this file will pinpout where the data is not coming out correct
    • could also be that the element used in the *conkyrc.sh file by the user may be in error.

Go To Top of Page


They get ironed out as and if they popup - feedback is required.


Paramvir Likhari <plikhari at g mail dot com>


Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.