mirror of
https://github.com/Llewellynvdm/conky.git
synced 2024-11-17 18:45:10 +00:00
bump version; doc fixes
git-svn-id: https://conky.svn.sourceforge.net/svnroot/conky/trunk/conky1@1094 7f574dfc-610e-0410-a909-a81674777703
This commit is contained in:
Brenden Matthews
parent
e6ad00d26c
commit
798207efbf
379
README
379
README
@ -76,12 +76,13 @@ OPTIONS
|
|||||||
Command line options override configurations defined in configuration
|
Command line options override configurations defined in configuration
|
||||||
file.
|
file.
|
||||||
|
|
||||||
-v | -V | --verbose
|
-v | -V | --version
|
||||||
Prints version and exits
|
Prints version and exits
|
||||||
|
|
||||||
|
|
||||||
-a | --alignment=ALIGNMENT
|
-a | --alignment=ALIGNMENT
|
||||||
Text alignment on screen, {top,bottom}_{left,right} or none
|
Text alignment on screen, {top,bottom,middle}_{left,right,mid-
|
||||||
|
dle} or none
|
||||||
|
|
||||||
|
|
||||||
-b | --double-buffer
|
-b | --double-buffer
|
||||||
@ -128,23 +129,27 @@ OPTIONS
|
|||||||
Y position
|
Y position
|
||||||
|
|
||||||
|
|
||||||
CONFIGURATION SETTINGS
|
-i COUNT
|
||||||
Default configuration file location is $HOME/.conkyrc or
|
Number of times to update Conky (and quit)
|
||||||
${sysconfdir}/conky/conky.conf. On most systems, sysconfdir is /etc,
|
|
||||||
and you can find the sample config file there (/etc/conky/conky.conf).
|
|
||||||
|
|
||||||
You might want to copy it to $HOME/.conkyrc and then start modifying
|
|
||||||
|
CONFIGURATION SETTINGS
|
||||||
|
Default configuration file location is $HOME/.conkyrc or
|
||||||
|
${sysconfdir}/conky/conky.conf. On most systems, sysconfdir is /etc,
|
||||||
|
and you can find the sample config file there (/etc/conky/conky.conf).
|
||||||
|
|
||||||
|
You might want to copy it to $HOME/.conkyrc and then start modifying
|
||||||
it. Other configs can be found at http://conky.sf.net/
|
it. Other configs can be found at http://conky.sf.net/
|
||||||
|
|
||||||
alignment
|
alignment
|
||||||
Aligned position on screen, may be top_left, top_right, top_mid-
|
Aligned position on screen, may be top_left, top_right, top_mid-
|
||||||
dle, bottom_left, bottom_right, bottom_middle, middle_left, mid-
|
dle, bottom_left, bottom_right, bottom_middle, middle_left, mid-
|
||||||
dle_right, or none (also can be abreviated as tl, tr, tm, bl,
|
dle_right, or none (also can be abreviated as tl, tr, tm, bl,
|
||||||
br, bm, ml, mr)
|
br, bm, ml, mr)
|
||||||
|
|
||||||
|
|
||||||
background
|
background
|
||||||
Boolean value, if true, Conky will be forked to background when
|
Boolean value, if true, Conky will be forked to background when
|
||||||
started
|
started
|
||||||
|
|
||||||
|
|
||||||
@ -192,7 +197,7 @@ CONFIGURATION SETTINGS
|
|||||||
|
|
||||||
top_cpu_separate
|
top_cpu_separate
|
||||||
If true, cpu in top will show usage of one processor's power. If
|
If true, cpu in top will show usage of one processor's power. If
|
||||||
false, cpu in top will show the usage of all processors' power
|
false, cpu in top will show the usage of all processors' power
|
||||||
combined.
|
combined.
|
||||||
|
|
||||||
|
|
||||||
@ -233,18 +238,18 @@ CONFIGURATION SETTINGS
|
|||||||
font Font name in X, xfontsel can be used to get a nice font
|
font Font name in X, xfontsel can be used to get a nice font
|
||||||
|
|
||||||
|
|
||||||
gap_x Gap, in pixels, between right or left border of screen, same as
|
gap_x Gap, in pixels, between right or left border of screen, same as
|
||||||
passing -x at command line, e.g. gap_x 10
|
passing -x at command line, e.g. gap_x 10
|
||||||
|
|
||||||
|
|
||||||
gap_y Gap, in pixels, between top or bottom border of screen, same as
|
gap_y Gap, in pixels, between top or bottom border of screen, same as
|
||||||
passing -y at command line, e.g. gap_y 10.
|
passing -y at command line, e.g. gap_y 10.
|
||||||
|
|
||||||
|
|
||||||
imap Default global IMAP server. Arguments are: "host user pass [-i
|
imap Default global IMAP server. Arguments are: "host user pass [-i
|
||||||
interval] [-f folder] [-p port] [-e command]". Default port is
|
interval] [-f folder] [-p port] [-e command]". Default port is
|
||||||
143, default folder is 'INBOX', default interval is 5 minutes.
|
143, default folder is 'INBOX', default interval is 5 minutes.
|
||||||
If the password is supplied as '*', you will be prompted to en-
|
If the password is supplied as '*', you will be prompted to en-
|
||||||
ter the password when Conky starts.
|
ter the password when Conky starts.
|
||||||
|
|
||||||
|
|
||||||
@ -253,12 +258,12 @@ CONFIGURATION SETTINGS
|
|||||||
|
|
||||||
|
|
||||||
max_port_monitor_connections
|
max_port_monitor_connections
|
||||||
Allow each port monitor to track at most this many connections
|
Allow each port monitor to track at most this many connections
|
||||||
(if 0 or not set, default is 256)
|
(if 0 or not set, default is 256)
|
||||||
|
|
||||||
|
|
||||||
max_specials
|
max_specials
|
||||||
Maximum number of special things, e.g. fonts, offsets, aligns,
|
Maximum number of special things, e.g. fonts, offsets, aligns,
|
||||||
etc. (default is 512)
|
etc. (default is 512)
|
||||||
|
|
||||||
|
|
||||||
@ -268,12 +273,12 @@ CONFIGURATION SETTINGS
|
|||||||
|
|
||||||
|
|
||||||
text_buffer_size bytes
|
text_buffer_size bytes
|
||||||
Size of the standard text buffer (default is 128 bytes). This
|
Size of the standard text buffer (default is 128 bytes). This
|
||||||
buffer is used for intermediary text, such as individual lines,
|
buffer is used for intermediary text, such as individual lines,
|
||||||
output from $exec vars, and various other variables. Increasing
|
output from $exec vars, and various other variables. Increasing
|
||||||
the size of this buffer can drastically reduce Conky's perfor-
|
the size of this buffer can drastically reduce Conky's perfor-
|
||||||
mance, but will allow for more text display per variable. The
|
mance, but will allow for more text display per variable. The
|
||||||
size of this buffer cannot be smaller than the default value of
|
size of this buffer cannot be smaller than the default value of
|
||||||
128 bytes.
|
128 bytes.
|
||||||
|
|
||||||
|
|
||||||
@ -298,7 +303,7 @@ CONFIGURATION SETTINGS
|
|||||||
|
|
||||||
|
|
||||||
music_player_interval
|
music_player_interval
|
||||||
Music player thread update interval (defaults to Conky's update
|
Music player thread update interval (defaults to Conky's update
|
||||||
interval)
|
interval)
|
||||||
|
|
||||||
|
|
||||||
@ -323,21 +328,21 @@ CONFIGURATION SETTINGS
|
|||||||
|
|
||||||
|
|
||||||
own_window_colour colour
|
own_window_colour colour
|
||||||
If own_window_transparent no, set a specified background colour
|
If own_window_transparent no, set a specified background colour
|
||||||
(defaults to black). Takes either a hex value (#ffffff) or a
|
(defaults to black). Takes either a hex value (#ffffff) or a
|
||||||
valid RGB name (see /usr/lib/X11/rgb.txt)
|
valid RGB name (see /usr/lib/X11/rgb.txt)
|
||||||
|
|
||||||
|
|
||||||
own_window_hints undecorated,below,above,sticky,skip_taskbar,skip_pager
|
own_window_hints undecorated,below,above,sticky,skip_taskbar,skip_pager
|
||||||
If own_window is yes, you may use these window manager hints to
|
If own_window is yes, you may use these window manager hints to
|
||||||
affect the way Conky displays. Notes: Use own_window_type desk-
|
affect the way Conky displays. Notes: Use own_window_type desk-
|
||||||
top as another way to implement many of these hints implicitly.
|
top as another way to implement many of these hints implicitly.
|
||||||
If you use own_window_type override, window manager hints have
|
If you use own_window_type override, window manager hints have
|
||||||
no meaning and are ignored.
|
no meaning and are ignored.
|
||||||
|
|
||||||
|
|
||||||
own_window_title
|
own_window_title
|
||||||
Manually set the window name. Defaults to "<hostname> - conky".
|
Manually set the window name. Defaults to "<hostname> - conky".
|
||||||
|
|
||||||
|
|
||||||
own_window_transparent
|
own_window_transparent
|
||||||
@ -345,11 +350,11 @@ CONFIGURATION SETTINGS
|
|||||||
|
|
||||||
|
|
||||||
own_window_type
|
own_window_type
|
||||||
if own_window is yes, you may specify type normal, desktop or
|
if own_window is yes, you may specify type normal, desktop or
|
||||||
override (default: normal). Desktop windows are special windows
|
override (default: normal). Desktop windows are special windows
|
||||||
that have no window decorations; are always visible on your
|
that have no window decorations; are always visible on your
|
||||||
desktop; do not appear in your pager or taskbar; and are sticky
|
desktop; do not appear in your pager or taskbar; and are sticky
|
||||||
across all workspaces. Override windows are not under the con-
|
across all workspaces. Override windows are not under the con-
|
||||||
trol of the window manager. Hints are ignored. This type of win-
|
trol of the window manager. Hints are ignored. This type of win-
|
||||||
dow can be useful for certain situations.
|
dow can be useful for certain situations.
|
||||||
|
|
||||||
@ -362,9 +367,9 @@ CONFIGURATION SETTINGS
|
|||||||
Pad percentages to this many decimals (0 = no padding)
|
Pad percentages to this many decimals (0 = no padding)
|
||||||
|
|
||||||
|
|
||||||
pop3 Default global POP3 server. Arguments are: "host user pass [-i
|
pop3 Default global POP3 server. Arguments are: "host user pass [-i
|
||||||
interval] [-p port] [-e command]". Default port is 110, default
|
interval] [-p port] [-e command]". Default port is 110, default
|
||||||
interval is 5 minutes. If the password is supplied as '*', you
|
interval is 5 minutes. If the password is supplied as '*', you
|
||||||
will be prompted to enter the password when Conky starts.
|
will be prompted to enter the password when Conky starts.
|
||||||
|
|
||||||
|
|
||||||
@ -378,7 +383,7 @@ CONFIGURATION SETTINGS
|
|||||||
|
|
||||||
|
|
||||||
total_run_times
|
total_run_times
|
||||||
Total number of times for Conky to update before quitting. Zero
|
Total number of times for Conky to update before quitting. Zero
|
||||||
makes Conky run forever
|
makes Conky run forever
|
||||||
|
|
||||||
|
|
||||||
@ -393,8 +398,8 @@ CONFIGURATION SETTINGS
|
|||||||
use_spacer
|
use_spacer
|
||||||
Adds spaces around certain objects to stop them from moving oth-
|
Adds spaces around certain objects to stop them from moving oth-
|
||||||
er things around. Arguments are left, right, and none (default).
|
er things around. Arguments are left, right, and none (default).
|
||||||
The old true/false values are deprecated and default to
|
The old true/false values are deprecated and default to
|
||||||
right/none respectively. Note that this only helps if you are
|
right/none respectively. Note that this only helps if you are
|
||||||
using a mono font, such as Bitstream Vera Sans Mono.
|
using a mono font, such as Bitstream Vera Sans Mono.
|
||||||
|
|
||||||
|
|
||||||
@ -414,8 +419,8 @@ CONFIGURATION SETTINGS
|
|||||||
|
|
||||||
|
|
||||||
VARIABLES
|
VARIABLES
|
||||||
Colors are parsed using XParsecolor(), there might be a list of them:
|
Colors are parsed using XParsecolor(), there might be a list of them:
|
||||||
/usr/share/X11/rgb.txt. Also, <http://sedition.com/perl/rgb.html>.
|
/usr/share/X11/rgb.txt. Also, <http://sedition.com/perl/rgb.html>.
|
||||||
Color can be also in #rrggbb format (hex).
|
Color can be also in #rrggbb format (hex).
|
||||||
|
|
||||||
addr interface
|
addr interface
|
||||||
@ -423,7 +428,7 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
addrs interface
|
addrs interface
|
||||||
IP addresses for an interface (if one - works like addr). Linux
|
IP addresses for an interface (if one - works like addr). Linux
|
||||||
only.
|
only.
|
||||||
|
|
||||||
|
|
||||||
@ -468,7 +473,7 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
apm_battery_time
|
apm_battery_time
|
||||||
Display remaining APM battery life in hh:mm:ss or "unknown" if
|
Display remaining APM battery life in hh:mm:ss or "unknown" if
|
||||||
AC adapterstatus is on-line or charging (FreeBSD only)
|
AC adapterstatus is on-line or charging (FreeBSD only)
|
||||||
|
|
||||||
|
|
||||||
@ -525,8 +530,8 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
battery (num)
|
battery (num)
|
||||||
Battery status and remaining percentage capacity of ACPI or APM
|
Battery status and remaining percentage capacity of ACPI or APM
|
||||||
battery. ACPI battery number can be given as argument (default
|
battery. ACPI battery number can be given as argument (default
|
||||||
is BAT0).
|
is BAT0).
|
||||||
|
|
||||||
|
|
||||||
@ -541,7 +546,7 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
battery_time (num)
|
battery_time (num)
|
||||||
Battery charge/discharge time remaining of ACPI battery. ACPI
|
Battery charge/discharge time remaining of ACPI battery. ACPI
|
||||||
battery number can be given as argument (default is BAT0).
|
battery number can be given as argument (default is BAT0).
|
||||||
|
|
||||||
|
|
||||||
@ -623,19 +628,19 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
cpu (cpuN)
|
cpu (cpuN)
|
||||||
CPU usage in percents. For SMP machines, the CPU number can be
|
CPU usage in percents. For SMP machines, the CPU number can be
|
||||||
provided as an argument. ${cpu cpu0} is the total usage, and
|
provided as an argument. ${cpu cpu0} is the total usage, and
|
||||||
${cpu cpuX} (X >= 1) are individual CPUs.
|
${cpu cpuX} (X >= 1) are individual CPUs.
|
||||||
|
|
||||||
|
|
||||||
cpubar (cpu number) (height),(width)
|
cpubar (cpu number) (height),(width)
|
||||||
Bar that shows CPU usage, height is bar's height in pixels. See
|
Bar that shows CPU usage, height is bar's height in pixels. See
|
||||||
$cpu for more info on SMP.
|
$cpu for more info on SMP.
|
||||||
|
|
||||||
|
|
||||||
cpugraph (cpu number) (height),(width) (gradient colour 1) (gradient
|
cpugraph (cpu number) (height),(width) (gradient colour 1) (gradient
|
||||||
colour 2)
|
colour 2)
|
||||||
CPU usage graph, with optional colours in hex, minus the #. See
|
CPU usage graph, with optional colours in hex, minus the #. See
|
||||||
$cpu for more info on SMP.
|
$cpu for more info on SMP.
|
||||||
|
|
||||||
|
|
||||||
@ -644,9 +649,9 @@ VARIABLES
|
|||||||
of sda for /dev/sda. Individual partitions are allowed.
|
of sda for /dev/sda. Individual partitions are allowed.
|
||||||
|
|
||||||
|
|
||||||
diskiograph (device) (height),(width) (gradient colour 1) (gradient
|
diskiograph (device) (height),(width) (gradient colour 1) (gradient
|
||||||
colour 2) (scale)
|
colour 2) (scale)
|
||||||
Disk IO graph, colours defined in hex, minus the #. If scale is
|
Disk IO graph, colours defined in hex, minus the #. If scale is
|
||||||
non-zero, it becomes the scale for the graph.
|
non-zero, it becomes the scale for the graph.
|
||||||
|
|
||||||
|
|
||||||
@ -654,7 +659,7 @@ VARIABLES
|
|||||||
Displays current disk IO for reads. Device as in diskio.
|
Displays current disk IO for reads. Device as in diskio.
|
||||||
|
|
||||||
|
|
||||||
diskiograph_read (device) (height),(width) (gradient colour 1) (gradi-
|
diskiograph_read (device) (height),(width) (gradient colour 1) (gradi-
|
||||||
ent colour 2) (scale)
|
ent colour 2) (scale)
|
||||||
Disk IO graph for reads, colours defined in hex, minus the #. If
|
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
|
scale is non-zero, it becomes the scale for the graph. Device as
|
||||||
@ -667,7 +672,7 @@ VARIABLES
|
|||||||
|
|
||||||
diskiograph_write (device) (height),(width) (gradient colour 1) (gradi-
|
diskiograph_write (device) (height),(width) (gradient colour 1) (gradi-
|
||||||
ent colour 2) (scale)
|
ent colour 2) (scale)
|
||||||
Disk IO graph for writes, colours defined in hex, minus the #.
|
Disk IO graph for writes, colours defined in hex, minus the #.
|
||||||
If scale is non-zero, it becomes the scale for the graph. Device
|
If scale is non-zero, it becomes the scale for the graph. Device
|
||||||
as in diskio.
|
as in diskio.
|
||||||
|
|
||||||
@ -687,7 +692,7 @@ VARIABLES
|
|||||||
|
|
||||||
downspeedgraph net (height),(width) (gradient colour 1) (gradient
|
downspeedgraph net (height),(width) (gradient colour 1) (gradient
|
||||||
colour 2) (scale)
|
colour 2) (scale)
|
||||||
Download speed graph, colours defined in hex, minus the #. If
|
Download speed graph, colours defined in hex, minus the #. If
|
||||||
scale is non-zero, it becomes the scale for the graph.
|
scale is non-zero, it becomes the scale for the graph.
|
||||||
|
|
||||||
|
|
||||||
@ -708,12 +713,12 @@ VARIABLES
|
|||||||
|
|
||||||
exec command
|
exec command
|
||||||
Executes a shell command and displays the output in conky. warn-
|
Executes a shell command and displays the output in conky. warn-
|
||||||
ing: this takes a lot more resources than other variables. I'd
|
ing: this takes a lot more resources than other variables. I'd
|
||||||
recommend coding wanted behaviour in C and posting a patch.
|
recommend coding wanted behaviour in C and posting a patch.
|
||||||
|
|
||||||
|
|
||||||
execbar command
|
execbar command
|
||||||
Same as exec, except if the first value return is a value be-
|
Same as exec, except if the first value return is a value be-
|
||||||
tween 0-100, it will use that number for a bar. The size for the
|
tween 0-100, it will use that number for a bar. The size for the
|
||||||
bar is currently fixed, but that may change in the future.
|
bar is currently fixed, but that may change in the future.
|
||||||
|
|
||||||
@ -723,7 +728,7 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
execi interval command
|
execi interval command
|
||||||
Same as exec but with specific interval. Interval can't be less
|
Same as exec but with specific interval. Interval can't be less
|
||||||
than update_interval in configuration. See also $texeci
|
than update_interval in configuration. See also $texeci
|
||||||
|
|
||||||
|
|
||||||
@ -737,14 +742,14 @@ VARIABLES
|
|||||||
|
|
||||||
execp command
|
execp command
|
||||||
Executes a shell command and displays the output in conky. warn-
|
Executes a shell command and displays the output in conky. warn-
|
||||||
ing: this takes a lot more resources than other variables. I'd
|
ing: this takes a lot more resources than other variables. I'd
|
||||||
recommend coding wanted behaviour in C and posting a patch. This
|
recommend coding wanted behaviour in C and posting a patch. This
|
||||||
differs from $exec in that it parses the output of the command,
|
differs from $exec in that it parses the output of the command,
|
||||||
so you can insert things like ${color red}hi!${color} in your
|
so you can insert things like ${color red}hi!${color} in your
|
||||||
script and have it correctly parsed by Conky. Caveats: Conky
|
script and have it correctly parsed by Conky. Caveats: Conky
|
||||||
parses and evaluates the output of $execp every time Conky
|
parses and evaluates the output of $execp every time Conky
|
||||||
loops, and then destroys all the objects. If you try to use any-
|
loops, and then destroys all the objects. If you try to use any-
|
||||||
thing like $execi within an $execp statement, it will function-
|
thing like $execi within an $execp statement, it will function-
|
||||||
ally run at the same interval that the $execp statement runs, as
|
ally run at the same interval that the $execp statement runs, as
|
||||||
it is created and destroyed at every interval.
|
it is created and destroyed at every interval.
|
||||||
|
|
||||||
@ -752,41 +757,41 @@ VARIABLES
|
|||||||
execpi interval command
|
execpi interval command
|
||||||
Same as execp but with specific interval. Interval can't be less
|
Same as execp but with specific interval. Interval can't be less
|
||||||
than update_interval in configuration. Note that the output from
|
than update_interval in configuration. Note that the output from
|
||||||
the $execpi command is still parsed and evaluated at every in-
|
the $execpi command is still parsed and evaluated at every in-
|
||||||
terval.
|
terval.
|
||||||
|
|
||||||
|
|
||||||
font (font)
|
font (font)
|
||||||
Specify a different font. This new font will apply to the cur-
|
Specify a different font. This new font will apply to the cur-
|
||||||
rent line and everything following. You can use a $font with no
|
rent line and everything following. You can use a $font with no
|
||||||
arguments to change back to the default font (much like with
|
arguments to change back to the default font (much like with
|
||||||
$color)
|
$color)
|
||||||
|
|
||||||
|
|
||||||
freq (n)
|
freq (n)
|
||||||
Returns CPU #n's frequency in MHz. CPUs are counted from 1. If
|
Returns CPU #n's frequency in MHz. CPUs are counted from 1. If
|
||||||
omitted, the parameter defaults to 1.
|
omitted, the parameter defaults to 1.
|
||||||
|
|
||||||
|
|
||||||
freq_g (n)
|
freq_g (n)
|
||||||
Returns CPU #n's frequency in GHz. CPUs are counted from 1. If
|
Returns CPU #n's frequency in GHz. CPUs are counted from 1. If
|
||||||
omitted, the parameter defaults to 1.
|
omitted, the parameter defaults to 1.
|
||||||
|
|
||||||
|
|
||||||
freq_dyn
|
freq_dyn
|
||||||
Returns CPU frequency in MHz, but is calculated by counting to
|
Returns CPU frequency in MHz, but is calculated by counting to
|
||||||
clock cycles to complete an instruction. Only available for
|
clock cycles to complete an instruction. Only available for
|
||||||
x86/amd64.
|
x86/amd64.
|
||||||
|
|
||||||
|
|
||||||
freq_dyn_g
|
freq_dyn_g
|
||||||
Returns CPU frequency in GHz, but is calculated by counting to
|
Returns CPU frequency in GHz, but is calculated by counting to
|
||||||
clock cycles to complete an instruction. Only available for
|
clock cycles to complete an instruction. Only available for
|
||||||
x86/amd64.
|
x86/amd64.
|
||||||
|
|
||||||
|
|
||||||
fs_bar (height),(width) fs
|
fs_bar (height),(width) fs
|
||||||
Bar that shows how much space is used on a file system. height
|
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.
|
is the height in pixels. fs is any file on that file system.
|
||||||
|
|
||||||
|
|
||||||
@ -814,23 +819,23 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
gw_iface
|
gw_iface
|
||||||
Displays the default route's interface or "multiple"/"none" ac-
|
Displays the default route's interface or "multiple"/"none" ac-
|
||||||
cordingly.
|
cordingly.
|
||||||
|
|
||||||
|
|
||||||
gw_ip Displays the default gateway's IP or "multiple"/"none" accord-
|
gw_ip Displays the default gateway's IP or "multiple"/"none" accord-
|
||||||
ingly.
|
ingly.
|
||||||
|
|
||||||
|
|
||||||
hddtemp dev, (host,(port))
|
hddtemp dev, (host,(port))
|
||||||
Displays temperature of a selected hard disk drive as reported
|
Displays temperature of a selected hard disk drive as reported
|
||||||
by the hddtemp daemon running on host:port. Default host is
|
by the hddtemp daemon running on host:port. Default host is
|
||||||
127.0.0.1, default port is 7634.
|
127.0.0.1, default port is 7634.
|
||||||
|
|
||||||
|
|
||||||
head logfile lines (interval)
|
head logfile lines (interval)
|
||||||
Displays first N lines of supplied text text file. If interval
|
Displays first N lines of supplied text text file. If interval
|
||||||
is not supplied, Conky assumes 2x Conky's interval. Max of 30
|
is not supplied, Conky assumes 2x Conky's interval. Max of 30
|
||||||
lines can be displayed, or until the text buffer is filled.
|
lines can be displayed, or until the text buffer is filled.
|
||||||
|
|
||||||
|
|
||||||
@ -839,16 +844,16 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
hwmon (dev) type n
|
hwmon (dev) type n
|
||||||
Hwmon sensor from sysfs (Linux 2.6). Parameter dev may be omit-
|
Hwmon sensor from sysfs (Linux 2.6). Parameter dev may be omit-
|
||||||
ted if you have only one hwmon device. Parameter type is either
|
ted if you have only one hwmon device. Parameter type is either
|
||||||
'in' or 'vol' meaning voltage; 'fan' meaning fan; 'temp' (Cel-
|
'in' or 'vol' meaning voltage; 'fan' meaning fan; 'temp' (Cel-
|
||||||
sius) or 'tempf' (Fahrenheit) meaning temperature. Parameter n
|
sius) or 'tempf' (Fahrenheit) meaning temperature. Parameter n
|
||||||
is number of the sensor. See /sys/class/hwmon/ on your local
|
is number of the sensor. See /sys/class/hwmon/ on your local
|
||||||
computer.
|
computer.
|
||||||
|
|
||||||
|
|
||||||
iconv_start codeset_from codeset_to
|
iconv_start codeset_from codeset_to
|
||||||
Convert text from one codeset to another using GNU iconv. Needs
|
Convert text from one codeset to another using GNU iconv. Needs
|
||||||
to be stopped with iconv_stop.
|
to be stopped with iconv_stop.
|
||||||
|
|
||||||
|
|
||||||
@ -857,75 +862,75 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
i2c (dev) type n
|
i2c (dev) type n
|
||||||
I2C sensor from sysfs (Linux 2.6). Parameter dev may be omitted
|
I2C sensor from sysfs (Linux 2.6). Parameter dev may be omitted
|
||||||
if you have only one I2C device. Parameter type is either 'in'
|
if you have only one I2C device. Parameter type is either 'in'
|
||||||
or 'vol' meaning voltage; 'fan' meaning fan; 'temp' (Celsius) or
|
or 'vol' meaning voltage; 'fan' meaning fan; 'temp' (Celsius) or
|
||||||
'tempf' (Fahrenheit) meaning temperature. Parameter n is number
|
'tempf' (Fahrenheit) meaning temperature. Parameter n is number
|
||||||
of the sensor. See /sys/bus/i2c/devices/ on your local computer.
|
of the sensor. See /sys/bus/i2c/devices/ on your local computer.
|
||||||
|
|
||||||
|
|
||||||
i8k_ac_status
|
i8k_ac_status
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
whether ac power is on, as listed in /proc/i8k (translated to
|
whether ac power is on, as listed in /proc/i8k (translated to
|
||||||
human-readable). Beware that this is by default not enabled by
|
human-readable). Beware that this is by default not enabled by
|
||||||
i8k itself.
|
i8k itself.
|
||||||
|
|
||||||
|
|
||||||
i8k_bios
|
i8k_bios
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
the bios version as listed in /proc/i8k.
|
the bios version as listed in /proc/i8k.
|
||||||
|
|
||||||
|
|
||||||
i8k_buttons_status
|
i8k_buttons_status
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
the volume buttons status as listed in /proc/i8k.
|
the volume buttons status as listed in /proc/i8k.
|
||||||
|
|
||||||
|
|
||||||
i8k_cpu_temp
|
i8k_cpu_temp
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
the cpu temperature in Celsius, as reported by /proc/i8k.
|
the cpu temperature in Celsius, as reported by /proc/i8k.
|
||||||
|
|
||||||
|
|
||||||
i8k_cpu_tempf
|
i8k_cpu_tempf
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
the cpu temperature in Fahrenheit, as reported by /proc/i8k.
|
the cpu temperature in Fahrenheit, as reported by /proc/i8k.
|
||||||
|
|
||||||
|
|
||||||
i8k_left_fan_rpm
|
i8k_left_fan_rpm
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
the left fan's rate of rotation, in revolutions per minute as
|
the left fan's rate of rotation, in revolutions per minute as
|
||||||
listed in /proc/i8k. Beware, some laptops i8k reports these fans
|
listed in /proc/i8k. Beware, some laptops i8k reports these fans
|
||||||
in reverse order.
|
in reverse order.
|
||||||
|
|
||||||
|
|
||||||
i8k_left_fan_status
|
i8k_left_fan_status
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
the left fan status as listed in /proc/i8k (translated to human-
|
the left fan status as listed in /proc/i8k (translated to human-
|
||||||
readable). Beware, some laptops i8k reports these fans in re-
|
readable). Beware, some laptops i8k reports these fans in re-
|
||||||
verse order.
|
verse order.
|
||||||
|
|
||||||
|
|
||||||
i8k_right_fan_rpm
|
i8k_right_fan_rpm
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
the right fan's rate of rotation, in revolutions per minute as
|
the right fan's rate of rotation, in revolutions per minute as
|
||||||
listed in /proc/i8k. Beware, some laptops i8k reports these fans
|
listed in /proc/i8k. Beware, some laptops i8k reports these fans
|
||||||
in reverse order.
|
in reverse order.
|
||||||
|
|
||||||
|
|
||||||
i8k_right_fan_status
|
i8k_right_fan_status
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
the right fan status as listed in /proc/i8k (translated to hu-
|
the right fan status as listed in /proc/i8k (translated to hu-
|
||||||
man-readable). Beware, some laptops i8k reports these fans in
|
man-readable). Beware, some laptops i8k reports these fans in
|
||||||
reverse order.
|
reverse order.
|
||||||
|
|
||||||
|
|
||||||
i8k_serial
|
i8k_serial
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
your laptop serial number as listed in /proc/i8k.
|
your laptop serial number as listed in /proc/i8k.
|
||||||
|
|
||||||
|
|
||||||
i8k_version
|
i8k_version
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
the version formatting of /proc/i8k.
|
the version formatting of /proc/i8k.
|
||||||
|
|
||||||
|
|
||||||
@ -934,13 +939,13 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
ibm_temps N
|
ibm_temps N
|
||||||
If running the IBM ACPI, displays the temperatures from the IBM
|
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
|
temperature sensors (N=0..7) Sensor 0 is on the CPU, 3 is on the
|
||||||
GPU.
|
GPU.
|
||||||
|
|
||||||
|
|
||||||
ibm_volume
|
ibm_volume
|
||||||
If running the IBM ACPI, displays the "master" volume, con-
|
If running the IBM ACPI, displays the "master" volume, con-
|
||||||
trolled by the volume keys (0-14).
|
trolled by the volume keys (0-14).
|
||||||
|
|
||||||
|
|
||||||
@ -950,7 +955,7 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
if_empty (var)
|
if_empty (var)
|
||||||
if conky variable VAR is empty, display everything between
|
if conky variable VAR is empty, display everything between
|
||||||
$if_empty and the matching $endif
|
$if_empty and the matching $endif
|
||||||
|
|
||||||
|
|
||||||
@ -959,14 +964,14 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
if_running (process)
|
if_running (process)
|
||||||
if PROCESS is running, display everything $if_running and the
|
if PROCESS is running, display everything $if_running and the
|
||||||
matching $endif
|
matching $endif
|
||||||
|
|
||||||
|
|
||||||
if_existing file (string)
|
if_existing file (string)
|
||||||
if FILE exists, display everything between if_existing and the
|
if FILE exists, display everything between if_existing and the
|
||||||
matching $endif. The optional second paramater checks for FILE
|
matching $endif. The optional second paramater checks for FILE
|
||||||
containing the specified string and prints everything between
|
containing the specified string and prints everything between
|
||||||
$if_existing and the matching $endif.
|
$if_existing and the matching $endif.
|
||||||
|
|
||||||
|
|
||||||
@ -976,8 +981,8 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
if_smapi_bat_installed (INDEX)
|
if_smapi_bat_installed (INDEX)
|
||||||
when using smapi, if the battery with index INDEX is installed,
|
when using smapi, if the battery with index INDEX is installed,
|
||||||
display everything between $if_smapi_bat_installed and the
|
display everything between $if_smapi_bat_installed and the
|
||||||
matching $endif
|
matching $endif
|
||||||
|
|
||||||
|
|
||||||
@ -988,9 +993,9 @@ VARIABLES
|
|||||||
|
|
||||||
imap_messages (args)
|
imap_messages (args)
|
||||||
Displays the number of messages in your global IMAP inbox by de-
|
Displays the number of messages in your global IMAP inbox by de-
|
||||||
fault. You can define individual IMAP inboxes seperately by
|
fault. You can define individual IMAP inboxes seperately by
|
||||||
passing arguments to this object. Arguments are: "host user pass
|
passing arguments to this object. Arguments are: "host user pass
|
||||||
[-i interval] [-p port] [-e command]". Default port is 143, de-
|
[-i interval] [-p port] [-e command]". Default port is 143, de-
|
||||||
fault interval is 5 minutes. If the password is supplied as '*',
|
fault interval is 5 minutes. If the password is supplied as '*',
|
||||||
you will be prompted to enter the password when Conky starts.
|
you will be prompted to enter the password when Conky starts.
|
||||||
|
|
||||||
@ -999,13 +1004,13 @@ VARIABLES
|
|||||||
Displays the number of unseen messages in your global IMAP inbox
|
Displays the number of unseen messages in your global IMAP inbox
|
||||||
by default. You can define individual IMAP inboxes seperately by
|
by default. You can define individual IMAP inboxes seperately by
|
||||||
passing arguments to this object. Arguments are: "host user pass
|
passing arguments to this object. Arguments are: "host user pass
|
||||||
[-i interval] [-p port] [-e command]". Default port is 143, de-
|
[-i interval] [-p port] [-e command]". Default port is 143, de-
|
||||||
fault interval is 5 minutes. If the password is supplied as '*',
|
fault interval is 5 minutes. If the password is supplied as '*',
|
||||||
you will be prompted to enter the password when Conky starts.
|
you will be prompted to enter the password when Conky starts.
|
||||||
|
|
||||||
|
|
||||||
ioscheduler disk
|
ioscheduler disk
|
||||||
Prints the current ioscheduler used for the given disk name
|
Prints the current ioscheduler used for the given disk name
|
||||||
(i.e. e.g. "hda" or "sdb")
|
(i.e. e.g. "hda" or "sdb")
|
||||||
|
|
||||||
|
|
||||||
@ -1026,16 +1031,16 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
mails (mailbox) (interval)
|
mails (mailbox) (interval)
|
||||||
Mail count in the specified mailbox or your mail spool if not.
|
Mail count in the specified mailbox or your mail spool if not.
|
||||||
Both mbox and maildir type mailboxes are supported. You can use
|
Both mbox and maildir type mailboxes are supported. You can use
|
||||||
a program like fetchmail to get mails from some server using
|
a program like fetchmail to get mails from some server using
|
||||||
your favourite protocol. See also new_mails.
|
your favourite protocol. See also new_mails.
|
||||||
|
|
||||||
|
|
||||||
mboxscan (-n number of messages to print) (-fw from width) (-sw subject
|
mboxscan (-n number of messages to print) (-fw from width) (-sw subject
|
||||||
width) mbox
|
width) mbox
|
||||||
Print a summary of recent messages in an mbox format mailbox.
|
Print a summary of recent messages in an mbox format mailbox.
|
||||||
mbox parameter is the filename of the mailbox (can be encapsu-
|
mbox parameter is the filename of the mailbox (can be encapsu-
|
||||||
lated using '"', ie. ${mboxscan -n 10 "/home/brenden/some box"}
|
lated using '"', ie. ${mboxscan -n 10 "/home/brenden/some box"}
|
||||||
|
|
||||||
|
|
||||||
@ -1119,7 +1124,7 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
nameserver (index)
|
nameserver (index)
|
||||||
Print a nameserver from /etc/resolv.conf. Index starts at and
|
Print a nameserver from /etc/resolv.conf. Index starts at and
|
||||||
defaults to 0.
|
defaults to 0.
|
||||||
|
|
||||||
|
|
||||||
@ -1138,26 +1143,26 @@ VARIABLES
|
|||||||
|
|
||||||
pb_battery item
|
pb_battery item
|
||||||
If running on Apple powerbook/ibook, display information on bat-
|
If running on Apple powerbook/ibook, display information on bat-
|
||||||
tery status. The item parameter specifies, what information to
|
tery status. The item parameter specifies, what information to
|
||||||
display. Exactly one item must be specified. Valid items are:
|
display. Exactly one item must be specified. Valid items are:
|
||||||
|
|
||||||
status: Display if battery is fully charged, charging, discharg-
|
status: Display if battery is fully charged, charging, discharg-
|
||||||
ing or absent (running on AC)
|
ing or absent (running on AC)
|
||||||
percent: Display charge of battery in percent, if charging or
|
percent: Display charge of battery in percent, if charging or
|
||||||
discharging. Nothing will be displayed, if battery is fully
|
discharging. Nothing will be displayed, if battery is fully
|
||||||
charged or absent.
|
charged or absent.
|
||||||
time: Display the time remaining until the battery will be fully
|
time: Display the time remaining until the battery will be fully
|
||||||
charged or discharged at current rate. Nothing is displayed, if
|
charged or discharged at current rate. Nothing is displayed, if
|
||||||
battery is absent or if it's present but fully charged and not
|
battery is absent or if it's present but fully charged and not
|
||||||
discharging.
|
discharging.
|
||||||
|
|
||||||
|
|
||||||
platform (dev) type n
|
platform (dev) type n
|
||||||
Platform sensor from sysfs (Linux 2.6). Parameter dev may be
|
Platform sensor from sysfs (Linux 2.6). Parameter dev may be
|
||||||
omitted if you have only one platform device. Platform type is
|
omitted if you have only one platform device. Platform type is
|
||||||
either 'in' or 'vol' meaning voltage; 'fan' meaning fan; 'temp'
|
either 'in' or 'vol' meaning voltage; 'fan' meaning fan; 'temp'
|
||||||
(Celsius) or 'tempf' (Fahrenheit) meaning temperature. Parameter
|
(Celsius) or 'tempf' (Fahrenheit) meaning temperature. Parameter
|
||||||
n is number of the sensor. See /sys/bus/platform/devices/ on
|
n is number of the sensor. See /sys/bus/platform/devices/ on
|
||||||
your local computer.
|
your local computer.
|
||||||
|
|
||||||
|
|
||||||
@ -1165,17 +1170,17 @@ VARIABLES
|
|||||||
Displays the number of unseen messages in your global POP3 inbox
|
Displays the number of unseen messages in your global POP3 inbox
|
||||||
by default. You can define individual POP3 inboxes seperately by
|
by default. You can define individual POP3 inboxes seperately by
|
||||||
passing arguments to this object. Arguments are: "host user pass
|
passing arguments to this object. Arguments are: "host user pass
|
||||||
[-i interval] [-p port] [-e command]". Default port is 110, de-
|
[-i interval] [-p port] [-e command]". Default port is 110, de-
|
||||||
fault interval is 5 minutes. If the password is supplied as '*',
|
fault interval is 5 minutes. If the password is supplied as '*',
|
||||||
you will be prompted to enter the password when Conky starts.
|
you will be prompted to enter the password when Conky starts.
|
||||||
|
|
||||||
|
|
||||||
pop3_used (args)
|
pop3_used (args)
|
||||||
Displays the amount of space (in MiB, 2^20) used in your global
|
Displays the amount of space (in MiB, 2^20) used in your global
|
||||||
POP3 inbox by default. You can define individual POP3 inboxes
|
POP3 inbox by default. You can define individual POP3 inboxes
|
||||||
seperately by passing arguments to this object. Arguments are:
|
seperately by passing arguments to this object. Arguments are:
|
||||||
"host user pass [-i interval] [-p port] [-e command]". Default
|
"host user pass [-i interval] [-p port] [-e command]". Default
|
||||||
port is 110, default interval is 5 minutes. If the password is
|
port is 110, default interval is 5 minutes. If the password is
|
||||||
supplied as '*', you will be prompted to enter the password when
|
supplied as '*', you will be prompted to enter the password when
|
||||||
Conky starts.
|
Conky starts.
|
||||||
|
|
||||||
@ -1198,21 +1203,21 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
smapi (ARGS)
|
smapi (ARGS)
|
||||||
when using smapi, display contents of the /sys/devices/plat-
|
when using smapi, display contents of the /sys/devices/plat-
|
||||||
form/smapi directory. ARGS are either '(FILENAME)' or 'bat (IN-
|
form/smapi directory. ARGS are either '(FILENAME)' or 'bat (IN-
|
||||||
DEX) (FILENAME)' to display the corresponding files' content.
|
DEX) (FILENAME)' to display the corresponding files' content.
|
||||||
This is a very raw method of accessing the smapi values. When
|
This is a very raw method of accessing the smapi values. When
|
||||||
available, better use one of the smapi_* variables instead.
|
available, better use one of the smapi_* variables instead.
|
||||||
|
|
||||||
|
|
||||||
smapi_bat_perc (INDEX)
|
smapi_bat_perc (INDEX)
|
||||||
when using smapi, display the remaining capacity in percent of
|
when using smapi, display the remaining capacity in percent of
|
||||||
the battery with index INDEX. This is a separate variable be-
|
the battery with index INDEX. This is a separate variable be-
|
||||||
cause it supports the 'use_spacer' configuration option.
|
cause it supports the 'use_spacer' configuration option.
|
||||||
|
|
||||||
|
|
||||||
smapi_bat_bar (INDEX),(height),(width)
|
smapi_bat_bar (INDEX),(height),(width)
|
||||||
when using smapi, display the remaining capacity of the battery
|
when using smapi, display the remaining capacity of the battery
|
||||||
with index INDEX as a bar.
|
with index INDEX as a bar.
|
||||||
|
|
||||||
|
|
||||||
@ -1256,36 +1261,36 @@ VARIABLES
|
|||||||
The connection index provides you with access to each connection
|
The connection index provides you with access to each connection
|
||||||
in the port monitor. The monitor will return information for in-
|
in the port monitor. The monitor will return information for in-
|
||||||
dex values from 0 to n-1 connections. Values higher than n-1 are
|
dex values from 0 to n-1 connections. Values higher than n-1 are
|
||||||
simply ignored. For the "count" item, the connection index must
|
simply ignored. For the "count" item, the connection index must
|
||||||
be omitted. It is required for all other items.
|
be omitted. It is required for all other items.
|
||||||
|
|
||||||
Examples:
|
Examples:
|
||||||
${tcp_portmon 6881 6999 count} - displays the number of connec-
|
${tcp_portmon 6881 6999 count} - displays the number of connec-
|
||||||
tions in the bittorrent port range
|
tions in the bittorrent port range
|
||||||
${tcp_portmon 22 22 rip 0} - displays the remote host ip of the
|
${tcp_portmon 22 22 rip 0} - displays the remote host ip of the
|
||||||
first sshd connection
|
first sshd connection
|
||||||
${tcp_portmon 22 22 rip 9} - displays the remote host ip of the
|
${tcp_portmon 22 22 rip 9} - displays the remote host ip of the
|
||||||
tenth sshd connection
|
tenth sshd connection
|
||||||
${tcp_portmon 1 1024 rhost 0} - displays the remote host name of
|
${tcp_portmon 1 1024 rhost 0} - displays the remote host name of
|
||||||
the first connection on a privileged port
|
the first connection on a privileged port
|
||||||
${tcp_portmon 1 1024 rport 4} - displays the remote host port of
|
${tcp_portmon 1 1024 rport 4} - displays the remote host port of
|
||||||
the fifth connection on a privileged port
|
the fifth connection on a privileged port
|
||||||
${tcp_portmon 1 65535 lservice 14} - displays the local service
|
${tcp_portmon 1 65535 lservice 14} - displays the local service
|
||||||
name of the fifteenth connection in the range of all ports
|
name of the fifteenth connection in the range of all ports
|
||||||
|
|
||||||
Note that port monitor variables which share the same port range
|
Note that port monitor variables which share the same port range
|
||||||
actually refer to the same monitor, so many references to a sin-
|
actually refer to the same monitor, so many references to a sin-
|
||||||
gle port range for different items and different indexes all use
|
gle port range for different items and different indexes all use
|
||||||
the same monitor internally. In other words, the program avoids
|
the same monitor internally. In other words, the program avoids
|
||||||
creating redundant monitors.
|
creating redundant monitors.
|
||||||
|
|
||||||
texeci interval command
|
texeci interval command
|
||||||
Runs a command at an interval inside a thread and displays the
|
Runs a command at an interval inside a thread and displays the
|
||||||
output. Same as $execi, except the command is run inside a
|
output. Same as $execi, except the command is run inside a
|
||||||
thread. Use this if you have a slow script to keep Conky updat-
|
thread. Use this if you have a slow script to keep Conky updat-
|
||||||
ing. You should make the interval slightly longer then the time
|
ing. You should make the interval slightly longer then the time
|
||||||
it takes your script to execute. For example, if you have a
|
it takes your script to execute. For example, if you have a
|
||||||
script that take 5 seconds to execute, you should make the in-
|
script that take 5 seconds to execute, you should make the in-
|
||||||
terval at least 6 seconds. See also $execi.
|
terval at least 6 seconds. See also $execi.
|
||||||
|
|
||||||
|
|
||||||
@ -1294,8 +1299,8 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
rss url delay_in_minutes action item_num
|
rss url delay_in_minutes action item_num
|
||||||
Download and parse RSS feeds. Action may be one of the follow-
|
Download and parse RSS feeds. Action may be one of the follow-
|
||||||
ing: feed_title, item_title (with num par), item_desc (with num
|
ing: feed_title, item_title (with num par), item_desc (with num
|
||||||
par) and item_titles.
|
par) and item_titles.
|
||||||
|
|
||||||
|
|
||||||
@ -1310,7 +1315,7 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
time (format)
|
time (format)
|
||||||
Local time, see man strftime to get more information about for-
|
Local time, see man strftime to get more information about for-
|
||||||
mat
|
mat
|
||||||
|
|
||||||
|
|
||||||
@ -1319,23 +1324,23 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
tztime (timezone) (format)
|
tztime (timezone) (format)
|
||||||
Local time for specified timezone, see man strftime to get more
|
Local time for specified timezone, see man strftime to get more
|
||||||
information about format. The timezone argument is specified in
|
information about format. The timezone argument is specified in
|
||||||
similar fashion as TZ environment variable. For hints, look in
|
similar fashion as TZ environment variable. For hints, look in
|
||||||
/usr/share/zoneinfo. e.g. US/Pacific, Europe/Zurich, etc.
|
/usr/share/zoneinfo. e.g. US/Pacific, Europe/Zurich, etc.
|
||||||
|
|
||||||
|
|
||||||
totaldown net
|
totaldown net
|
||||||
Total download, overflows at 4 GB on Linux with 32-bit arch and
|
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 al-
|
there doesn't seem to be a way to know how many times it has al-
|
||||||
ready done that before conky has started.
|
ready done that before conky has started.
|
||||||
|
|
||||||
|
|
||||||
top type, num
|
top type, num
|
||||||
This takes arguments in the form:top (name) (number) Basically,
|
This takes arguments in the form:top (name) (number) Basically,
|
||||||
processes are ranked from highest to lowest in terms of cpu us-
|
processes are ranked from highest to lowest in terms of cpu us-
|
||||||
age, which is what (num) represents. The types are: "name",
|
age, which is what (num) represents. The types are: "name",
|
||||||
"pid", "cpu", "mem", "mem_res", "mem_vsize", and "time". There
|
"pid", "cpu", "mem", "mem_res", "mem_vsize", and "time". There
|
||||||
can be a max of 10 processes listed.
|
can be a max of 10 processes listed.
|
||||||
|
|
||||||
|
|
||||||
@ -1359,9 +1364,9 @@ VARIABLES
|
|||||||
Upload speed in kilobytes with one decimal
|
Upload speed in kilobytes with one decimal
|
||||||
|
|
||||||
|
|
||||||
upspeedgraph net (height),(width) (gradient colour 1) (gradient colour
|
upspeedgraph net (height),(width) (gradient colour 1) (gradient colour
|
||||||
2) (scale)
|
2) (scale)
|
||||||
Upload speed graph, colours defined in hex, minus the #. If
|
Upload speed graph, colours defined in hex, minus the #. If
|
||||||
scale is non-zero, it becomes the scale for the graph.
|
scale is non-zero, it becomes the scale for the graph.
|
||||||
|
|
||||||
|
|
||||||
@ -1389,12 +1394,12 @@ VARIABLES
|
|||||||
|
|
||||||
|
|
||||||
voffset (pixels)
|
voffset (pixels)
|
||||||
Change vertical offset by N pixels. Negative values will cause
|
Change vertical offset by N pixels. Negative values will cause
|
||||||
text to overlap. See also $offset.
|
text to overlap. See also $offset.
|
||||||
|
|
||||||
|
|
||||||
voltage_mv (n)
|
voltage_mv (n)
|
||||||
Returns CPU #n's voltage in mV. CPUs are counted from 1. If
|
Returns CPU #n's voltage in mV. CPUs are counted from 1. If
|
||||||
omitted, the parameter defaults to 1.
|
omitted, the parameter defaults to 1.
|
||||||
|
|
||||||
|
|
||||||
@ -1522,13 +1527,13 @@ FILES
|
|||||||
BUGS
|
BUGS
|
||||||
Drawing to root or some other desktop window directly doesn't work with
|
Drawing to root or some other desktop window directly doesn't work with
|
||||||
all window managers. Especially doesn't work well with Gnome and it has
|
all window managers. Especially doesn't work well with Gnome and it has
|
||||||
been reported that it doesn't work with KDE either. Nautilus can be
|
been reported that it doesn't work with KDE either. Nautilus can be
|
||||||
disabled from drawing to desktop with program gconf-editor. Uncheck
|
disabled from drawing to desktop with program gconf-editor. Uncheck
|
||||||
show_desktop in /apps/nautilus/preferences/. There is -w switch in
|
show_desktop in /apps/nautilus/preferences/. There is -w switch in
|
||||||
Conky to set some specific window id. You might find xwininfo -tree
|
Conky to set some specific window id. You might find xwininfo -tree
|
||||||
useful to find the window to draw to. You can also use -o argument
|
useful to find the window to draw to. You can also use -o argument
|
||||||
which makes Conky to create its own window. If you do try running Conky
|
which makes Conky to create its own window. If you do try running Conky
|
||||||
in its own window, be sure to read up on the own_window_type settings
|
in its own window, be sure to read up on the own_window_type settings
|
||||||
and experiment.
|
and experiment.
|
||||||
|
|
||||||
SEE ALSO
|
SEE ALSO
|
||||||
@ -1539,11 +1544,11 @@ SEE ALSO
|
|||||||
#conky on irc.freenode.net
|
#conky on irc.freenode.net
|
||||||
|
|
||||||
COPYING
|
COPYING
|
||||||
Copyright (c) 2005-2008 Brenden Matthews, Philip Kovacs, et. al. Any
|
Copyright (c) 2005-2008 Brenden Matthews, Philip Kovacs, et. al. Any
|
||||||
original torsmo code is licensed under the BSD license (see LICENSE.BSD
|
original torsmo code is licensed under the BSD license (see LICENSE.BSD
|
||||||
for a copy). All code written since the fork of torsmo is licensed un-
|
for a copy). All code written since the fork of torsmo is licensed un-
|
||||||
der the GPL (see LICENSE.GPL for a copy), except where noted different-
|
der the GPL (see LICENSE.GPL for a copy), except where noted different-
|
||||||
ly (such as in portmon code, timed thread code, and audacious code
|
ly (such as in portmon code, timed thread code, and audacious code
|
||||||
which are LGPL, and prss which is an MIT-style license).
|
which are LGPL, and prss which is an MIT-style license).
|
||||||
|
|
||||||
AUTHORS
|
AUTHORS
|
||||||
|
|||||||
@ -3,8 +3,8 @@ dnl $Id$
|
|||||||
dnl major, minor and micro version macros.
|
dnl major, minor and micro version macros.
|
||||||
m4_define([conky_version_major], [1])
|
m4_define([conky_version_major], [1])
|
||||||
m4_define([conky_version_minor], [5])
|
m4_define([conky_version_minor], [5])
|
||||||
m4_define([conky_version_micro], [1])
|
m4_define([conky_version_micro], [2])
|
||||||
m4_define([conky_version_tag])dnl, [pre]) dnl [] for releases
|
m4_define([conky_version_tag], [pre]) dnl [] for releases
|
||||||
m4_define([conky_version_revision],[_pre@REVISION@])
|
m4_define([conky_version_revision],[_pre@REVISION@])
|
||||||
m4_define([conky_version],
|
m4_define([conky_version],
|
||||||
[conky_version_major().conky_version_minor().conky_version_micro()ifelse(
|
[conky_version_major().conky_version_minor().conky_version_micro()ifelse(
|
||||||
|
|||||||
@ -1,93 +1,100 @@
|
|||||||
<variablelist>
|
<variablelist>
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command><option>-v | -V | --verbose</option></command></term>
|
<term><command><option>-v | -V | --version</option></command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
Prints version and exits
|
Prints version and exits
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command><option>-a | --alignment=</option></command><option>ALIGNMENT</option></term>
|
<term><command><option>-a | --alignment=</option></command><option>ALIGNMENT</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
Text alignment on screen, {top,bottom}_{left,right} or none
|
Text alignment on screen, {top,bottom,middle}_{left,right,middle} or none
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command><option>-b | --double-buffer</option></command></term>
|
<term><command><option>-b | --double-buffer</option></command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
Use double buffering (eliminates "flicker")
|
Use double buffering (eliminates "flicker")
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command><option>-c | --config=</option></command><option>FILE</option></term>
|
<term><command><option>-c | --config=</option></command><option>FILE</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
Config file to load instead of $HOME/.conkyrc
|
Config file to load instead of $HOME/.conkyrc
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command><option>-d | --daemonize</option></command></term>
|
<term><command><option>-d | --daemonize</option></command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
Daemonize Conky, aka fork to background
|
Daemonize Conky, aka fork to background
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command><option>-f | --font=</option></command><option>FONT</option></term>
|
<term><command><option>-f | --font=</option></command><option>FONT</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
Font to use
|
Font to use
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command><option>-h | --help</option></command></term>
|
<term><command><option>-h | --help</option></command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
Prints command line help and exits
|
Prints command line help and exits
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command><option>-o | --own-window</option></command></term>
|
<term><command><option>-o | --own-window</option></command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
Create own window to draw
|
Create own window to draw
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command><option>-t | --text=</option></command><option>TEXT</option></term>
|
<term><command><option>-t | --text=</option></command><option>TEXT</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
Text to render, remember single quotes, like -t ' $uptime '
|
Text to render, remember single quotes, like -t ' $uptime '
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command><option>-u | --interval=</option></command><option>SECONDS</option></term>
|
<term><command><option>-u | --interval=</option></command><option>SECONDS</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
Update interval
|
Update interval
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command><option>-w | --window-id=</option></command><option>WIN_ID</option></term>
|
<term><command><option>-w | --window-id=</option></command><option>WIN_ID</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
Window id to draw
|
Window id to draw
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command><option>-x </option></command><option>X_COORDINATE</option></term>
|
<term><command><option>-x </option></command><option>X_COORDINATE</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
X position
|
X position
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command><option>-y </option></command><option>Y_COORDINATE</option></term>
|
<term><command><option>-y </option></command><option>Y_COORDINATE</option></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
Y position
|
Y position
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term><command><option>-i </option></command><option>COUNT</option></term>
|
||||||
|
<listitem>
|
||||||
|
Number of times to update Conky (and quit)
|
||||||
|
<para></para></listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
</variablelist>
|
</variablelist>
|
||||||
|
|||||||
@ -69,12 +69,12 @@ Saves you the trouble of having to kill and then restart. You can now also do th
|
|||||||
.SH OPTIONS
|
.SH OPTIONS
|
||||||
Command line options override configurations defined in configuration file.
|
Command line options override configurations defined in configuration file.
|
||||||
.TP
|
.TP
|
||||||
\fB\*(T<\fB\-v | \-V | \-\-verbose\fR\*(T>\fR
|
\fB\*(T<\fB\-v | \-V | \-\-version\fR\*(T>\fR
|
||||||
Prints version and exits
|
Prints version and exits
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\*(T<\fB\-a | \-\-alignment=\fR\*(T>\fR\*(T<\fBALIGNMENT\fR\*(T>
|
\fB\*(T<\fB\-a | \-\-alignment=\fR\*(T>\fR\*(T<\fBALIGNMENT\fR\*(T>
|
||||||
Text alignment on screen, {top,bottom}_{left,right} or none
|
Text alignment on screen, {top,bottom,middle}_{left,right,middle} or none
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\*(T<\fB\-b | \-\-double\-buffer\fR\*(T>\fR
|
\fB\*(T<\fB\-b | \-\-double\-buffer\fR\*(T>\fR
|
||||||
@ -120,6 +120,10 @@ X position
|
|||||||
\fB\*(T<\fB\-y \fR\*(T>\fR\*(T<\fBY_COORDINATE\fR\*(T>
|
\fB\*(T<\fB\-y \fR\*(T>\fR\*(T<\fBY_COORDINATE\fR\*(T>
|
||||||
Y position
|
Y position
|
||||||
|
|
||||||
|
.TP
|
||||||
|
\fB\*(T<\fB\-i \fR\*(T>\fR\*(T<\fBCOUNT\fR\*(T>
|
||||||
|
Number of times to update Conky (and quit)
|
||||||
|
|
||||||
.SH "CONFIGURATION SETTINGS"
|
.SH "CONFIGURATION SETTINGS"
|
||||||
Default configuration file location is $HOME/.conkyrc or
|
Default configuration file location is $HOME/.conkyrc or
|
||||||
${sysconfdir}/conky/conky.conf. On most systems, sysconfdir is /etc,
|
${sysconfdir}/conky/conky.conf. On most systems, sysconfdir is /etc,
|
||||||
|
|||||||
@ -8533,12 +8533,12 @@ int main(int argc, char **argv)
|
|||||||
"Conky is a system monitor that renders text on desktop or to own transparent\n"
|
"Conky is a system monitor that renders text on desktop or to own transparent\n"
|
||||||
"window. Command line options will override configurations defined in config\n"
|
"window. Command line options will override configurations defined in config\n"
|
||||||
"file.\n"
|
"file.\n"
|
||||||
" -V, --version version\n"
|
" -v, --version version\n"
|
||||||
" -c, --config=FILE config file to load\n"
|
" -c, --config=FILE config file to load\n"
|
||||||
" -d, --daemonize daemonize, fork to background\n"
|
" -d, --daemonize daemonize, fork to background\n"
|
||||||
" -h, --help help\n"
|
" -h, --help help\n"
|
||||||
#ifdef X11
|
#ifdef X11
|
||||||
" -a, --alignment=ALIGNMENT text alignment on screen, {top,bottom}_{left,right}\n"
|
" -a, --alignment=ALIGNMENT text alignment on screen, {top,bottom,middle}_{left,right,middle}\n"
|
||||||
" -f, --font=FONT font to use\n"
|
" -f, --font=FONT font to use\n"
|
||||||
#ifdef OWN_WINDOW
|
#ifdef OWN_WINDOW
|
||||||
" -o, --own-window create own window to draw\n"
|
" -o, --own-window create own window to draw\n"
|
||||||
@ -8552,7 +8552,7 @@ int main(int argc, char **argv)
|
|||||||
#endif /* X11 */
|
#endif /* X11 */
|
||||||
" -t, --text=TEXT text to render, remember single quotes, like -t '$uptime'\n"
|
" -t, --text=TEXT text to render, remember single quotes, like -t '$uptime'\n"
|
||||||
" -u, --interval=SECS update interval\n"
|
" -u, --interval=SECS update interval\n"
|
||||||
" -i NUM number of times to update Conky\n",
|
" -i COUNT number of times to update Conky (and quit)\n",
|
||||||
argv[0]
|
argv[0]
|
||||||
);
|
);
|
||||||
return 0;
|
return 0;
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user