<para></para></listitem>
</varlistentry>
+<varlistentry>
+ <term>
+ <command><option>bmpx_artist</option></command>
+ </term>
+ <listitem>
+ Artist in current BMPx track
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>bmpx_album</option></command>
+ </term>
+ <listitem>
+ Album in current BMPx track
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>bmpx_title</option></command>
+ </term>
+ <listitem>
+ Title of the current BMPx track
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>bmpx_track</option></command>
+ </term>
+ <listitem>
+ Track number of the current BMPx track
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>bmpx_bitrate</option></command>
+ </term>
+ <listitem>
+ Bitrate of the current BMPx track
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>bmpx_uri</option></command>
+ </term>
+ <listitem>
+ URI of the current BMPx track
+ <para></para></listitem>
+</varlistentry>
+
<varlistentry>
<term>
<command><option>buffers</option></command>
<option>(cpuN)</option>
</term>
<listitem>
- CPU usage in percents. For SMP machines, the CPU number can be provided as an argument. cpu0 is the total usage, and >=cpu1 are individual CPUs. See $cpu for more info on SMP.
+ CPU usage in percents. For SMP machines, the CPU number can be provided as an argument. ${cpu 0} is the total usage, and ${cpu X} (X >= 1) are individual CPUs.
<para></para></listitem>
</varlistentry>
<option>(cpu number) (height),(width)</option>
</term>
<listitem>
- Bar that shows CPU usage, height is bar's height in pixels
+ Bar that shows CPU usage, height is bar's height in pixels. See $cpu for more info on SMP.
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
<command><option>font</option></command>
- <option>font</option>
+ <option>(font)</option>
</term>
<listitem>
- Specify a different font. Only applies to one line.
+ 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)
<para></para></listitem>
</varlistentry>
+<varlistentry>
+ <term>
+ <command><option>freq</option></command>
+ <option>(n)</option>
+ </term>
+ <listitem>
+ Returns CPU #n's frequency in MHz. CPUs are
+ counted from 1. If omitted, the parameter
+ defaults to 1.
+ <para></para></listitem>
+</varlistentry>
+<varlistentry>
+ <term>
+ <command><option>freq_g</option></command>
+ <option>(n)</option>
+ </term>
+ <listitem>
+ Returns CPU #n's frequency in GHz. CPUs are
+ counted from 1. If omitted, the parameter
+ defaults to 1.
+ <para></para></listitem>
+</varlistentry>
- <varlistentry>
- <term>
- <command><option>freq</option></command>
- </term>
- <listitem>
- Returns CPU frequency in MHz
- <para></para></listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <command><option>freq_g</option></command>
- </term>
- <listitem>
- Returns CPU frequency in GHz
- <para></para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <command><option>freq_dyn</option></command>
- </term>
- <listitem>
+<varlistentry>
+ <term>
+ <command><option>freq_dyn</option></command>
+ </term>
+ <listitem>
Returns CPU frequency in MHz, but is calculated by counting to clock cycles to complete an instruction. Only available for x86/amd64.
<para></para></listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <command><option>freq_dyn_g</option></command>
- </term>
- <listitem>
- Returns CPU frequency in GHz, but is calculated by counting to clock cycles to complete an instruction. Only available for x86/amd64.
- <para></para></listitem>
- </varlistentry>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>freq_dyn_g</option></command>
+ </term>
+ <listitem>
+ Returns CPU frequency in GHz, but is calculated by counting to clock cycles to complete an instruction. Only available for x86/amd64.
+ <para></para></listitem>
+</varlistentry>
- <varlistentry>
+<varlistentry>
<term>
<command><option>fs_bar</option></command>
<option>(height),(width) fs</option>
<varlistentry>
<term>
+ <command><option>goto</option></command>
+ <option>x</option>
+ </term>
+ <listitem>
+ The next element will be printed at position 'x'.
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>hddtemp</option></command>
+ <option>dev, (host,(port))</option>
+ </term>
+ <listitem>
+ 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.
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
<command><option>head</option></command>
<option>logfile lines (interval)</option>
</term>
<varlistentry>
<term>
+ <command><option>iconv_start</option></command>
+ <option>codeset_from codeset_to</option>
+ </term>
+ <listitem>
+ Convert text from one codeset to another using GNU iconv. Needs to be stopped with iconv_stop.
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>iconv_stop</option></command>
+ <option></option>
+ </term>
+ <listitem>
+ Stop iconv codeset conversion.
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
<command><option>i2c</option></command>
- <option>(dev), type, n</option>
+ <option>(dev) type n</option>
</term>
<listitem>
I2C sensor from sysfs (Linux 2.6). dev may be omitted if you have only one I2C device. type is either in (or vol) meaning voltage, fan meaning fan or temp/tempf (first in C, second in F) meaning temperature. n is number of the sensor. See /sys/bus/i2c/devices/ on your local computer.
<option></option>
</term>
<listitem>
- 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 cpu temperature in Celsius, as reported by /proc/i8k.
<para></para></listitem>
</varlistentry>
<option></option>
</term>
<listitem>
- If running the i8k kernel driver for Inspiron laptops, displays the cpu temperature in farenheit, as reported by /proc/i8k.
+ If running the i8k kernel driver for Inspiron laptops, displays the cpu temperature in Farenheit, as reported by /proc/i8k.
<para></para></listitem>
</varlistentry>
<para></para></listitem>
</varlistentry>
+<varlistentry>
+ <term>
+ <command><option>ibm_fan</option></command>
+ </term>
+ <listitem>
+ If running the IBM ACPI, displays the fan speed.
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>ibm_temps</option></command>
+ <option>N</option>
+ </term>
+ <listitem>
+ 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.
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>ibm_volume</option></command>
+ </term>
+ <listitem>
+ If running the IBM ACPI, displays the "master" volume,
+ controlled by the volume keys (0-14).
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>ibm_brightness</option></command>
+ </term>
+ <listitem>
+ If running the IBM ACPI, displays the brigtness of the
+ laptops's LCD (0-7).
+ <para></para></listitem>
+</varlistentry>
+
<varlistentry>
<term>
<varlistentry>
<term>
+ <command><option>imap_messages</option></command>
+ <option>(args)</option>
+ </term>
+ <listitem>
+ 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] [-p port] [-e command]". Default port is 110, default interval is 5 minutes. If the password is supplied as '*', you will be prompted to enter the password when Conky starts.
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>imap_unseen</option></command>
+ <option>(args)</option>
+ </term>
+ <listitem>
+ 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] [-p port] [-e command]". Default port is 110, default interval is 5 minutes. If the password is supplied as '*', you will be prompted to enter the password when Conky starts.
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
<command><option>kernel</option></command>
</term>
<listitem>
<varlistentry>
<term>
- <command><option>ml_upload_counter</option></command>
+ <command><option>mpd_artist</option></command>
</term>
<listitem>
- total session upload in mb
+ Artist in current MPD song must be enabled at compile
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>ml_download_counter</option></command>
+ <command><option>mpd_album</option></command>
</term>
<listitem>
- total session download in mb
+ Album in current MPD song
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>ml_nshared_files</option></command>
+ <command><option>mpd_bar</option></command>
+ <option>(height),(width)</option>
</term>
<listitem>
- number of shared files
+ Bar of mpd's progress
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>ml_shared_counter</option></command>
+ <command><option>mpd_bitrate</option></command>
</term>
<listitem>
- total session shared in mb, buggy in some mldonkey versions
+ Bitrate of current song
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>ml_tcp_upload_rate</option></command>
+ <command><option>mpd_status</option></command>
</term>
<listitem>
- tcp upload rate in kb/s
+ Playing, stopped, et cetera.
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>ml_tcp_download_rate</option></command>
+ <command><option>mpd_title</option></command>
</term>
<listitem>
- tcp download rate in kb/s
+ Title of current MPD song
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>ml_udp_upload_rate</option></command>
+ <command><option>mpd_vol</option></command>
</term>
<listitem>
- udp upload rate in kb/s
+ MPD's volume
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>ml_udp_download_rate</option></command>
+ <command><option>mpd_elapsed</option></command>
</term>
<listitem>
- udp download rate in kb/s
+ Song's elapsed time
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>ml_ndownloaded_files</option></command>
+ <command><option>mpd_length</option></command>
</term>
<listitem>
- number of completed files
+ Song's length
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>ml_ndownloading_files</option></command>
+ <command><option>mpd_percent</option></command>
</term>
<listitem>
- number of downloading files
+ Percent of song's progress
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>mpd_artist</option></command>
+ <command><option>mpd_random</option></command>
</term>
<listitem>
- Artist in current MPD song must be enabled at compile
+ Random status (On/Off)
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>mpd_album</option></command>
+ <command><option>mpd_repeat</option></command>
</term>
<listitem>
- Album in current MPD song
+ Repeat status (On/Off)
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>mpd_bar</option></command>
- <option>(height),(width)</option>
+ <command><option>mpd_track</option></command>
</term>
<listitem>
- Bar of mpd's progress
+ Prints the MPD track field
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>mpd_bitrate</option></command>
+ <command><option>mpd_name</option></command>
</term>
<listitem>
- Bitrate of current song
+ Prints the MPD name field
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>mpd_status</option></command>
+ <command><option>mpd_file</option></command>
</term>
<listitem>
- Playing, stopped, et cetera.
+ Prints the file name of the current MPD song
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>mpd_title</option></command>
+ <command><option>mpd_smart</option></command>
</term>
<listitem>
- Title of current MPD song
+ Prints the song name in either the form "artist - title" or file name, depending on whats available
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>mpd_vol</option></command>
+ <command><option>new_mails</option></command>
</term>
<listitem>
- MPD's volume
+ Unread mail count in mail spool.
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>mpd_elapsed</option></command>
+ <command><option>nodename</option></command>
</term>
<listitem>
- Song's elapsed time
+ Hostname
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>mpd_length</option></command>
+ <command><option>outlinecolor</option></command>
+ <option>(color)</option>
</term>
<listitem>
- Song's length
+ Change outline color
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>mpd_percent</option></command>
+ <command><option>pb_battery</option></command>
+ <option>item</option>
</term>
<listitem>
- Percent of song's progress
+ 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:
+ <simplelist>
+ <member><command>status</command>:
+ Display if battery is fully charged, charging,
+ discharging or absent (running on AC)
+ </member>
+ <member><command>percent</command>:
+ Display charge of battery in percent, if
+ charging or discharging. Nothing will be
+ displayed, if battery is fully charged
+ or absent.
+ </member>
+ <member><command>time</command>:
+ 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.
+ </member>
+ </simplelist>
<para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>new_mails</option></command>
+ <command><option>pop3_unseen</option></command>
+ <option>(args)</option>
</term>
<listitem>
- Unread mail count in mail spool.
- <para></para></listitem>
-</varlistentry>
+ 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] [-p port] [-e command]". Default port is 110, default interval is 5 minutes. If the password is supplied as '*', you will be prompted to enter the password when Conky starts.
-<varlistentry>
- <term>
- <command><option>nodename</option></command>
- </term>
- <listitem>
- Hostname
- <para></para></listitem>
+ <para></para></listitem>
</varlistentry>
<varlistentry>
<term>
- <command><option>outlinecolor</option></command>
- <option>(color)</option>
+ <command><option>pop3_used</option></command>
+ <option>(args)</option>
</term>
<listitem>
- Change outline color
- <para></para></listitem>
+ 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] [-p port] [-e command]". Default port is 110, default interval is 5 minutes. If the password is supplied as '*', you will be prompted to enter the password when Conky starts.
+
+ <para></para></listitem>
</varlistentry>
<varlistentry>
<varlistentry>
<term>
+ <command><option>tcp_portmon</option></command>
+ <option>port_begin port_end item (index)</option>
+ <emphasis>(ip4 only at present)</emphasis>
+ </term>
+ <listitem>
+ TCP port monitor for specified local ports. Port numbers must be in the range 1 to 65535. Valid items are:
+ <simplelist>
+ <member><command>count</command> - total number of connections in the range
+ </member>
+ <member><command>rip</command> - remote ip address
+ </member>
+ <member><command>rhost</command> - remote host name
+ </member>
+ <member><command>rport</command> - remote port number
+ </member>
+ <member><command>rservice</command> - remote service name from /etc/services
+ </member>
+ <member><command>lip</command> - local ip address
+ </member>
+ <member><command>lhost</command> - local host name
+ </member>
+ <member><command>lport</command> - local port number
+ </member>
+ <member><command>lservice</command> - local service name from /etc/services
+ </member>
+ </simplelist>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.
+ <simplelist>
+ <member>Examples:</member>
+ <member><command>${tcp_portmon 6881 6999 count}</command> -
+ displays the number of connections in the bittorrent port range</member>
+ <member><command>${tcp_portmon 22 22 rip 0}</command> -
+ displays the remote host ip of the first sshd connection</member>
+ <member><command>${tcp_portmon 22 22 rip 9}</command> -
+ displays the remote host ip of the tenth sshd connection</member>
+ <member><command>${tcp_portmon 1 1024 rhost 0}</command> -
+ displays the remote host name of the first connection on a privileged port</member>
+ <member><command>${tcp_portmon 1 1024 rport 4}</command> -
+ displays the remote host port of the fifth connection on a privileged port</member>
+ <member><command>${tcp_portmon 1 65535 lservice 14}</command> -
+ displays the local service name of the fifteenth connection in the range of all ports</member>
+ </simplelist>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.
+ </listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
<command><option>texeci</option></command>
<option>interval command</option>
</term>
<varlistentry>
<term>
+ <command><option>tab</option></command>
+ <option>(width, (start))</option>
+ </term>
+ <listitem>
+ Puts a tab of the specified width, starting from column 'start'.
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
<command><option>tail</option></command>
<option>logfile lines (interval)</option>
</term>
<varlistentry>
<term>
+ <command><option>utime</option></command>
+ <option>(format)</option>
+ </term>
+ <listitem>
+ Display time in UTC (universal coordinate time).
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>tztime</option></command>
+ <option>(timezone) (format)</option>
+ </term>
+ <listitem>
+ 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.
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
<command><option>totaldown</option></command>
<option>net</option>
</term>
<option>type, num</option>
</term>
<listitem>
- 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", and mem". There can be a max of 10 processes listed.
+ 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", and "mem". There can be a max of 10 processes listed.
<para></para></listitem>
</varlistentry>
Seti@home total user credit
<para></para></listitem>
</varlistentry>
+
<varlistentry>
<term>
<command><option>voffset</option></command>
<option>(pixels)</option>
</term>
<listitem>
- Change verticle offset by N pixels. Negative values will cause text to overlap. See also $offset.
+ Change vertical offset by N pixels. Negative values will cause text to overlap. See also $offset.
<para></para></listitem>
</varlistentry>
+<varlistentry>
+ <term>
+ <command><option>voltage_mv</option></command>
+ <option>(n)</option>
+ </term>
+ <listitem>
+ Returns CPU #n's voltage in mV. CPUs are
+ counted from 1. If omitted, the parameter
+ defaults to 1.
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>voltage_v</option></command>
+ <option>(n)</option>
+ </term>
+ <listitem>
+ Returns CPU #n's voltage in V. CPUs are
+ counted from 1. If omitted, the parameter
+ defaults to 1.
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>xmms_bar</option></command>
+ <option>(height),(width)</option>
+ </term>
+ <listitem>
+ xmms / bmp / audacious / infopipe: progress bar
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>xmms_bitrate</option></command>
+ </term>
+ <listitem>
+ xmms / bmp / audacious / infopipe: bitrate of current tune
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>xmms_channels</option></command>
+ </term>
+ <listitem>
+ xmms / bmp / audacious / infopipe: number of audio channels of current tune
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>xmms_filename</option></command>
+ </term>
+ <listitem>
+ xmms / bmp / audacious / infopipe: full path and filename of current tune
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>xmms_frequency</option></command>
+ </term>
+ <listitem>
+ xmms / bmp / audacious / infopipe: sampling frequency of current tune
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>xmms_length</option></command>
+ </term>
+ <listitem>
+ xmms / bmp / audacious / infopipe: total length of current tune as MM:SS
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>xmms_length_seconds</option></command>
+ </term>
+ <listitem>
+ xmms / bmp / audacious / infopipe: total length of current tune in seconds
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>xmms_playlist_position</option></command>
+ </term>
+ <listitem>
+ xmms / bmp / audacious / infopipe: playlist position of current tune
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>xmms_playlist_length</option></command>
+ </term>
+ <listitem>
+ xmms / bmp / audacious / infopipe: number of tunes in playlist
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>xmms_position</option></command>
+ </term>
+ <listitem>
+ xmms / bmp / audacious / infopipe: MM:SS position of current tune
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>xmms_position_seconds</option></command>
+ </term>
+ <listitem>
+ xmms / bmp / audacious / infopipe: position of current tune in seconds
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>xmms_status</option></command>
+ </term>
+ <listitem>
+ xmms / bmp / audacious / infopipe: player status (Playing/Paused/Stopped/Not running)
+ <para></para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>
+ <command><option>xmms_title</option></command>
+ </term>
+ <listitem>
+ xmms / bmp / audacious / infopipe: title of current tune
+ <para></para></listitem>
+</varlistentry>
</variablelist>