X-Git-Url: http://vcs.maemo.org/git/?a=blobdiff_plain;f=doc%2Fvariables.xml;h=bc5c36cf18f654a13eb2cca0aff8a831738797e1;hb=0c83d64a86fcaf4741f5fdf0013df7f9e48e30ac;hp=0dbaa827822809d9a2c72e9ac4b9013e6346bdb2;hpb=353f0b6ad71b380ceba6f2454ea9884a544d7123;p=monky diff --git a/doc/variables.xml b/doc/variables.xml index 0dbaa82..bc5c36c 100644 --- a/doc/variables.xml +++ b/doc/variables.xml @@ -1,2923 +1,4267 @@ - - - - - - - IP address for an interface, or "No Address" if no address is assigned. - - - - - - - - - - IP addresses for an interface (if one - works like addr). Linux only. - - - - - - - - - - ACPI ac adapter state. - - - - - - - - - ACPI fan state - - - - - - - - - ACPI temperature in C. - - - - - - - - - CPU temperature from therm_adt746x - - - - - - - - - Fan speed from therm_adt746x - - - - - - - - - - Right-justify text, with space of N - - - - - - - - - - Align text to centre - - - - - - - - - - - Sets up the connection to apcupsd daemon. Prints nothing, defaults to localhost:3551 - - - - - - - - - Prints the UPS user-defined name. - - - - - - - - - Prints the model of the UPS. - - - - - - - - - Prints the UPS mode (e.g. standalone). - - - - - - - - - Prints the UPS connection type. - - - - - - - - - Prints current status (on-line, on-battery). - - - - - - - - - Nominal input voltage. - - - - - - - - - Current load in percent. - - - - - - - - - Bar showing current load. - - - - - - - - - History graph of current load. - - - - - - - - - - Gauge that shows current load. - - - - - - - - - Current battery capacity in percent. - - - - - - - - - Time left to run on battery. - - - - - - - - - Current internal temperature. - - - - - - - - - Reason for last transfer from line to battery. - - - - - - - - - Display APM AC adapter status (FreeBSD only) - - - - - - - - - Display APM battery life in percent (FreeBSD only) - - - - - - - - - Display remaining APM battery life in hh:mm:ss or "unknown" if - AC adapterstatus is on-line or charging (FreeBSD only) - - - - - - - - - - Progress bar - - - - - - - - - Bitrate of current tune - - - - - - - - - Number of audio channels of current tune - - - - - - - - - Full path and filename of current tune - - - - - - - - - Sampling frequency of current tune - - - - - - - - - Total length of current tune as MM:SS - - - - - - - - - Total length of current tune in seconds - - - - - - - - - Playlist position of current tune - - - - - - - - - Number of tunes in playlist - - - - - - - - - Position of current tune (MM:SS) - - - - - - - - - Position of current tune in seconds - - - - - - - - - Player status (Playing/Paused/Stopped/Not running) - - - - - - - - - - Title of current tune with optional maximum length specifier - - - - - - - - - The current volume fetched from Audacious - - - - - - - - - - Battery status and remaining percentage capacity of ACPI or APM battery. ACPI battery number can be given as argument (default is BAT0). - - - - - - - - - - Battery status and remaining percentage capacity of ACPI or APM battery. ACPI battery number can be given as argument (default is BAT0). - This mode display a short status, which means that C is displayed instead of charging and D is displayed instead of discharging. - - - - - - - - - - Battery percentage remaining of ACPI battery in a bar. ACPI battery number can be given as argument (default is BAT0). - - - - - - - - - - Battery percentage remaining for ACPI battery. ACPI battery number can be given as argument (default is BAT0). - - - - - - - - - - Battery charge/discharge time remaining of ACPI battery. ACPI battery number can be given as argument (default is BAT0). - - - - - - - - - Artist in current BMPx track - - - - - - - - - Album in current BMPx track - - - - - - - - - Title of the current BMPx track - - - - - - - - - Track number of the current BMPx track - - - - - - - - - Bitrate of the current BMPx track - - - - - - - - - URI of the current BMPx track - - - - - - - - - Amount of memory buffered - - - - - - - - - Amount of memory cached - - - - - - - - - - Change drawing color to color - - - - - - - Change drawing color to colorN configuration option, where N is a digit between 0 and 9, inclusively. - - - - - - - - - - Places the lines of var2 to the right of the lines of var1 seperated by the chars that are put between var1 and var2. For example: ${combine ${head /proc/cpuinfo 2} - ${head /proc/meminfo 1}} gives as output "cpuinfo_line1 - meminfo_line1" on line 1 and "cpuinfo_line2 -" on line 2. $combine vars can also be nested to place more vars next to each other. - - - - - - - - - Conky version - - - - - - - - - Date Conky was built - - - - - - - - - CPU architecture Conky was built for - - - - - - - - - - CPU usage in percents. For SMP machines, the CPU number can be provided as an argument. ${cpu cpu0} is the total usage, and ${cpu cpuX} (X >= 1) are individual CPUs. - - - - - - - - - - Bar that shows CPU usage, height is bar's height in pixels. See $cpu for more info on SMP. - - - - - - - - - - Elliptical gauge that shows CPU usage, height and width are gauge's vertical and horizontal axis respectively. See $cpu for more info on SMP. - - - - - - - - - - CPU usage graph, with optional colours in hex, minus the #. See $cpu for more info on SMP. Uses a logarithmic scale (to see small numbers) when you use "log" instead of "normal". - - - - - - - - - - Displays current disk IO. Device is optional, and takes the form of sda for /dev/sda. Individual partitions are allowed. - - - - - - - - - - Disk IO graph, colours defined in hex, minus the #. If scale is non-zero, it becomes the scale for the graph. Uses a logarithmic scale (to see small numbers) when you use "log" instead of "normal". - - - - - - - - - - Displays current disk IO for reads. Device as in diskio. - - - - - - - - - - Disk IO graph for reads, colours defined in hex, minus the #. If scale is non-zero, it becomes the scale for the graph. Device as in diskio. Uses a logarithmic scale (to see small numbers) when you use "log" instead of "normal". - - - - - - - - - - Displays current disk IO for writes. Device as in diskio. - - - - - - - - - - Disk IO graph for writes, colours defined in hex, minus the #. If scale is non-zero, it becomes the scale for the graph. Device as in diskio. Uses a logarithmic scale (to see small numbers) when you use "log" instead of "normal". - - - - - - - - - - Disk protection status, if supported (needs kernel-patch). Prints either "frozen" or "free " (note the padding). - - - - - - - - - - Download speed in KiB - - - - - - - - - - Download speed in KiB with one decimal - - - - - - - - - - Download speed graph, colours defined in hex, minus the #. If scale is non-zero, it becomes the scale for the graph. Uses a logarithmic scale (to see small numbers) when you use "log" instead of "normal". - - - - - - - - - Text to show if any of the above are not true - - - - - - - - - Current entropy available for crypto freaks - - - - - - - - - - Normalized bar of available entropy for crypto freaks - - - - - - - - - Total size of system entropy pool for crypto freaks - - - - - - - - - - Evalutates given string according to the rules of TEXT interpretation, i.e. parsing any contained text object specifications into their output, any occuring '$$' into a single '$' and so on. The output is then being parsed again. - - - - - - - - - - Executes a shell command and displays the output in conky. warning: this takes a lot more resources than other variables. I'd recommend coding wanted behaviour in C and posting a patch. - - - - - - - - - - Same as exec, except if the first value return is a value between 0-100, it will use that number for a bar. The size for bars can be controlled via the default_bar_size config setting. - - - - - - - - - - Same as exec, except if the first value returned is a value between 0-100, it will use that number for a gauge. The size for gauges can be controlled via the default_gauge_size config setting. - - - - - - - - - - Same as execbar, but graphs values. Uses a logaritmic scale when the log option is given (to see small numbers). Values still have to be between 0 and 100. The size for graphs can be controlled via the default_graph_size config setting. - - - - - - - - - - Same as exec but with specific interval. Interval can't be less than update_interval in configuration. See also $texeci - - - - - - - - - - Same as execbar, except with an interval - - - - - - - - - - Same as execgraph, but takes an interval arg and graphs values. - - - - - - - - - - Same as execgauge, but takes an interval arg and gauges values. - - - - - - - - - - Executes a shell command and displays the output in conky. warning: this takes a lot more resources than other variables. I'd recommend coding wanted behaviour in C and posting a patch. This differs from $exec in that it parses the output of the command, so you can insert things like ${color red}hi!${color} in your script and have it correctly parsed by Conky. - Caveats: Conky parses and evaluates the output of $execp every time Conky loops, and then destroys all the objects. If you try to use anything like $execi within an $execp statement, it will functionally run at the same interval that the $execp statement runs, as it is created and destroyed at every interval. - - - - - - - - - - Same as execp but with specific interval. Interval can't be less than update_interval in configuration. Note that the output from the $execpi command is still parsed and evaluated at every interval. - - - - - - - - - - Specify a different font. This new font will apply to the current line and everything following. You can use a $font with no arguments to change back to the default font (much like with $color) - - - - - - - - - - Returns CPU #n's frequency in MHz. CPUs are counted from 1. If omitted, the parameter defaults to 1. - - - - - - - - - Returns CPU #n's frequency in GHz. CPUs are counted from 1. If omitted, the parameter defaults to 1. - - - - - - - - - - Bar that shows how much space is used on a file system. height is the height in pixels. fs is any file on that file system. - - - - - - - - - - Bar that shows how much space is free on a file system. height is the height in pixels. fs is any file on that file system. - - - - - - - - - - Free space on a file system available for users. - - - - - - - - - - Free percentage of space on a file system available for users. - - - - - - - - - - File system size. - - - - - - - - - - File system type. - - - - - - - - - - File system used space. - - - - - - - - - - Percent of file system used space. - - - - - - - - - - The next element will be printed at position 'x'. - - - - - - - - - Displays the default route's interface or "multiple"/"none" accordingly. - - - - - - - - - Displays the default gateway's IP or "multiple"/"none" accordingly. - - - - - - - - - - Displays temperature of a selected hard disk drive as reported by the hddtemp daemon running on host:port. - Default host is 127.0.0.1, default port is 7634. - - - - - - - - - - Displays first N lines of supplied text text file. If interval is not supplied, Conky assumes 2x Conky's interval. Max of 30 lines can be displayed, or until the text buffer is filled. - - - - - - - - - - Horizontal line, height is the height in pixels - - - - - - - - - - Hwmon sensor from sysfs (Linux 2.6). Parameter dev may be omitted if you have only one hwmon device. Parameter type is either 'in' or 'vol' meaning voltage; 'fan' meaning fan; 'temp' meaning temperature. Parameter n is number of the sensor. See /sys/class/hwmon/ on your local computer. The optional arguments 'factor' and 'offset' allow precalculation of the raw input, which is being modified as follows: 'input = input * factor + offset'. Note that they have to be given as decimal values (i.e. contain at least one decimal place). - - - - - - - - - - Convert text from one codeset to another using GNU iconv. Needs to be stopped with iconv_stop. - - - - - - - - - - Stop iconv codeset conversion. - - - - - - - - - - Renders an image from the path specified using IMLIB2. Takes 2 optional arguments, one being a position, the other an size. Changing the x,y position will move the position of the image, and changing the WxH will scale the image. Example: ${image /home/brenden/cheeseburger.jpg -p 20,20 -s 200x200} will render 'cheeseburger.jpg' at (20,20) scaled to 200x200 pixels. - - - - - - - - - - I2C sensor from sysfs (Linux 2.6). Parameter dev may be omitted if you have only one I2C device. Parameter type is either 'in' or 'vol' meaning voltage; 'fan' meaning fan; 'temp' meaning temperature. Parameter n is number of the sensor. See /sys/bus/i2c/devices/ on your local computer. - - - - - - - - - - If running the i8k kernel driver for Inspiron laptops, displays whether ac power is on, as listed in /proc/i8k (translated to human-readable). Beware that this is by default not enabled by i8k itself. - - - - - - - - - - If running the i8k kernel driver for Inspiron laptops, displays the bios version as listed in /proc/i8k. - - - - - - - - - - If running the i8k kernel driver for Inspiron laptops, displays the volume buttons status as listed in /proc/i8k. - - - - - - - - - - If running the i8k kernel driver for Inspiron laptops, displays the cpu temperature in Celsius, as reported by /proc/i8k. - - - - - - - - - - If running the i8k kernel driver for Inspiron laptops, displays the left fan's rate of rotation, in revolutions per minute as listed in /proc/i8k. Beware, some laptops i8k reports these fans in reverse order. - - - - - - - - - - If running the i8k kernel driver for Inspiron laptops, displays the left fan status as listed in /proc/i8k (translated to human-readable). Beware, some laptops i8k reports these fans in reverse order. - - - - - - - - - - If running the i8k kernel driver for Inspiron laptops, displays the right fan's rate of rotation, in revolutions per minute as listed in /proc/i8k. Beware, some laptops i8k reports these fans in reverse order. - - - - - - - - - - If running the i8k kernel driver for Inspiron laptops, displays the right fan status as listed in /proc/i8k (translated to human-readable). Beware, some laptops i8k reports these fans in reverse order. - - - - - - - - - - If running the i8k kernel driver for Inspiron laptops, displays your laptop serial number as listed in /proc/i8k. - - - - - - - - - - If running the i8k kernel driver for Inspiron laptops, displays the version formatting of /proc/i8k. - - - - - - - - - If running the IBM ACPI, displays the fan speed. - - - - - - - - - - If running the IBM ACPI, displays the temperatures - from the IBM temperature sensors (N=0..7) Sensor 0 is - on the CPU, 3 is on the GPU. - - - - - - - - - If running the IBM ACPI, displays the "master" volume, - controlled by the volume keys (0-14). - - - - - - - - - If running the IBM ACPI, displays the brigtness of the - laptops's LCD (0-7). - - - - - - - - - - if conky variable VAR is empty, display everything - between $if_empty and the matching $endif - - - - - - - - - - if FILE exists, display everything between if_existing - and the matching $endif. The optional second paramater - checks for FILE containing the specified string and - prints everything between $if_existing and the matching - $endif. - - - - - - - - - if there is at least one default gateway, display - everything between $if_gw and the matching $endif - - - - - - - - - - Evaluates the given boolean expression, printing - everything between $if_match and the matching $endif - depending on whether the evaluation returns true or not. - Valid expressions consist of a left side, an operator - and a right side. Left and right sides are being parsed - for contained text objects before evaluation. Recognised - left and right side types are: - - double: - argument consists of only digits and a - single dot. + + + + + + + + ACPI ac adapter state. On linux, the adapter option specifies the + subfolder of /sys/class/power_supply containing the state information (defaults + to "AC"). Other systems ignore it. + + + + + + + + + ACPI fan state + + + + + + + + + ACPI temperature in C. + + + + + + + + + + IP address for an interface, or "No Address" if + no address is assigned. + + + + + + + + + + IP addresses for an interface (if one - works + like addr). Linux only. + + + + + + + + + CPU temperature from therm_adt746x + + + + + + + + + Fan speed from therm_adt746x + + + + + + + + + + Align text to centre + + + + + + + + + + Right-justify text, with space of N + + + + + + + + + + + Sets up the connection to apcupsd daemon. Prints + nothing, defaults to localhost:3551 + + + + + + + + + Prints the UPS connection type. + + + + + + + + + Current battery capacity in percent. + + + + + + + + + Reason for last transfer from line to battery. + + + + + + + + + Nominal input voltage. + + + + + + + + + Current load in percent. + + + + + + + + + Bar showing current load. + + + + + + + + + + Gauge that shows current load. + + + + + + + + + + History graph of current load. + + + + + + + + + Prints the model of the UPS. + + + + + + + + + Prints the UPS user-defined name. + + + + + + + + + Prints current status (on-line, on-battery). + + + + + + + + + Current internal temperature. + + + + + + + + + Time left to run on battery. + + + + + + + + + Prints the UPS mode (e.g. standalone). + + + + + + + + + Display APM AC adapter status (FreeBSD only) + + + + + + + + + Display APM battery life in percent (FreeBSD + only) + + + + + + + + + Display remaining APM battery life in hh:mm:ss or + "unknown" if AC adapterstatus is on-line or charging + (FreeBSD only) + + + + + + + + + + Progress bar + + + + + + + + + Bitrate of current tune + + + + + + + + + Number of audio channels of current tune + + + + + + + + + Full path and filename of current tune + + + + + + + + + Sampling frequency of current tune + + + + + + + + + Total length of current tune as MM:SS + + + + + + + + + Total length of current tune in seconds + + + + + + + + + The current volume fetched from Audacious + + + + + + + + + Number of tunes in playlist + + + + + + + + + Playlist position of current tune + + + + + + + + + Position of current tune (MM:SS) + + + + + + + + + Position of current tune in seconds + + + + + + + + + Player status (Playing/Paused/Stopped/Not + running) + + + + + + + + + + Title of current tune with optional maximum + length specifier + + + + + + + + + + Battery status and remaining percentage capacity + of ACPI or APM battery. ACPI battery number can be given as + argument (default is BAT0). + + + + + + + + + + Battery percentage remaining of ACPI battery in a + bar. ACPI battery number can be given as argument (default + is BAT0). + + + + + + + + + + Battery percentage remaining for ACPI battery. + ACPI battery number can be given as argument (default is + BAT0). + + + + + + + + + + Battery status and remaining percentage capacity + of ACPI or APM battery. ACPI battery number can be given as + argument (default is BAT0). This mode display a short + status, which means that C is displayed instead of + charging, D for discharging, F for full, N for not present, + E for empty and U for unknown. + + + + + + + + + + Battery charge/discharge time remaining of ACPI + battery. ACPI battery number can be given as argument + (default is BAT0). + + + + + + + + + + Let 'text_and_other_conky_vars' blink on and off. + + + + + + + + + + Album in current BMPx track + + + + + + + + + Artist in current BMPx track + + + + + + + + + Bitrate of the current BMPx track + + + + + + + + + Title of the current BMPx track + + + + + + + + + Track number of the current BMPx track + + + + + + + + + URI of the current BMPx track + + + + + + + + + Amount of memory buffered + + + + + + + + + Amount of memory cached + + + + + + + + + + PID of the first process that has string in it's + commandline + + + + + + + + + + Change drawing color to 'color' which is a name of + a color or a hexcode preceded with # (for example #0A1B2C ). + If you use ncurses only the following colors are supported: + red,green,yellow,blue,magenta,cyan,black,white. + + + + + + + + + Change drawing color to colorN configuration + option, where N is a digit between 0 and 9, inclusively. + + + + + + + + + + Places the lines of var2 to the right of the + lines of var1 separated by the chars that are put between + var1 and var2. For example: ${combine ${head /proc/cpuinfo + 2} - ${head /proc/meminfo 1}} gives as output + "cpuinfo_line1 - meminfo_line1" on line 1 and + "cpuinfo_line2 -" on line 2. $combine vars can also be + nested to place more vars next to each other. + + + + + + + + + CPU architecture Conky was built for + + + + + + + + + Date Conky was built + + + + + + + + + Conky version + + + + + + + + + + CPU usage in percents. For SMP machines, the CPU + number can be provided as an argument. ${cpu cpu0} is the + total usage, and ${cpu cpuX} (X >= 1) are individual + CPUs. + + + + + + + + + + Bar that shows CPU usage, height is bar's height + in pixels. See $cpu for more info on SMP. + + + + + + + + + + Elliptical gauge that shows CPU usage, height and + width are gauge's vertical and horizontal axis + respectively. See $cpu for more info on SMP. + + + + + + + + + + CPU usage graph, with optional colours in hex, + minus the #. See $cpu for more info on SMP. Uses a + logarithmic scale (to see small numbers) when you use the + -l switch. Takes the switch '-t' to use a temperature + gradient, which makes the gradient values change depending + on the amplitude of a particular graph value (try it and + see). + + + + + + + + + + + Download data from URI using Curl at the + specified interval. The interval may be a floating + point value greater than 0, otherwise defaults to 15 + minutes. Most useful when used in conjunction with Lua + and the Lua API. This object is threaded, and once a + thread is created it can't be explicitly destroyed. + One thread will run for each URI specified. You can use + any protocol that Curl supports. + + + + + + + + + Number of the desktop on which conky is running + or the message "Not running in X" if this is the case. + + + + + + + + + Name of the desktop on which conky is running or + the message "Not running in X" if this is the case. + + + + + + + + + Number of desktops or the message "Not running in + X" if this is the case. + + + + + + + + + + Disk protection status, if supported (needs + kernel-patch). Prints either "frozen" or "free " (note the + padding). + + + + + + + + + + Displays current disk IO. Device is optional, and + takes the form of sda for /dev/sda. Individual partitions + are allowed. + + + + + + + + + + Displays current disk IO for reads. Device as in + diskio. + + + + + + + + + + Displays current disk IO for writes. Device as in + diskio. + + + + + + + + + + Disk IO graph, colours defined in hex, minus the + #. If scale is non-zero, it becomes the scale for the + graph. Uses a logarithmic scale (to see small numbers) when + you use -l switch. Takes the switch '-t' to use a + temperature gradient, which makes the gradient values + change depending on the amplitude of a particular graph + value (try it and see). + + + + + + + + + + Disk IO graph for reads, colours defined in hex, + minus the #. If scale is non-zero, it becomes the scale for + the graph. Device as in diskio. Uses a logarithmic scale + (to see small numbers) when you use -l switch. Takes the + switch '-t' to use a temperature gradient, which makes the + gradient values change depending on the amplitude of a + particular graph value (try it and see). + + + + + + + + + + Disk IO graph for writes, colours defined in hex, + minus the #. If scale is non-zero, it becomes the scale for + the graph. Device as in diskio. Uses a logarithmic scale + (to see small numbers) when you use -l switch. Takes the + switch '-t' to use a temperature gradient, which makes the + gradient values change depending on the amplitude of a + particular graph value (try it and see). + + + + + + + + + + Download speed in suitable IEC units + + + + + + + + + + Download speed in KiB with one decimal + + + + + + + + + + Download speed graph, colours defined in hex, + minus the #. If scale is non-zero, it becomes the scale for + the graph. Uses a logarithmic scale (to see small numbers) + when you use -l switch. Takes the switch '-t' to use a + temperature gradient, which makes the gradient values + change depending on the amplitude of a particular graph + value (try it and see). + + + + + + + + + + + Number of mails marked as draft in the specified + mailbox or mail spool if not. Only maildir type mailboxes + are supported, mbox type will return -1. + + + + + + + + + Text to show if any of the above are not true + + + + + + + + + Ends an $if block. + + + + + + + + + Current entropy available for crypto freaks + + + + + + + + + + Normalized bar of available entropy for crypto + freaks + + + + + + + + + Percentage of entropy available in comparison to + the poolsize + + + + + + + + + Total size of system entropy pool for crypto + freaks + + + + + + + + + + Evaluates given string according to the rules of + TEXT interpretation, i.e. parsing any contained text object + specifications into their output, any occuring '$$' into a + single '$' and so on. The output is then being parsed + again. + + + + + + + + + + Fetches your currently training skill from the + Eve Online API servers (http://www.eve-online.com/) and + displays the skill along with the remaining training time. + + + + + + + + + + Executes a shell command and displays the output + in conky. warning: this takes a lot more resources than + other variables. I'd recommend coding wanted behaviour in C + and posting a patch. + + + + + + + + + + Same as exec, except if the first value return is + a value between 0-100, it will use that number for a bar. + The size for bars can be controlled via the + default_bar_size config setting. + + + + + + + + + + Same as exec, except if the first value returned + is a value between 0-100, it will use that number for a + gauge. The size for gauges can be controlled via the + default_gauge_size config setting. + + + + + + + + + + Same as execbar, but graphs values. Uses a + logaritmic scale when the log option (-l switch) is given + (to see small numbers). Values still have to be between 0 + and 100. The size for graphs can be controlled via the + default_graph_size config setting. Takes the switch '-t' to + use a temperature gradient, which makes the gradient values + change depending on the amplitude of a particular graph + value (try it and see). If -t or -l is your first argument, + you may need to preceed it by a space (' '). + + + + + + + + + + Same as exec but with specific interval. Interval + can't be less than update_interval in configuration. See + also $texeci + + + + + + + + + + Same as execbar, except with an interval + + + + + + + + + + Same as execgauge, but takes an interval arg and + gauges values. + + + + + + + + + + Same as execgraph, but takes an interval arg and + graphs values. If -t or -l is your first argument, you may + need to preceed it by a space (' '). + + + + + + + + + + Executes a shell command and displays the output + in conky. warning: this takes a lot more resources than + other variables. I'd recommend coding wanted behaviour in C + and posting a patch. This differs from $exec in that it + parses the output of the command, so you can insert things + like ${color red}hi!${color} in your script and have it + correctly parsed by Conky. Caveats: Conky parses and + evaluates the output of $execp every time Conky loops, and + then destroys all the objects. If you try to use anything + like $execi within an $execp statement, it will + functionally run at the same interval that the $execp + statement runs, as it is created and destroyed at every + interval. + + + + + + + + + + Same as execp but with specific interval. + Interval can't be less than update_interval in + configuration. Note that the output from the $execpi + command is still parsed and evaluated at every interval. + + + + + + + + + + + Number of mails marked as flagged in the + specified mailbox or mail spool if not. Only maildir type + mailboxes are supported, mbox type will return -1. + + + + + + + + + + Specify a different font. This new font will + apply to the current line and everything following. You can + use a $font with no arguments to change back to the default + font (much like with $color) + + + + + + + + + + Format time given in seconds. This var only works when + the times_in_seconds configuration setting is on. Format is a string + that should start and end with a "-char. The "-chars are not + part of the output, \w,\d,\h,\m,\s,\(,\) and \\ are replaced by + weeks,days,hours,minutes,seconds,(,) and \. If you leave out a unit, + it's value will be expressed in the highest unite lower then the + one left out. Text between ()-chars will not be visible if a + replaced unit in this text is 0. If seconds is a decimal number + then you can see the numbers behind the point by using \S + followed by a number that specifies the amount of + digits behind the point that you want to see (maximum 9). + You can also place a 'x' behind \S so you have all digits behind + the point and no trailing zero's. (also maximum 9) + + + + + + + + + + + Number of mails marked as forwarded in the + specified mailbox or mail spool if not. Only maildir type + mailboxes are supported, mbox type will return -1. + + + + + + + + + + Returns CPU #n's frequency in MHz. CPUs are + counted from 1. If omitted, the parameter defaults to 1. + + + + + + + + + + Returns CPU #n's frequency in GHz. CPUs are + counted from 1. If omitted, the parameter defaults to 1. + + + + + + + + + + Bar that shows how much space is used on a file + system. height is the height in pixels. fs is any file on + that file system. + + + + + + + + + + Bar that shows how much space is free on a file + system. height is the height in pixels. fs is any file on + that file system. + + + + + + + + + + Free space on a file system available for users. + + + + + + + + + + Free percentage of space on a file system + available for users. + + + + + + + + + + File system size. + + + + + + + + + + File system type. + + + + + + + + + + File system used space. + + + + + + + + + + Percent of file system used space. + + + + + + + + + + The next element will be printed at position 'x'. + + + + + + + + + + Displays the default route's interface or + "multiple"/"none" accordingly. + + + + + + + + + Displays the default gateway's IP or + "multiple"/"none" accordingly. + + + + + + + + + + Displays temperature of a selected hard disk + drive as reported by the hddtemp daemon. Use hddtemp_host + and hddtemp_port to specify a host and port for all hddtemp + objects. If no dev parameter is given, the first disk returned + by the hddtemp daemon is used. + + + + + + + + + + Displays first N lines of supplied text file. The + file is checked every 'next_check' update. If next_check is + not supplied, Conky defaults to 2. Max of 30 lines can be + displayed, or until the text buffer is filled. + + + + + + + + + + Horizontal line, height is the height in pixels + + + + + + + + + + Hwmon sensor from sysfs (Linux 2.6). Parameter + dev may be omitted if you have only one hwmon device. + Parameter type is either 'in' or 'vol' meaning voltage; + 'fan' meaning fan; 'temp' meaning temperature. Parameter n + is number of the sensor. See /sys/class/hwmon/ on your + local computer. The optional arguments 'factor' and + 'offset' allow precalculation of the raw input, which is + being modified as follows: 'input = input * factor + + offset'. Note that they have to be given as decimal values + (i.e. contain at least one decimal place). + + + + + + + + + + I2C sensor from sysfs (Linux 2.6). Parameter dev + may be omitted if you have only one I2C device. Parameter + type is either 'in' or 'vol' meaning voltage; 'fan' meaning + fan; 'temp' meaning temperature. Parameter n is number of + the sensor. See /sys/bus/i2c/devices/ on your local + computer. The optional arguments 'factor' and 'offset' + allow precalculation of the raw input, which is being + modified as follows: 'input = input * factor + offset'. + Note that they have to be given as decimal values (i.e. + contain at least one decimal place). + + + + + + + + + If running the i8k kernel driver for Inspiron + laptops, displays whether ac power is on, as listed in + /proc/i8k (translated to human-readable). Beware that this + is by default not enabled by i8k itself. + + + + + + + + + If running the i8k kernel driver for Inspiron + laptops, displays the bios version as listed in /proc/i8k. + + + + + + + + + If running the i8k kernel driver for Inspiron + laptops, displays the volume buttons status as listed in + /proc/i8k. + + + + + + + + + If running the i8k kernel driver for Inspiron + laptops, displays the cpu temperature in Celsius, as + reported by /proc/i8k. + + + + + + + + + If running the i8k kernel driver for Inspiron + laptops, displays the left fan's rate of rotation, in + revolutions per minute as listed in /proc/i8k. Beware, some + laptops i8k reports these fans in reverse order. + + + + + + + + + If running the i8k kernel driver for Inspiron + laptops, displays the left fan status as listed in + /proc/i8k (translated to human-readable). Beware, some + laptops i8k reports these fans in reverse order. + + + + + + + + + If running the i8k kernel driver for Inspiron + laptops, displays the right fan's rate of rotation, in + revolutions per minute as listed in /proc/i8k. Beware, some + laptops i8k reports these fans in reverse order. + + + + + + + + + If running the i8k kernel driver for Inspiron + laptops, displays the right fan status as listed in + /proc/i8k (translated to human-readable). Beware, some + laptops i8k reports these fans in reverse order. + + + + + + + + + If running the i8k kernel driver for Inspiron + laptops, displays your laptop serial number as listed in + /proc/i8k. + + + + + + + + + If running the i8k kernel driver for Inspiron + laptops, displays the version formatting of /proc/i8k. + + + + + + + + + If running the IBM ACPI, displays the brigtness + of the laptops's LCD (0-7). + + + + + + + + + If running the IBM ACPI, displays the fan speed. + + + + + + + + + + If running the IBM ACPI, displays the + temperatures from the IBM temperature sensors (N=0..7) + Sensor 0 is on the CPU, 3 is on the GPU. + + + + + + + + + If running the IBM ACPI, displays the "master" + volume, controlled by the volume keys (0-14). + + + + + + + + + + Convert text from one codeset to another using + GNU iconv. Needs to be stopped with iconv_stop. + + + + + + + + + Stop iconv codeset conversion. + + + + + + + + + + if conky variable VAR is empty, display + everything between $if_empty and the matching $endif + + + + + + + + + + if FILE exists, display everything between + if_existing and the matching $endif. The optional second + paramater checks for FILE containing the specified string + and prints everything between $if_existing and the matching + $endif. + + + + + + + + + if there is at least one default gateway, display + everything between $if_gw and the matching $endif + + + + + + + + + + Evaluates the given boolean expression, printing + everything between $if_match and the matching $endif + depending on whether the evaluation returns true or not. + Valid expressions consist of a left side, an operator and a + right side. Left and right sides are being parsed for + contained text objects before evaluation. Recognised left + and right side types are: + + + doubleArgument consists of only + digits and a single dot. + + longArgument consists of only + digits. + + stringArgument is enclosed in + quotation marks (") + Valid operands are: '>', '<', '>=', + '<=', '==', '!='. + + + + + + + + + + If mixer exists, display everything between + $if_mixer_mute and the matching $endif. If no mixer is + specified, "Master" is used. + + + + + + + + + + if MOUNTPOINT is mounted, display everything + between $if_mounted and the matching $endif + + + + + + + + + if mpd is playing or paused, display everything + between $if_mpd_playing and the matching $endif + + + + + + + + + + if PROCESS is running, display everything + $if_running and the matching $endif. This uses the + ``pidof'' command, so the -x switch is also supported. + + + + + + + + + + when using smapi, if the battery with index INDEX + is installed, display everything between + $if_smapi_bat_installed and the matching $endif + + + + + + + + + + if INTERFACE exists and is up, display everything + between $if_up and the matching $endif + + + + + + + + + + If it's the UPDATENR-th time that conky updates, + display everything between $if_updatenr and the matching + $endif. The counter resets when the highest UPDATENR is + reached. Example : "{$if_updatenr 1}foo$endif{$if_updatenr + 2}bar$endif{$if_updatenr 4}$endif" shows foo 25% of the + time followed by bar 25% of the time followed by nothing + the other half of the time. + + + + + + + + + Display everything between $if_xmms2_connected + and the matching $endif if xmms2 is running. + + + + + + + + + + Renders an image from the path specified using + Imlib2. Takes 4 optional arguments: a position, a size, a + no-cache switch, and a cache flush interval. Changing the + x,y position will move the position of the image, and + changing the WxH will scale the image. If you specify the + no-cache flag (-n), the image will not be cached. + Alternately, you can specify the -f int switch to specify a + cache flust interval for a particular image. Example: + ${image /home/brenden/cheeseburger.jpg -p 20,20 -s 200x200} + will render 'cheeseburger.jpg' at (20,20) scaled to 200x200 + pixels. Conky does not make any attempt to adjust the + position (or any other formatting) of images, they are just + rendered as per the arguments passed. The only reason + $image is part of the TEXT section, is to allow for runtime + modifications, through $execp $lua_parse, or some other + method. + + + + + + + + + + Displays the number of messages in your global + IMAP inbox by default. You can define individual IMAP + inboxes separately by passing arguments to this object. + Arguments are: "host user pass [-i interval (in seconds)] + [-f 'folder'] [-p port] [-e 'command'] [-r retries]". Default + port is 143, default folder is 'INBOX', default interval is + 5 minutes, and default number of retries before giving up + is 5. If the password is supplied as '*', you will be + prompted to enter the password when Conky starts. + + + + + + + + + + Displays the number of unseen messages in your + global IMAP inbox by default. You can define individual + IMAP inboxes separately by passing arguments to this + object. Arguments are: "host user pass [-i interval (in + seconds)] [-f 'folder'] [-p port] [-e 'command'] [-r retries]". + Default port is 143, default folder is 'INBOX', default + interval is 5 minutes, and default number of retries before + giving up is 5. If the password is supplied as '*', you + will be prompted to enter the password when Conky starts. + + + + + + + + + + + Loads the configfile at path, places the + configsettings behind the configsettings in the orginal + config and places the vars where the includevar + stood. + + + + + + + + + + Prints the current ioscheduler used for the given + disk name (i.e. e.g. "hda" or "sdb") + + + + + + + + + Kernel version + + + + + + + + + The value of /proc/sys/vm/laptop_mode + + + + + + + + + + Displays the number of lines in the given file + + + + + + + + + + System load average, 1 is for past 1 minute, 2 + for past 5 minutes and 3 for past 15 minutes. Without argument, prints + all three values separated by whitespace. + + + + + + + + + + Load1 average graph, similar to xload, with + optional colours in hex, minus the #. Uses a logarithmic + scale (to see small numbers) when you use the -l switch. + Takes the switch '-t' to use a temperature gradient, which + makes the gradient values change depending on the amplitude + of a particular graph value (try it and see). + + + + + + + + + + Executes a Lua function with given parameters, + then prints the returned string. See also 'lua_load' on how + to load scripts. Conky puts 'conky_' in front of + function_name to prevent accidental calls to the wrong + function unless you put you place 'conky_' in front of it + yourself. + + + + + + + + + + Executes a Lua function with given parameters and + draws a bar. Expects result value to be an integer between + 0 and 100. See also 'lua_load' on how to load scripts. + Conky puts 'conky_' in front of function_name to prevent + accidental calls to the wrong function unless you put you + place 'conky_' in front of it yourself. + + + + + + + + + + Executes a Lua function with given parameters and + draws a gauge. Expects result value to be an integer + between 0 and 100. See also 'lua_load' on how to load + scripts. Conky puts 'conky_' in front of function_name to + prevent accidental calls to the wrong function unless you + put you place 'conky_' in front of it yourself. + + + + + + + + + + Executes a Lua function with and draws a graph. + Expects result value to be any number, and by default will + scale to show the full range. See also 'lua_load' on how to + load scripts. Takes the switch '-t' to use a temperature + gradient, which makes the gradient values change depending + on the amplitude of a particular graph value (try it and + see). Conky puts 'conky_' in front of function_name to + prevent accidental calls to the wrong function unless you + put you place 'conky_' in front of it yourself. + + + + + + + + + + Executes a Lua function with given parameters as + per $lua, then parses and prints the result value as per + the syntax for Conky's TEXT section. See also 'lua_load' on + how to load scripts. Conky puts 'conky_' in front of + function_name to prevent accidental calls to the wrong + function unless you put you place 'conky_' in front of it + yourself. + + + + + + + + + Machine, i686 for example + + + + + + + + + + + Mail count in the specified mailbox or your mail + spool if not. Both mbox and maildir type mailboxes are + supported. You can use a program like fetchmail to get + mails from some server using your favourite protocol. See + also new_mails. + + + + + + + + + + Print a summary of recent messages in an mbox + format mailbox. mbox parameter is the filename of the + mailbox (can be encapsulated using '"', ie. ${mboxscan -n + 10 "/home/brenden/some box"} + + + + + + + + + Amount of memory in use + + + + + + + + + + Bar that shows amount of memory in use + + + + + + + + + Amount of free memory including the memory that + is very easily freed (buffers/cache) + + + + + + + + + Amount of free memory + + + + + + + + + + Gauge that shows amount of memory in use (see + cpugauge) + + + + + + + + + + Memory usage graph. Uses a logarithmic scale (to + see small numbers) when you use the -l switch. Takes the + switch '-t' to use a temperature gradient, which makes the + gradient values change depending on the amplitude of a + particular graph value (try it and see). + + + + + + + + + Total amount of memory + + + + + + + + + Percentage of memory in use + + + + + + + + + + Prints the mixer value as reported by the OS. + Default mixer is "vol", but you can specify one of the + following optional arguments: "vol", "bass", "treble", + "synth", "pcm", "speaker", "line", "mic", "cd", "mix", + "pcm2", "rec", "igain", "ogain", "line1", "line2", "line3", + "dig1", "dig2", "dig3", "phin", "phout", "video", "radio", + "monitor". Refer to the definition of SOUND_DEVICE_NAMES in + <linux/soundcard.h> (on Linux), <soundcard.h> + (on OpenBSD), or <sys/soundcard.h> to find the exact + options available on your system. + + + + + + + + + + Displays mixer value in a bar as reported by the + OS. See docs for $mixer for details on arguments. + + + + + + + + + + Prints the left channel mixer value as reported + by the OS. See docs for $mixer for details on arguments. + + + + + + + + + + Displays the left channel mixer value in a bar as + reported by the OS. See docs for $mixer for details on + arguments. + + + + + + + + + + Prints the right channel mixer value as reported + by the OS. See docs for $mixer for details on arguments. + + + + + + + + + + Displays the right channel mixer value in a bar + as reported by the OS. See docs for $mixer for details on + arguments. + + + + + + + + + Album of the current MOC song + + + + + + + + + Artist of the current MOC song + + + + + + + + + Bitrate in the current MOC song + + + + + + + + + Current time of the current MOC song + + + + + + + + + File name of the current MOC song + + + + + + + + + Rate of the current MOC song + + + + + + + + + The current song name being played in MOC. + + + + + + + + + Current state of MOC; playing, stopped etc. + + + + + + + + + Time left in the current MOC song + + + + + + + + + Title of the current MOC song + + + + + + + + + Total length of the current MOC song + + + + + + + + + Number of the monitor on which conky is running + or the message "Not running in X" if this is the case. + + + + + + + + + Number of monitors or the message "Not running in + X" if this is the case. + + + + + + + + + Album in current MPD song + + + + + + + + + Artist in current MPD song must be enabled at + compile + + + + + + + + + + Bar of mpd's progress + + + + + + + + + Bitrate of current song + + + + + + + + + Song's elapsed time + + + + + + + + + Prints the file name of the current MPD song + + + + + + + + + Song's length + + + + + + + + + Prints the MPD name field + + + + + + + + + Percent of song's progress + + + + + + + + + Random status (On/Off) + + + + + + + + + Repeat status (On/Off) + + + + + + + + + + Prints the song name in either the form "artist - + title" or file name, depending on whats available + + + + + + + + + Playing, stopped, et cetera. + + + + + + + + + + Title of current MPD song + + + + + + + + + Prints the MPD track field + + + + + + + + + MPD's volume + + + + + + + + + + Print a nameserver from /etc/resolv.conf. Index + starts at and defaults to 0. + + + + + + + + + + + Unread mail count in the specified mailbox or + mail spool if not. Both mbox and maildir type mailboxes are + supported. + + + + + + + + + Hostname + + + + + + + + + + + + + + + Nvidia graficcard support for the XNVCtrl + library. Each option can be shortened to the least + significant part. Temperatures are printed as float, all + other values as integer. + + + threshold + + + + temp + + + + ambient + + + + gpufreq + + + + memfreq + + + + imagequality + + + + + + + + + + + + + Move text over by N pixels. See also $voffset. + + + + + + + + + + Change outline color + + + + + + + + + + If running on Apple powerbook/ibook, display + information on battery status. The item parameter + specifies, what information to display. Exactly one item + must be specified. Valid items are: + + + status + + + + percent + + + + time + + + + + + + + + + + + + Directory used as rootdirectory by the process + (this will be "/" unless the process did a chroot syscall) + + + + + + + + + + Command line this process was invoked with + + + + + + + + + + Current working directory of the process + + + + + + + + + + Contents of a environment-var of the process + + + + + + + + + + List of environment-vars that the process can see + + + + + + + + + + Path to executed command that started the process + + + + + + + + + + The nice value of the process + + + + + + + + + + List of files that the process has open + + + + + + + + + + The pid of the parent of the process + + + + + + + + + + The priority of the process (see 'priority' in "man 5 proc") + + + + + + + + + + Total number of bytes read by the process + + + + + + + + + + State of the process + + + + + + + + + + One of the chars in "RSDZTW" representing the state + of the process where R is running, S is sleeping in an + interruptible wait, D is waiting in uninterruptible disk sleep, + Z is zombie, T is traced or stopped (on a signal), and W is paging + + + + + + + + + + Filedescriptor binded to the STDERR of the process + + + + + + + + + + Filedescriptor binded to the STDIN of the process + + + + + + + + + + Filedescriptor binded to the STDOUT of the process + + + + + + + + + + Number of threads in process containing this thread + + + + + + + + + + List with pid's from threads from this process + + + + + + + + + + Amount of time that the process has been scheduled in kernel mode in seconds + + + + + + + + + + Amount of time that the process has been scheduled in user mode in seconds + + + + + + + + + + Sum of $pid_time_kernelmode and $pid_time_usermode + + + + + + + + + + The real uid of the process + + + + + + + + + + The effective uid of the process + + + + + + + + + + The saved set uid of the process + + + + + + + + + + The file system uid of the process + + + + + + + + + + The real gid of the process + + + + + + + + + + The effective gid of the process + + + + + + + + + + The saved set gid of the process + + + + + + + + + + The file system gid of the process + + + + + + + + + + Peak virtual memory size of the process + + + + + + + + + + Virtual memory size of the process + + + + + + + + + + Locked memory size of the process + + + + + + + + + + Peak resident set size ("high water mark") of the process + + + + + + + + + + Resident set size of the process + + + + + + + + + + Data segment size of the process + + + + + + + + + + Stack segment size of the process + + + + + + + + + + Text segment size of the process + + + + + + + + + + Shared library code size of the process + + + + + + + + + + Page table entries size of the process + + + + + + + + + + Total number of bytes written by the process + + + + + + + + + + Platform sensor from sysfs (Linux 2.6). Parameter + dev may be omitted if you have only one platform device. + Platform type is either 'in' or 'vol' meaning voltage; + 'fan' meaning fan; 'temp' meaning temperature. Parameter n + is number of the sensor. See /sys/bus/platform/devices/ on + your local computer. The optional arguments 'factor' and + 'offset' allow precalculation of the raw input, which is + being modified as follows: 'input = input * factor + + offset'. Note that they have to be given as decimal values + (i.e. contain at least one decimal place). + + + + + + + + + + Displays the number of unseen messages in your + global POP3 inbox by default. You can define individual + POP3 inboxes separately by passing arguments to this + object. Arguments are: "host user pass [-i interval (in + seconds)] [-p port] [-e 'command'] [-r retries]". Default + port is 110, default interval is 5 minutes, and default + number of retries before giving up is 5. If the password is + supplied as '*', you will be prompted to enter the password + when Conky starts. + + + + + + + + + + Displays the amount of space (in MiB, 2^20) used + in your global POP3 inbox by default. You can define + individual POP3 inboxes separately by passing arguments to + this object. Arguments are: "host user pass [-i interval + (in seconds)] [-p port] [-e 'command'] [-r retries]". Default + port is 110, default interval is 5 minutes, and default + number of retries before giving up is 5. If the password is + supplied as '*', you will be prompted to enter the password + when Conky starts. + + + + + + + + + + Executes a shell command one time before conky + displays anything and puts output as text. + + + + + + + + + Total processes (sleeping and running) + + + + + + + + + + Connects to a tcp port on a host (default is + localhost), reads every char available at the moment and + shows them. + + + + + + + + + + + Number of mails marked as replied in the + specified mailbox or mail spool if not. Only maildir type + mailboxes are supported, mbox type will return -1. + + + + + + + + + + + Download and parse RSS feeds. The interval may be + a floating point value greater than 0, otherwise + defaults to 15 minutes. Action may be one of the + following: feed_title, item_title (with num par), + item_desc (with num par) and item_titles (when using + this action and spaces_in_front is given conky places + that many spaces in front of each item). This object is + threaded, and once a thread is created it can't be + explicitly destroyed. One thread will run for each URI + specified. You can use any protocol that Curl + supports. + + + + + + + + + Running processes (not sleeping), requires Linux + 2.6 + + + + + + + + + Number of running (runnable) threads. Linux only. + + + + + + + + + + Scroll 'text' by 'step' characters showing + 'length' number of characters at the same time. The text + may also contain variables. 'step' is optional and defaults + to 1 if not set. If a var creates output on multiple lines + then the lines are placed behind each other separated with + a '|'-sign. If you change the textcolor inside $scroll it + will automatically have it's old value back at the end of + $scroll. The end and the start of text will be separated by + 'length' number of spaces. + + + + + + + + + + + Number of mails marked as seen in the specified + mailbox or mail spool if not. Only maildir type mailboxes + are supported, mbox type will return -1. + + + + + + + + + + Change shading color + + + + + + + + + + when using smapi, display contents of the + /sys/devices/platform/smapi directory. ARGS are either + '(FILENAME)' or 'bat (INDEX) (FILENAME)' to display the + corresponding files' content. This is a very raw method of + accessing the smapi values. When available, better use one + of the smapi_* variables instead. + + + + + + + + + + when using smapi, display the remaining capacity + of the battery with index INDEX as a bar. + + + + + + + + + + when using smapi, display the remaining capacity + in percent of the battery with index INDEX. This is a + separate variable because it supports the 'use_spacer' + configuration option. + + + + + + + + + + when using smapi, display the current power of + the battery with index INDEX in watt. This is a separate + variable because the original read out value is being + converted from mW. The sign of the output reflects charging + (positive) or discharging (negative) state. + + + + + + + + + + when using smapi, display the current temperature + of the battery with index INDEX in degree Celsius. This is + a separate variable because the original read out value is + being converted from milli degree Celsius. + + + + + + + + + Displays the Sony VAIO fanspeed information if + sony-laptop kernel support is enabled. Linux only. + + + + + + + + + + Stippled (dashed) horizontal line + + + + + + + + + Amount of swap in use + + + + + + + + + + Bar that shows amount of swap in use + + + + + + + + + Amount of free swap + + + + + + + + + Total amount of swap + + + + + + + + + Percentage of swap in use + + + + + + + + + System name, Linux for example + + + + + + + + + + Puts a tab of the specified width, starting from + column 'start'. The unit is pixels for both arguments. + + + + + + + + + + Displays last N lines of supplied text file. The + file is checked every 'next_check' update. If next_check is + not supplied, Conky defaults to 2. Max of 30 lines can be + displayed, or until the text buffer is filled. + + + + + + + + + + + TCP port (both IPv6 and IPv4) monitor for + specified local ports. Port numbers must be in + the range 1 to 65535. Valid items are: + + + count + + + + rip + + + + rhost + + + + rport + + + + rservice + + + + lip + + + + lhost + + + + lport + + + + lservice + + + + The connection index provides you with access to + each connection in the port monitor. The monitor will + return information for index values from 0 to n-1 + connections. Values higher than n-1 are simply ignored. + For the "count" item, the connection index must be + omitted. It is required for all other items. + Examples: + + + ${tcp_portmon 6881 6999 + count} + + + + ${tcp_portmon 22 22 rip 0} + + + + ${tcp_portmon 22 22 rip 9} + + + + ${tcp_portmon 1 1024 rhost + 0} + + + + ${tcp_portmon 1 1024 rport + 4} + + + + ${tcp_portmon 1 65535 lservice + 14} + + + + Note that port monitor variables which share the + same port range actually refer to the same monitor, so + many references to a single port range for different + items and different indexes all use the same monitor + internally. In other words, the program avoids creating + redundant monitors. + + + + + + + + + + + + + Evaluate the content of the templateN + configuration variable (where N is a value between 0 + and 9, inclusively), applying substitutions as + described in the documentation of the corresponding + configuration variable. The number of arguments is + optional, but must match the highest referred index in + the template. You can use the same special sequences in + each argument as the ones valid for a template + definition, e.g. to allow an argument to contain a + whitespace. Also simple nesting of templates is + possible this way. + Here are some examples of template + definitions: + + template0 $\1\2 + template1 \1: ${fs_used \2} / ${fs_size + \2} + template2 \1 \2 + + The following list shows sample usage of the + templates defined above, with the equivalent syntax + when not using any template at all: + + + + + using template + same without template + + + + + ${template0 node name} + $nodename + + + ${template1 root /} + root: ${fs_free /} / ${fs_size + /} + + + + ${template1 + ${template2\ disk\ root} + /} + + + disk root: + ${fs_free /} / ${fs_size + /} + + + + +
+ + + + + + + + + + Runs a command at an interval inside a thread and + displays the output. Same as $execi, except the command is + run inside a thread. Use this if you have a slow script to + keep Conky updating. You should make the interval slightly + longer then the time it takes your script to execute. For + example, if you have a script that take 5 seconds to + execute, you should make the interval at least 6 seconds. + See also $execi. This object will clean up the thread when + it is destroyed, so it can safely be used in a nested + fashion, though it may not produce the desired behaviour if + used this way. + + + + + + + + + Total threads + + + + + + + + + + Local time, see man strftime to get more + information about format + + + + + + + + + + If 'size' is a number followed by a size-unit + (kilobyte,mb,GiB,...) then it converts the size to bytes + and shows it without unit, otherwise it just shows 'size'. + + + + + + + + + + This takes arguments in the form:top (name) + (number) Basically, processes are ranked from highest to + lowest in terms of cpu usage, which is what (num) + represents. The types are: "name", "pid", "cpu", "mem", + "mem_res", "mem_vsize", "time", "io_perc", "io_read" and + "io_write". There can be a max of 10 processes listed. + + + + + + + + + + Same as top, except sorted by the amount of I/O + the process has done during the update interval + + + + + + + + + + Same as top, except sorted by mem usage instead + of cpu + + + + + + + + + + Same as top, except sorted by total CPU time + instead of current CPU usage + + + + + + + + + + Total download, overflows at 4 GB on Linux with + 32-bit arch and there doesn't seem to be a way to know how + many times it has already done that before conky has + started. + + + + + + + + + + Total upload, this one too, may overflow + + + + + + + + + + + Number of mails marked as trashed in the + specified mailbox or mail spool if not. Only maildir type + mailboxes are supported, mbox type will return -1. + + + + + + + + + + Local time for specified timezone, see man + strftime to get more information about format. The timezone + argument is specified in similar fashion as TZ environment + variable. For hints, look in /usr/share/zoneinfo. e.g. + US/Pacific, Europe/Zurich, etc. + + + + + + + + + + Name of group with this gid + + + + + + + + + + Username of user with this uid + + + + + + + + + + + Number of mails not marked as flagged in the + specified mailbox or mail spool if not. Only maildir type + mailboxes are supported, mbox type will return -1. + + + + + + + + + + + Number of mails not marked as forwarded in the + specified mailbox or mail spool if not. Only maildir type + mailboxes are supported, mbox type will return -1. + + + + + + + + + + + Number of mails not marked as replied in the + specified mailbox or mail spool if not. Only maildir type + mailboxes are supported, mbox type will return -1. + + + + + + + + + + + Number of new or unseen mails in the specified + mailbox or mail spool if not. Only maildir type mailboxes + are supported, mbox type will return -1. + + + + + + + + + + for debugging + + + + + + + + + + Upload speed in suitable IEC units + + + + + + + + + + Upload speed in KiB with one decimal + + + + + + + + + + Upload speed graph, colours defined in hex, minus + the #. If scale is non-zero, it becomes the scale for the + graph. Uses a logarithmic scale (to see small numbers) when + you use the -l switch. Takes the switch '-t' to use a + temperature gradient, which makes the gradient values + change depending on the amplitude of a particular graph + value (try it and see). + + + + + + + + + Uptime + + + + + + + + + Uptime in a shorter format + + + + + + + + + Lists the names of the users logged in + + + + + + + + + Number of users logged in + + + + + + + + + Lists the consoles in use + + + + + + + + + Lists how long users have been logged in for + + + + + + + + + + Lists how long the user for the given console has been + logged in for + + + + + + + + + + Display time in UTC (universal coordinate time). + + + + + + + + + + Change vertical offset by N pixels. Negative + values will cause text to overlap. See also $offset. + + + + + + + + + + Returns CPU #n's voltage in mV. CPUs are counted + from 1. If omitted, the parameter defaults to 1. + + + + + + + + + + Returns CPU #n's voltage in V. CPUs are counted + from 1. If omitted, the parameter defaults to 1. + + + + + + + + + + + Download, parse and display METAR data. + For the 'URI', there are two + possibilities: + + + http://weather.noaa.gov/pub/data/observations/metar/stations/ + + http://xoap.weather.com/weather/local/ + + The first one is free to use but the second + requires you to register and obtain your partner ID and + license key. These two must be written, separated by a + space, into a file called .xoaprc which needs to be + placed into your home directory. + 'locID' must be a valid location identifier for + the required uri. For the NOAA site this must be a + valid ICAO (see for instance + https://pilotweb.nas.faa.gov/qryhtml/icao/). For the + weather.com site this must be a valid location ID (see + for instance + http://aspnetresources.com/tools/locid.aspx). + 'data_type' must be one of the following: + + + last_update + The date and time stamp of the data. + The result depends on the URI used. For the + NOAA site it is date (yyyy/mm/dd) and UTC time. + For the weather.com one it is date + ([m]m/[d]d/yy) and Local Time of the + station. + + + temperature + Air temperature (you can use the + 'temperature_unit' config setting to change + units) + + + cloud_cover + The highest cloud cover status + + + pressure + Air pressure in millibar + + + wind_speed + Wind speed in km/h + + + wind_dir + Wind direction + + + wind_dir_DEG + Compass wind direction + + + humidity + Relative humidity in % + + + weather + Any relevant weather event (rain, snow, + etc.). This is not used if you are querying the + weather.com site since this data is aggregated + into the cloud_cover one + + + icon + Weather icon (only for + www.weather.com). Can be used together with the + icon kit provided upon registering to their + service. + + + 'delay_in_minutes' (optional, default 30) cannot + be less than 30 minutes. + This object is threaded, and once a thread is + created it can't be explicitly destroyed. One thread + will run for each URI specified. + Note that these variables are still EXPERIMENTAL + and can be subject to many future changes. + + + + + + + + + + + Download, parse and display weather forecast data + for a given day (daytime only). + For the 'URI', for the time being only + http://xoap.weather.com/weather/local/ is + supported. See 'weather' above for details of usage + 'locID', see 'weather' above. + 'day' is a number from 0 (today) to 4 (3 days + after tomorrow). + 'data_type' must be one of the following: + + + day + - long: - argument consists of only digits. + + date + - string: - argument is enclosed in quotation mark - or the checks for double and long failed - before. + + low + - - Valid operands are: - '>', '<', '>=', '<=', '==', '!='. - - - - - - - - - - If mixer exists, display everything between $if_mixer_mute and the - matching $endif. If no mixer is specified, "Master" is used. - - - - - - - - - - if PROCESS is running, display everything $if_running - and the matching $endif. This uses the ``pidof'' command, so the - -x switch is also supported. - - - - - - - - - - if MOUNTPOINT is mounted, display everything between - $if_mounted and the matching $endif - - - - - - - - - - when using smapi, if the battery with index INDEX is - installed, display everything between - $if_smapi_bat_installed and the matching $endif - - - - - - - - - - if INTERFACE exists and is up, display everything between $if_up and the matching $endif - - - - - - - - - - If it's the UPDATENR-th time that conky updates, - display everything between $if_updatenr and the matching $endif. - The counter resets when the highest UPDATENR is reached. - Example : "{$if_updatenr 1}foo$endif{$if_updatenr 2}bar$endif{$if_updatenr 4}$endif" - shows foo 25% of the time followed by bar 25% of the time followed by nothing the other half of the time. - - - - - - - - - - Displays the number of messages in your global IMAP inbox by default. You can define individual IMAP inboxes seperately by passing arguments to this object. Arguments are: "host user pass [-i interval (in seconds)] [-f folder] [-p port] [-e command] [-r retries]". Default port is 143, default folder is 'INBOX', default interval is 5 minutes, and default number of retries before giving up is 5. If the password is supplied as '*', you will be prompted to enter the password when Conky starts. - - - - - - - - - - Displays the number of unseen messages in your global IMAP inbox by default. You can define individual IMAP inboxes seperately by passing arguments to this object. Arguments are: "host user pass [-i interval (in seconds)] [-f folder] [-p port] [-e command] [-r retries]". Default port is 143, default folder is 'INBOX', default interval is 5 minutes, and default number of retries before giving up is 5. If the password is supplied as '*', you will be prompted to enter the password when Conky starts. - - - - - - - - - - Prints the current ioscheduler used for the given disk name (i.e. e.g. "hda" or "sdb") - - - - - - - - - Kernel version - - - - - - - - - The value of /proc/sys/vm/laptop_mode - - - - - - - - - (1,2,3)> System load average, 1 is for past 1 minute, 2 for past 5 minutes and 3 for past 15 minutes. - - - - - - - - - - Load1 average graph, similar to xload, with optional colours in hex, minus the #. Uses a logarithmic scale (to see small numbers) when you use "log" instead of "normal". - - - - - - - - - - Displays the number of lines in the given file - - - - - - - - - Machine, i686 for example - - - - - - - - - - - Mail count in the specified mailbox or your mail spool if not. - Both mbox and maildir type mailboxes are supported. You can - use a program like fetchmail to get mails from some server - using your favourite protocol. See also new_mails. - - - - - - - - - - - Unread mail count in the specified mailbox or mail spool if - not. Both mbox and maildir type mailboxes are supported. - - - - - - - - - - - Number of mails marked as seen in the specified mailbox or mail spool if - not. Only maildir type mailboxes are supported, mbox type will return -1. - - - - - - - - - - - Number of new or unseen mails in the specified mailbox or mail spool if - not. Only maildir type mailboxes are supported, mbox type will return -1. - - - - - - - - - - - Number of mails marked as flagged in the specified mailbox or mail spool if - not. Only maildir type mailboxes are supported, mbox type will return -1. - - - - - - - - - - - Number of mails not marked as flagged in the specified mailbox or mail spool if - not. Only maildir type mailboxes are supported, mbox type will return -1. - - - - - - - - - - - Number of mails marked as forwarded in the specified mailbox or mail spool if - not. Only maildir type mailboxes are supported, mbox type will return -1. - - - - - - - - - - - Number of mails not marked as forwarded in the specified mailbox or mail spool if - not. Only maildir type mailboxes are supported, mbox type will return -1. - - - - - - - - - - - Number of mails marked as replied in the specified mailbox or mail spool if - not. Only maildir type mailboxes are supported, mbox type will return -1. - - - - - - - - - - - Number of mails not marked as replied in the specified mailbox or mail spool if - not. Only maildir type mailboxes are supported, mbox type will return -1. - - - - - - - - - - - Number of mails marked as draft in the specified mailbox or mail spool if - not. Only maildir type mailboxes are supported, mbox type will return -1. - - - - - - - - - - - Number of mails marked as trashed in the specified mailbox or mail spool if - not. Only maildir type mailboxes are supported, mbox type will return -1. - - - - - - - - - - Print a summary of recent messages in an mbox format mailbox. mbox parameter is the filename of the mailbox (can be encapsulated using '"', ie. ${mboxscan -n 10 "/home/brenden/some box"} - - - - - - - - - Amount of memory in use - - - - - - - - - - Bar that shows amount of memory in use - - - - - - - - - - Gauge that shows amount of memory in use (see cpugauge) - - - - - - - - - - Memory usage graph. Uses a logarithmic scale (to see small numbers) when you use "log" instead of "normal". - - - - - - - - - Amount of free memory including the memory that is very easily freed (buffers/cache) - - - - - - - - - Amount of free memory - - - - - - - - - Total amount of memory - - - - - - - - - Percentage of memory in use - - - - - - - - - - Prints the mixer value as reported by the OS. Default mixer is "vol", but you can specify one of the following optional arguments: "vol", "bass", "treble", "synth", "pcm", "speaker", "line", "mic", "cd", "mix", "pcm2", "rec", "igain", "ogain", "line1", "line2", "line3", "dig1", "dig2", "dig3", "phin", "phout", "video", "radio", "monitor". Refer to the definition of SOUND_DEVICE_NAMES in <linux/soundcard.h> (on Linux), <soundcard.h> (on OpenBSD), or <sys/soundcard.h> to find the exact options available on your system. - - - - - - - - - - Displays mixer value in a bar as reported by the OS. See docs for $mixer for details on arguments. - - - - - - - - - - Prints the right channel mixer value as reported by the OS. See docs for $mixer for details on arguments. - - - - - - - - - - Displays the right channel mixer value in a bar as reported by the OS. See docs for $mixer for details on arguments. - - - - - - - - - - Prints the left channel mixer value as reported by the OS. See docs for $mixer for details on arguments. - - - - - - - - - - Displays the left channel mixer value in a bar as reported by the OS. See docs for $mixer for details on arguments. - - - - - - - - - Current state of MOC; playing, stopped etc. - - - - - - - - - File name of the current MOC song - - - - - - - - - Title of the current MOC song - - - - - - - - - Artist of the current MOC song - - - - - - - - - The current song name being played in MOC. - - - - - - - - - Album of the current MOC song - - - - - - - - - Total length of the current MOC song - - - - - - - - - Time left in the current MOC song - - - - - - - - - Current time of the current MOC song - - - - - - - - - Bitrate in the current MOC song - - - - - - - - - Rate of the current MOC song - - - - - - - - - Number of the monitor on which conky is running - - - - - - - - - Number of monitors - - - - - - - - - Artist in current MPD song must be enabled at compile - - - - - - - - - Album in current MPD song - - - - - - - - - - Bar of mpd's progress - - - - - - - - - Bitrate of current song - - - - - - - - - Playing, stopped, et cetera. - - - - - - - - - - Title of current MPD song - - - - - - - - - MPD's volume - - - - - - - - - Song's elapsed time - - - - - - - - - Song's length - - - - - - - - - Percent of song's progress - - - - - - - - - Random status (On/Off) - - - - - - - - - Repeat status (On/Off) - - - - - - - - - Prints the MPD track field - - - - - - - - - Prints the MPD name field - - - - - - - - - Prints the file name of the current MPD song - - - - - - - - - - Prints the song name in either the form "artist - title" or file name, depending on whats available - - - - - - - - - if mpd is playing or paused, display everything between $if_mpd_playing and the matching $endif - - - - - - - - - - Print a nameserver from /etc/resolv.conf. Index starts at and defaults to 0. - - - - - - - - - Hostname - - - - - - - - - - - - - - - Nvidia graficcard support for the XNVCtrl library. - Each option can be shortened to the least significant part. - Temperatures are printed as float, all other values as integer. - - threshold: - the thresholdtemperature at which the gpu slows down + + hi + - temp: - gives the gpu current temperature + + icon + - ambient: - gives current air temperature near GPU case + + forecast + - gpufreq: - gives the current gpu frequency - - memfreq: - gives the current mem frequency - - imagequality: - which imagequality should be choosen by OpenGL applications - - - - - - - - - - - - - Change outline color - - - - - - - - - - If running on Apple powerbook/ibook, display - information on battery status. The item parameter - specifies, what information to display. Exactly one item - must be specified. Valid items are: - - status: - Display if battery is fully charged, charging, - discharging or absent (running on AC) - - percent: - Display charge of battery in percent, if - charging or discharging. Nothing will be - displayed, if battery is fully charged - or absent. - - time: - Display the time remaining until the battery - will be fully charged or discharged at current - rate. Nothing is displayed, if battery is - absent or if it's present but fully charged - and not discharging. - - - - - - - - - - - - Platform sensor from sysfs (Linux 2.6). Parameter dev may be omitted if you have only one platform device. Platform type is either 'in' or 'vol' meaning voltage; 'fan' meaning fan; 'temp' meaning temperature. Parameter n is number of the sensor. See /sys/bus/platform/devices/ on your local computer. - - - - - - - - - - Displays the number of unseen messages in your global POP3 inbox by default. You can define individual POP3 inboxes seperately by passing arguments to this object. Arguments are: "host user pass [-i interval (in seconds)] [-p port] [-e command] [-r retries]". Default port is 110, default interval is 5 minutes, and default number of retries before giving up is 5. If the password is supplied as '*', you will be prompted to enter the password when Conky starts. - - - - - - - - - - - Displays the amount of space (in MiB, 2^20) used in your global POP3 inbox by default. You can define individual POP3 inboxes seperately by passing arguments to this object. Arguments are: "host user pass [-i interval (in seconds)] [-p port] [-e command] [-r retries]". Default port is 110, default interval is 5 minutes, and default number of retries before giving up is 5. If the password is supplied as '*', you will be prompted to enter the password when Conky starts. - - - - - - - - - - - Executes a shell command one time before conky displays anything and puts output as text. - - - - - - - - - Total processes (sleeping and running) - - - - - - - - - Running processes (not sleeping), requires Linux 2.6 - - - - - - - - - - Scroll 'text' by 'step' characters showing 'length' number of characters at the same time. The text may also contain variables. 'step' is optional and defaults to 1 if not set. If a var creates output on multiple lines then the lines are placed behind each other separated with a '|'-sign. Do NOT use vars that change colors or otherwise affect the design inside a scrolling text. If you want spaces between the start and the end of 'text', place them at the end of 'text' not at the front ("foobar" and " foobar" can both generate "barfoo" but "foobar " will keep the spaces like this "bar foo"). - - - - - - - - - - Change shading color - - - - - - - - - - when using smapi, display contents of the /sys/devices/platform/smapi directory. ARGS are either '(FILENAME)' or 'bat (INDEX) (FILENAME)' to display the corresponding files' content. This is a very raw method of accessing the smapi values. When available, better use one of the smapi_* variables instead. - - - - - - - - - - when using smapi, display the remaining capacity of the battery with index INDEX as a bar. - - - - - - - - - - when using smapi, display the remaining capacity in percent of the battery with index INDEX. This is a separate variable because it supports the 'use_spacer' configuration option. - - - - - - - - - - when using smapi, display the current power of the battery with index INDEX in watt. This is a separate variable because the original read out value is being converted from mW. The sign of the output reflects charging (positive) or discharging (negative) state. - - - - - - - - - - when using smapi, display the current temperature of the battery with index INDEX in degree Celsius. This is a separate variable because the original read out value is being converted from milli degree Celsius. - - - - - - - - - - Stippled (dashed) horizontal line - - - - - - - - - - Bar that shows amount of swap in use - - - - - - - - - Amount of swap in use - - - - - - - - - Total amount of swap - - - - - - - - - Percentage of swap in use - - - - - - - - - System name, Linux for example - - - - - - - - (ip4 only at present) - - - TCP port monitor for specified local ports. Port numbers must be in the range 1 to 65535. Valid items are: - - count - total number of connections in the range - - rip - remote ip address - - rhost - remote host name - - rport - remote port number - - rservice - remote service name from /etc/services - - lip - local ip address - - lhost - local host name - - lport - local port number - - lservice - local service name from /etc/services - - The connection index provides you with access to each connection in the port monitor. The monitor will return information for index values from 0 to n-1 connections. Values higher than n-1 are simply ignored. For the "count" item, the connection index must be omitted. It is required for all other items. - - Examples: - ${tcp_portmon 6881 6999 count} - - displays the number of connections in the bittorrent port range - ${tcp_portmon 22 22 rip 0} - - displays the remote host ip of the first sshd connection - ${tcp_portmon 22 22 rip 9} - - displays the remote host ip of the tenth sshd connection - ${tcp_portmon 1 1024 rhost 0} - - displays the remote host name of the first connection on a privileged port - ${tcp_portmon 1 1024 rport 4} - - displays the remote host port of the fifth connection on a privileged port - ${tcp_portmon 1 65535 lservice 14} - - displays the local service name of the fifteenth connection in the range of all ports - Note that port monitor variables which share the same port range actually refer to the same monitor, so many references to a single port range for different items and different indexes all use the same monitor internally. In other words, the program avoids creating redundant monitors. - - - - - - - - - - Runs a command at an interval inside a thread and displays the output. Same as $execi, except the command is run inside a thread. Use this if you have a slow script to keep Conky updating. You should make the interval slightly longer then the time it takes your script to execute. For example, if you have a script that take 5 seconds to execute, you should make the interval at least 6 seconds. See also $execi. - - - - - - - - - - Move text over by N pixels. See also $voffset. - - - - - - - - - - Download and parse RSS feeds. Action may be one of the following: feed_title, item_title (with num par), item_desc (with num par) and item_titles (when using this action and spaces_in_front is given conky places that many spaces in front of each item). - - - - - - - - - - Puts a tab of the specified width, starting from column 'start'. The unit is pixels for both arguments. - - - - - - - - - - Displays last N lines of supplied text text file. If interval is not supplied, Conky assumes 2x Conky's interval. Max of 30 lines can be displayed, or until the text buffer is filled. - - - - - - - - - - - - Evaluate the content of the templateN configuration variable (where N is a value between 0 and 9, inclusively), - applying substitutions as described in the documentation of the corresponding configuration variable. - The number of arguments is optional, but must match the highest referred index in the template. You can use the - same special sequences in each argument as the ones valid for a template definition, e.g. to allow an argument - to contain a whitespace. Also simple nesting of templates is possible this way. - - - Here are some examples of template definitions: - - template0 $\1\2 - template1 \1: ${fs_used \2} / ${fs_size \2} - template2 \1 \2 - - The following list shows sample usage of the templates defined above, - with the equivalent syntax when not using any template at all: - - - - using templatesame without template - - - ${template0 node name}$nodename - ${template1 root /}root: ${fs_free /} / ${fs_size /} - - ${template1 ${template2\ disk\ root} /} - disk root: ${fs_free /} / ${fs_size /} - - - -
- - - - - - - - - - Local time, see man strftime to get more information about format - - - - - - - - - - Display time in UTC (universal coordinate time). - - - - - - - - - - Local time for specified timezone, see man strftime to get more information about format. The timezone argument is specified in similar fashion as TZ environment variable. For hints, look in /usr/share/zoneinfo. e.g. US/Pacific, Europe/Zurich, etc. - - - - - - - - - - Total download, overflows at 4 GB on Linux with 32-bit arch and there doesn't seem to be a way to know how many times it has already done that before conky has started. - - - - - - - - - - This takes arguments in the form:top (name) (number) Basically, processes are ranked from highest to lowest in terms of cpu usage, which is what (num) represents. The types are: "name", "pid", "cpu", "mem", "mem_res", "mem_vsize", and "time". There can be a max of 10 processes listed. - - - - - - - - - - Same as top, except sorted by mem usage instead of cpu - - - - - - - - - - Same as top, except sorted by total CPU time instead of current CPU usage - - - - - - - - - - Total upload, this one too, may overflow - - - - - - - - - - for debugging - - - - - - - - - - Upload speed in KiB - - - - - - - - - - Upload speed in KiB with one decimal - - - - - - - - - - Upload speed graph, colours defined in hex, minus the #. If scale is non-zero, it becomes the scale for the graph. Uses a logarithmic scale (to see small numbers) when you use "log" instead of "normal". - - - - - - - - - Uptime - - - - - - - - - Uptime in a shorter format - - - - - - - - - Number of users logged in - - - - - - - - - Lists the names of the users logged in - - - - - - - - - Lists the consoles in use - - - - - - - - - Lists how long users have been logged in for - - - - - - - - - - Change vertical offset by N pixels. Negative values will cause text to overlap. See also $offset. - - - - - - - - - - Returns CPU #n's voltage in mV. CPUs are - counted from 1. If omitted, the parameter - defaults to 1. - - - - - - - - - - Returns CPU #n's voltage in V. CPUs are - counted from 1. If omitted, the parameter - defaults to 1. - - - - - - - - - - Wireless access point ESSID (Linux only) - - - - - - - - - - Wireless mode (Managed/Ad-Hoc/Master) (Linux only) - - - - - - - - - - Wireless bitrate (ie 11 Mb/s) (Linux only) - - - - - - - - - - Wireless access point MAC address (Linux only) - - - - - - - - - - Wireless link quality (Linux only) - - - - - - - - - - Wireless link quality maximum value (Linux only) - - - - - - - - - - Wireless link quality in percents (Linux only) - - - - - - - - - - Wireless link quality bar (Linux only) - - - - - - - - - - Displays the number of words in the given file - - - - - - - - - Artist in current XMMS2 song - - - - - - - - - Album in current XMMS2 song - - - - - - - - - Title in current XMMS2 song - - - - - - - - - Genre in current XMMS2 song - - - - - - - - - Comment in current XMMS2 song - - - - - - - - - Full path to current song - - - - - - - - - Track number in current XMMS2 song - - - - - - - - - Bitrate of current song - - - - - - - - - XMMS2 id of current song - - - - - - - - - Duration of current song - - - - - - - - - Song's elapsed time - - - - - - - - - Size of current song - - - - - - - - - Percent of song's progress - - - - - - - - - Returns song's date. - - - - - - - - - Returns the XMMS2 playlist. - - - - - - - - - Number of times a song was played (presumably). - - - - - - - - - XMMS2 status (Playing, Paused, Stopped, or Disconnected) - - - - - - - - - - Bar of XMMS2's progress - - - - - - - - - Prints the song name in either the form "artist - title" or file name, depending on whats available - - - - - - - - - Display everything between $if_xmms2_connected and the matching $endif if xmms2 is running. - - - - - - - - - Displays the Sony VAIO fanspeed information if sony-laptop kernel support is enabled. Linux only. - - - - - - - - - - Fetches your currently training skill from the Eve Online API servers (http://www.eve-online.com/) and displays the skill along with the remaining training time. - - - - - - - - - - Ends an $if block. - - - + + wind_speed + + + + wind_dir + + + + wind_dir_DEG + + + + humidity + + + + precipitation + + + + 'delay_in_minutes' (optional, default 210) cannot + be lower than 210 min. + This object is threaded, and once a thread is + created it can't be explicitly destroyed. One thread + will run for each URI specified. You can use any + protocol that Curl supports. + Note that these variables are still EXPERIMENTAL + and can be subject to many future changes. + + + + + + + + + + Wireless access point MAC address (Linux only) + + + + + + + + + + Wireless bitrate (ie 11 Mb/s) (Linux only) + + + + + + + + + + Wireless access point ESSID (Linux only) + + + + + + + + + + Wireless link quality bar (Linux only) + + + + + + + + + + Wireless link quality (Linux only) + + + + + + + + + + Wireless link quality maximum value (Linux only) + + + + + + + + + + Wireless link quality in percents (Linux only) + + + + + + + + + + Wireless mode (Managed/Ad-Hoc/Master) (Linux + only) + + + + + + + + + + Displays the number of words in the given file + + + + + + + + + Album in current XMMS2 song + + + + + + + + + Artist in current XMMS2 song + + + + + + + + + + Bar of XMMS2's progress + + + + + + + + + Bitrate of current song + + + + + + + + + Comment in current XMMS2 song + + + + + + + + + Returns song's date. + + + + + + + + + Duration of current song + + + + + + + + + Song's elapsed time + + + + + + + + + Genre in current XMMS2 song + + + + + + + + + XMMS2 id of current song + + + + + + + + + Percent of song's progress + + + + + + + + + Returns the XMMS2 playlist. + + + + + + + + + Size of current song + + + + + + + + + Prints the song name in either the form "artist - + title" or file name, depending on whats available + + + + + + + + + XMMS2 status (Playing, Paused, Stopped, or + Disconnected) + + + + + + + + + Number of times a song was played (presumably). + + + + + + + + + Title in current XMMS2 song + + + + + + + + + Track number in current XMMS2 song + + + + + + + + + Full path to current song + +