mirror of
https://github.com/Llewellynvdm/conky.git
synced 2024-11-17 18:45:10 +00:00
Update docs.
This commit is contained in:
Brenden Matthews
parent
506f6ecc3b
commit
77f818168b
385
README
385
README
@ -796,26 +796,27 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
[1mexecbar command[0m
|
[1mexecbar command[0m
|
||||||
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
|
||||||
bar is currently fixed, but that may change in the future.
|
bars can be controlled via the default_bar_size config setting.
|
||||||
|
|
||||||
|
|
||||||
[1mexecgauge command[0m
|
[1mexecgauge command[0m
|
||||||
Same as exec, except if the first value return is a value be‐
|
Same as exec, except if the first value returned is a value be‐
|
||||||
tween 0-100, it will use that number for a gauge. The size for
|
tween 0-100, it will use that number for a gauge. The size for
|
||||||
the gauge is currently fixed, but you may change that for the
|
gauges can be controlled via the default_gauge_size config set‐
|
||||||
future conky release.
|
ting.
|
||||||
|
|
||||||
|
|
||||||
[1mexecgraph ("normal"|"log") (height),(width) (gradient colour 1) (gradi‐[0m
|
[1mexecgraph ("normal"|"log") (height),(width) (gradient colour 1) (gradi‐[0m
|
||||||
[1ment colour 2) (scale) command[0m
|
[1ment colour 2) (scale) command[0m
|
||||||
Same as execbar, but graphs values. Uses a logaritmic scale when
|
Same as execbar, but graphs values. Uses a logaritmic scale when
|
||||||
the log option is given (to see small numbers). Values still
|
the log option is given (to see small numbers). Values still
|
||||||
have to be between 0 and 100.
|
have to be between 0 and 100. The size for graphs can be con‐
|
||||||
|
trolled via the default_graph_size config setting.
|
||||||
|
|
||||||
|
|
||||||
[1mexeci interval command[0m
|
[1mexeci interval command[0m
|
||||||
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
|
||||||
|
|
||||||
|
|
||||||
@ -824,19 +825,23 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mexecigraph interval command[0m
|
[1mexecigraph interval command[0m
|
||||||
Same as execgraph, but takes an interval arg graphs values
|
Same as execgraph, but takes an interval arg and graphs values.
|
||||||
|
|
||||||
|
|
||||||
|
[1mexecigauge interval command[0m
|
||||||
|
Same as execgauge, but takes an interval arg and gauges values.
|
||||||
|
|
||||||
|
|
||||||
[1mexecp command[0m
|
[1mexecp command[0m
|
||||||
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.
|
||||||
|
|
||||||
@ -844,41 +849,41 @@ conky(1) conky(1)
|
|||||||
[1mexecpi interval command[0m
|
[1mexecpi interval command[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mfont (font)[0m
|
[1mfont (font)[0m
|
||||||
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)
|
||||||
|
|
||||||
|
|
||||||
[1mfreq (n)[0m
|
[1mfreq (n)[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mfreq_g (n)[0m
|
[1mfreq_g (n)[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mfreq_dyn (n)[0m
|
[1mfreq_dyn (n)[0m
|
||||||
Returns CPU #n's frequency in MHz (defaults to 1), but is calcu‐
|
Returns CPU #n's frequency in MHz (defaults to 1), but is calcu‐
|
||||||
lated by counting to clock cycles to complete an instruction.
|
lated by counting to clock cycles to complete an instruction.
|
||||||
Only available for x86/amd64.
|
Only available for x86/amd64.
|
||||||
|
|
||||||
|
|
||||||
[1mfreq_dyn_g (n)[0m
|
[1mfreq_dyn_g (n)[0m
|
||||||
Returns CPU #n's frequency in GHz (defaults to 1), but is calcu‐
|
Returns CPU #n's frequency in GHz (defaults to 1), but is calcu‐
|
||||||
lated by counting to clock cycles to complete an instruction.
|
lated by counting to clock cycles to complete an instruction.
|
||||||
Only available for x86/amd64.
|
Only available for x86/amd64.
|
||||||
|
|
||||||
|
|
||||||
[1mfs_bar (height),(width) fs[0m
|
[1mfs_bar (height),(width) fs[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -906,23 +911,23 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mgw_iface[0m
|
[1mgw_iface[0m
|
||||||
Displays the default route's interface or "multiple"/"none" ac‐
|
Displays the default route's interface or "multiple"/"none" ac‐
|
||||||
cordingly.
|
cordingly.
|
||||||
|
|
||||||
|
|
||||||
[1mgw_ip [22mDisplays the default gateway's IP or "multiple"/"none" accord‐
|
[1mgw_ip [22mDisplays the default gateway's IP or "multiple"/"none" accord‐
|
||||||
ingly.
|
ingly.
|
||||||
|
|
||||||
|
|
||||||
[1mhddtemp dev, (host,(port))[0m
|
[1mhddtemp dev, (host,(port))[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mhead logfile lines (interval)[0m
|
[1mhead logfile lines (interval)[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -931,15 +936,15 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mhwmon (dev) type n[0m
|
[1mhwmon (dev) type n[0m
|
||||||
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' meaning
|
'in' or 'vol' meaning voltage; 'fan' meaning fan; 'temp' meaning
|
||||||
temperature. Parameter n is number of the sensor. See
|
temperature. Parameter n is number of the sensor. See
|
||||||
/sys/class/hwmon/ on your local computer.
|
/sys/class/hwmon/ on your local computer.
|
||||||
|
|
||||||
|
|
||||||
[1miconv_start codeset_from codeset_to[0m
|
[1miconv_start codeset_from codeset_to[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -948,70 +953,70 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mi2c (dev) type n[0m
|
[1mi2c (dev) type n[0m
|
||||||
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' meaning tem‐
|
or 'vol' meaning voltage; 'fan' meaning fan; 'temp' meaning tem‐
|
||||||
perature. Parameter n is number of the sensor. See
|
perature. Parameter n is number of the sensor. See
|
||||||
/sys/bus/i2c/devices/ on your local computer.
|
/sys/bus/i2c/devices/ on your local computer.
|
||||||
|
|
||||||
|
|
||||||
[1mi8k_ac_status[0m
|
[1mi8k_ac_status[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mi8k_bios[0m
|
[1mi8k_bios[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mi8k_buttons_status[0m
|
[1mi8k_buttons_status[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mi8k_cpu_temp[0m
|
[1mi8k_cpu_temp[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mi8k_left_fan_rpm[0m
|
[1mi8k_left_fan_rpm[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mi8k_left_fan_status[0m
|
[1mi8k_left_fan_status[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mi8k_right_fan_rpm[0m
|
[1mi8k_right_fan_rpm[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mi8k_right_fan_status[0m
|
[1mi8k_right_fan_status[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mi8k_serial[0m
|
[1mi8k_serial[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mi8k_version[0m
|
[1mi8k_version[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -1020,13 +1025,13 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mibm_temps N[0m
|
[1mibm_temps N[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mibm_volume[0m
|
[1mibm_volume[0m
|
||||||
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).
|
||||||
|
|
||||||
|
|
||||||
@ -1036,14 +1041,14 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mif_empty (var)[0m
|
[1mif_empty (var)[0m
|
||||||
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
|
||||||
|
|
||||||
|
|
||||||
[1mif_existing file (string)[0m
|
[1mif_existing file (string)[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -1052,11 +1057,11 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mif_match expression[0m
|
[1mif_match expression[0m
|
||||||
Evaluates the given boolean expression, printing everything be‐
|
Evaluates the given boolean expression, printing everything be‐
|
||||||
tween $if_match and the matching $endif depending on whether the
|
tween $if_match and the matching $endif depending on whether the
|
||||||
evaluation returns true or not. Valid expressions consist of a
|
evaluation returns true or not. Valid expressions consist of a
|
||||||
left side, an operator and a right side. Left and right sides
|
left side, an operator and a right side. Left and right sides
|
||||||
are being parsed for contained text objects before evaluation.
|
are being parsed for contained text objects before evaluation.
|
||||||
Recognised left and right side types are:
|
Recognised left and right side types are:
|
||||||
|
|
||||||
[1mdouble[22m: argument consists of only digits and a single dot.
|
[1mdouble[22m: argument consists of only digits and a single dot.
|
||||||
@ -1068,8 +1073,8 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mif_running (process)[0m
|
[1mif_running (process)[0m
|
||||||
if PROCESS is running, display everything $if_running and the
|
if PROCESS is running, display everything $if_running and the
|
||||||
matching $endif. This uses the ``pidof'' command, so the -x
|
matching $endif. This uses the ``pidof'' command, so the -x
|
||||||
switch is also supported.
|
switch is also supported.
|
||||||
|
|
||||||
|
|
||||||
@ -1079,8 +1084,8 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mif_smapi_bat_installed (INDEX)[0m
|
[1mif_smapi_bat_installed (INDEX)[0m
|
||||||
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
|
||||||
|
|
||||||
|
|
||||||
@ -1090,17 +1095,17 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mif_updatenr (updatenr)[0m
|
[1mif_updatenr (updatenr)[0m
|
||||||
If it's the UPDATENR-th time that conky updates, display every‐
|
If it's the UPDATENR-th time that conky updates, display every‐
|
||||||
thing between $if_updatenr and the matching $endif. The counter
|
thing between $if_updatenr and the matching $endif. The counter
|
||||||
resets when the highest UPDATENR is reached. Example :
|
resets when the highest UPDATENR is reached. Example :
|
||||||
"{$if_updatenr 1}foo$endif{$if_updatenr 2}bar$endif{$if_updatenr
|
"{$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
|
4}$endif" shows foo 25% of the time followed by bar 25% of the
|
||||||
time followed by nothing the other half of the time.
|
time followed by nothing the other half of the time.
|
||||||
|
|
||||||
|
|
||||||
[1mimap_messages (args)[0m
|
[1mimap_messages (args)[0m
|
||||||
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] [-r retries]". Default port
|
[-i interval] [-p port] [-e command] [-r retries]". Default port
|
||||||
is 143, default interval is 5 minutes, and default number of re‐
|
is 143, default interval is 5 minutes, and default number of re‐
|
||||||
@ -1119,7 +1124,7 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mioscheduler disk[0m
|
[1mioscheduler disk[0m
|
||||||
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")
|
||||||
|
|
||||||
|
|
||||||
@ -1137,8 +1142,8 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
[1mloadgraph ("normal"|"log") (height),(width) (gradient colour 1) (gradi‐[0m
|
[1mloadgraph ("normal"|"log") (height),(width) (gradient colour 1) (gradi‐[0m
|
||||||
[1ment colour 2) (scale)[0m
|
[1ment colour 2) (scale)[0m
|
||||||
Load1 average graph, similar to xload, with optional colours in
|
Load1 average graph, similar to xload, with optional colours in
|
||||||
hex, minus the #. Uses a logarithmic scale (to see small num‐
|
hex, minus the #. Uses a logarithmic scale (to see small num‐
|
||||||
bers) when you use "log" instead of "normal".
|
bers) when you use "log" instead of "normal".
|
||||||
|
|
||||||
|
|
||||||
@ -1151,9 +1156,9 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mmails (mailbox) (interval)[0m
|
[1mmails (mailbox) (interval)[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -1163,32 +1168,32 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mseen_mails (maildir) (interval)[0m
|
[1mseen_mails (maildir) (interval)[0m
|
||||||
Number of mails marked as seen in the specified mailbox or mail
|
Number of mails marked as seen in the specified mailbox or mail
|
||||||
spool if not. Only maildir type mailboxes are supported, mbox
|
spool if not. Only maildir type mailboxes are supported, mbox
|
||||||
type will return -1.
|
type will return -1.
|
||||||
|
|
||||||
|
|
||||||
[1munseen_mails (maildir) (interval)[0m
|
[1munseen_mails (maildir) (interval)[0m
|
||||||
Number of new or unseen mails in the specified mailbox or mail
|
Number of new or unseen mails in the specified mailbox or mail
|
||||||
spool if not. Only maildir type mailboxes are supported, mbox
|
spool if not. Only maildir type mailboxes are supported, mbox
|
||||||
type will return -1.
|
type will return -1.
|
||||||
|
|
||||||
|
|
||||||
[1mflagged_mails (maildir) (interval)[0m
|
[1mflagged_mails (maildir) (interval)[0m
|
||||||
Number of mails marked as flagged in the specified mailbox or
|
Number of mails marked as flagged in the specified mailbox or
|
||||||
mail spool if not. Only maildir type mailboxes are supported,
|
mail spool if not. Only maildir type mailboxes are supported,
|
||||||
mbox type will return -1.
|
mbox type will return -1.
|
||||||
|
|
||||||
|
|
||||||
[1munflagged_mails (maildir) (interval)[0m
|
[1munflagged_mails (maildir) (interval)[0m
|
||||||
Number of mails not marked as flagged in the specified mailbox
|
Number of mails not marked as flagged in the specified mailbox
|
||||||
or mail spool if not. Only maildir type mailboxes are supported,
|
or mail spool if not. Only maildir type mailboxes are supported,
|
||||||
mbox type will return -1.
|
mbox type will return -1.
|
||||||
|
|
||||||
|
|
||||||
[1mforwarded_mails (maildir) (interval)[0m
|
[1mforwarded_mails (maildir) (interval)[0m
|
||||||
Number of mails marked as forwarded in the specified mailbox or
|
Number of mails marked as forwarded in the specified mailbox or
|
||||||
mail spool if not. Only maildir type mailboxes are supported,
|
mail spool if not. Only maildir type mailboxes are supported,
|
||||||
mbox type will return -1.
|
mbox type will return -1.
|
||||||
|
|
||||||
|
|
||||||
@ -1199,33 +1204,33 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mreplied_mails (maildir) (interval)[0m
|
[1mreplied_mails (maildir) (interval)[0m
|
||||||
Number of mails marked as replied in the specified mailbox or
|
Number of mails marked as replied in the specified mailbox or
|
||||||
mail spool if not. Only maildir type mailboxes are supported,
|
mail spool if not. Only maildir type mailboxes are supported,
|
||||||
mbox type will return -1.
|
mbox type will return -1.
|
||||||
|
|
||||||
|
|
||||||
[1munreplied_mails (maildir) (interval)[0m
|
[1munreplied_mails (maildir) (interval)[0m
|
||||||
Number of mails not marked as replied in the specified mailbox
|
Number of mails not marked as replied in the specified mailbox
|
||||||
or mail spool if not. Only maildir type mailboxes are supported,
|
or mail spool if not. Only maildir type mailboxes are supported,
|
||||||
mbox type will return -1.
|
mbox type will return -1.
|
||||||
|
|
||||||
|
|
||||||
[1mdraft_mails (maildir) (interval)[0m
|
[1mdraft_mails (maildir) (interval)[0m
|
||||||
Number of mails marked as draft in the specified mailbox or mail
|
Number of mails marked as draft in the specified mailbox or mail
|
||||||
spool if not. Only maildir type mailboxes are supported, mbox
|
spool if not. Only maildir type mailboxes are supported, mbox
|
||||||
type will return -1.
|
type will return -1.
|
||||||
|
|
||||||
|
|
||||||
[1mtrashed_mails (maildir) (interval)[0m
|
[1mtrashed_mails (maildir) (interval)[0m
|
||||||
Number of mails marked as trashed in the specified mailbox or
|
Number of mails marked as trashed in the specified mailbox or
|
||||||
mail spool if not. Only maildir type mailboxes are supported,
|
mail spool if not. Only maildir type mailboxes are supported,
|
||||||
mbox type will return -1.
|
mbox type will return -1.
|
||||||
|
|
||||||
|
|
||||||
[1mmboxscan (-n number of messages to print) (-fw from width) (-sw subject[0m
|
[1mmboxscan (-n number of messages to print) (-fw from width) (-sw subject[0m
|
||||||
[1mwidth) mbox[0m
|
[1mwidth) mbox[0m
|
||||||
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"}
|
||||||
|
|
||||||
|
|
||||||
@ -1240,14 +1245,14 @@ conky(1) conky(1)
|
|||||||
Gauge that shows amount of memory in use (see cpugauge)
|
Gauge that shows amount of memory in use (see cpugauge)
|
||||||
|
|
||||||
|
|
||||||
[1mmemgraph ("normal"|"log") (height),(width) (gradient colour 1) (gradi‐[0m
|
[1mmemgraph ("normal"|"log") (height),(width) (gradient colour 1) (gradi‐[0m
|
||||||
[1ment colour 2) (scale)[0m
|
[1ment colour 2) (scale)[0m
|
||||||
Memory usage graph. Uses a logarithmic scale (to see small num‐
|
Memory usage graph. Uses a logarithmic scale (to see small num‐
|
||||||
bers) when you use "log" instead of "normal".
|
bers) when you use "log" instead of "normal".
|
||||||
|
|
||||||
|
|
||||||
[1mmemeasyfree[0m
|
[1mmemeasyfree[0m
|
||||||
Amount of free memory including the memory that is very easily
|
Amount of free memory including the memory that is very easily
|
||||||
freed (buffers/cache)
|
freed (buffers/cache)
|
||||||
|
|
||||||
|
|
||||||
@ -1263,39 +1268,39 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mmixer (device)[0m
|
[1mmixer (device)[0m
|
||||||
Prints the mixer value as reported by the OS. Default mixer is
|
Prints the mixer value as reported by the OS. Default mixer is
|
||||||
"vol", but you can specify one of the following optional argu‐
|
"vol", but you can specify one of the following optional argu‐
|
||||||
ments: "vol", "bass", "treble", "synth", "pcm", "speaker",
|
ments: "vol", "bass", "treble", "synth", "pcm", "speaker",
|
||||||
"line", "mic", "cd", "mix", "pcm2", "rec", "igain", "ogain",
|
"line", "mic", "cd", "mix", "pcm2", "rec", "igain", "ogain",
|
||||||
"line1", "line2", "line3", "dig1", "dig2", "dig3", "phin",
|
"line1", "line2", "line3", "dig1", "dig2", "dig3", "phin",
|
||||||
"phout", "video", "radio", "monitor". Refer to the definition of
|
"phout", "video", "radio", "monitor". Refer to the definition of
|
||||||
SOUND_DEVICE_NAMES in <linux/soundcard.h> (on Linux), <sound‐
|
SOUND_DEVICE_NAMES in <linux/soundcard.h> (on Linux), <sound‐
|
||||||
card.h> (on OpenBSD), or <sys/soundcard.h> to find the exact op‐
|
card.h> (on OpenBSD), or <sys/soundcard.h> to find the exact op‐
|
||||||
tions available on your system.
|
tions available on your system.
|
||||||
|
|
||||||
|
|
||||||
[1mmixerbar (device)[0m
|
[1mmixerbar (device)[0m
|
||||||
Displays mixer value in a bar as reported by the OS. See docs
|
Displays mixer value in a bar as reported by the OS. See docs
|
||||||
for $mixer for details on arguments.
|
for $mixer for details on arguments.
|
||||||
|
|
||||||
|
|
||||||
[1mmixerr (device)[0m
|
[1mmixerr (device)[0m
|
||||||
Prints the right channel mixer value as reported by the OS. See
|
Prints the right channel mixer value as reported by the OS. See
|
||||||
docs for $mixer for details on arguments.
|
docs for $mixer for details on arguments.
|
||||||
|
|
||||||
|
|
||||||
[1mmixerrbar (device)[0m
|
[1mmixerrbar (device)[0m
|
||||||
Displays the right channel mixer value in a bar as reported by
|
Displays the right channel mixer value in a bar as reported by
|
||||||
the OS. See docs for $mixer for details on arguments.
|
the OS. See docs for $mixer for details on arguments.
|
||||||
|
|
||||||
|
|
||||||
[1mmixerl (device)[0m
|
[1mmixerl (device)[0m
|
||||||
Prints the left channel mixer value as reported by the OS. See
|
Prints the left channel mixer value as reported by the OS. See
|
||||||
docs for $mixer for details on arguments.
|
docs for $mixer for details on arguments.
|
||||||
|
|
||||||
|
|
||||||
[1mmixerlbar (device)[0m
|
[1mmixerlbar (device)[0m
|
||||||
Displays the left channel mixer value in a bar as reported by
|
Displays the left channel mixer value in a bar as reported by
|
||||||
the OS. See docs for $mixer for details on arguments.
|
the OS. See docs for $mixer for details on arguments.
|
||||||
|
|
||||||
|
|
||||||
@ -1417,12 +1422,12 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mif_mpd_playing[0m
|
[1mif_mpd_playing[0m
|
||||||
if mpd is playing or paused, display everything between
|
if mpd is playing or paused, display everything between
|
||||||
$if_mpd_playing and the matching $endif
|
$if_mpd_playing and the matching $endif
|
||||||
|
|
||||||
|
|
||||||
[1mnameserver (index)[0m
|
[1mnameserver (index)[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -1431,8 +1436,8 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mnvidia threshold temp ambient gpufreq memfreq imagequality[0m
|
[1mnvidia threshold temp ambient gpufreq memfreq imagequality[0m
|
||||||
Nvidia graficcard support for the XNVCtrl library. Each option
|
Nvidia graficcard support for the XNVCtrl library. Each option
|
||||||
can be shortened to the least significant part. Temperatures
|
can be shortened to the least significant part. Temperatures
|
||||||
are printed as float, all other values as integer.
|
are printed as float, all other values as integer.
|
||||||
|
|
||||||
[1mthreshold[22m: the thresholdtemperature at which the gpu slows down
|
[1mthreshold[22m: the thresholdtemperature at which the gpu slows down
|
||||||
@ -1450,25 +1455,25 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
[1mpb_battery item[0m
|
[1mpb_battery item[0m
|
||||||
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:
|
||||||
|
|
||||||
[1mstatus[22m: Display if battery is fully charged, charging, discharg‐
|
[1mstatus[22m: Display if battery is fully charged, charging, discharg‐
|
||||||
ing or absent (running on AC)
|
ing or absent (running on AC)
|
||||||
[1mpercent[22m: Display charge of battery in percent, if charging or
|
[1mpercent[22m: 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.
|
||||||
[1mtime[22m: Display the time remaining until the battery will be fully
|
[1mtime[22m: 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.
|
||||||
|
|
||||||
|
|
||||||
[1mplatform (dev) type n[0m
|
[1mplatform (dev) type n[0m
|
||||||
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'
|
||||||
meaning temperature. Parameter n is number of the sensor. See
|
meaning temperature. Parameter n is number of the sensor. See
|
||||||
/sys/bus/platform/devices/ on your local computer.
|
/sys/bus/platform/devices/ on your local computer.
|
||||||
|
|
||||||
|
|
||||||
@ -1483,13 +1488,13 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mpop3_used (args)[0m
|
[1mpop3_used (args)[0m
|
||||||
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] [-r re‐
|
"host user pass [-i interval] [-p port] [-e command] [-r re‐
|
||||||
tries]". Default port is 110, default interval is 5 minutes, and
|
tries]". Default port is 110, default interval is 5 minutes, and
|
||||||
default number of retries before giving up is 5. If the password
|
default number of retries before giving up is 5. If the password
|
||||||
is supplied as '*', you will be prompted to enter the password
|
is supplied as '*', you will be prompted to enter the password
|
||||||
when Conky starts.
|
when Conky starts.
|
||||||
|
|
||||||
|
|
||||||
@ -1507,14 +1512,14 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mscroll length (step) text[0m
|
[1mscroll length (step) text[0m
|
||||||
Scroll 'text' by 'step' characters showing 'length' number of
|
Scroll 'text' by 'step' characters showing 'length' number of
|
||||||
characters at the same time. The text may also contain vari‐
|
characters at the same time. The text may also contain vari‐
|
||||||
ables. 'step' is optional and defaults to 1 if not set. If a var
|
ables. 'step' is optional and defaults to 1 if not set. If a var
|
||||||
creates output on multiple lines then the lines are placed be‐
|
creates output on multiple lines then the lines are placed be‐
|
||||||
hind each other separated with a '|'-sign. Do NOT use vars that
|
hind each other separated with a '|'-sign. Do NOT use vars that
|
||||||
change colors or otherwise affect the design inside a scrolling
|
change colors or otherwise affect the design inside a scrolling
|
||||||
text. If you want spaces between the start and the end of
|
text. If you want spaces between the start and the end of
|
||||||
'text', place them at the end of 'text' not at the front ("foo‐
|
'text', place them at the end of 'text' not at the front ("foo‐
|
||||||
bar" and " foobar" can both generate "barfoo" but "foobar " will
|
bar" and " foobar" can both generate "barfoo" but "foobar " will
|
||||||
keep the spaces like this "bar foo").
|
keep the spaces like this "bar foo").
|
||||||
|
|
||||||
@ -1524,35 +1529,35 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1msmapi (ARGS)[0m
|
[1msmapi (ARGS)[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1msmapi_bat_bar (INDEX),(height),(width)[0m
|
[1msmapi_bat_bar (INDEX),(height),(width)[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1msmapi_bat_perc (INDEX)[0m
|
[1msmapi_bat_perc (INDEX)[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1msmapi_bat_power INDEX[0m
|
[1msmapi_bat_power INDEX[0m
|
||||||
when using smapi, display the current power of the battery with
|
when using smapi, display the current power of the battery with
|
||||||
index INDEX in watt. This is a separate variable because the
|
index INDEX in watt. This is a separate variable because the
|
||||||
original read out value is being converted from mW. The sign of
|
original read out value is being converted from mW. The sign of
|
||||||
the output reflects charging (positive) or discharging (nega‐
|
the output reflects charging (positive) or discharging (nega‐
|
||||||
tive) state.
|
tive) state.
|
||||||
|
|
||||||
|
|
||||||
[1msmapi_bat_temp INDEX[0m
|
[1msmapi_bat_temp INDEX[0m
|
||||||
when using smapi, display the current temperature of the battery
|
when using smapi, display the current temperature of the battery
|
||||||
with index INDEX in degree Celsius. This is a separate variable
|
with index INDEX in degree Celsius. This is a separate variable
|
||||||
because the original read out value is being converted from mil‐
|
because the original read out value is being converted from mil‐
|
||||||
li degree Celsius.
|
li degree Celsius.
|
||||||
|
|
||||||
@ -1597,36 +1602,36 @@ conky(1) conky(1)
|
|||||||
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:
|
||||||
[1m${tcp_portmon 6881 6999 count} [22m- displays the number of connec‐
|
[1m${tcp_portmon 6881 6999 count} [22m- displays the number of connec‐
|
||||||
tions in the bittorrent port range
|
tions in the bittorrent port range
|
||||||
[1m${tcp_portmon 22 22 rip 0} [22m- displays the remote host ip of the
|
[1m${tcp_portmon 22 22 rip 0} [22m- displays the remote host ip of the
|
||||||
first sshd connection
|
first sshd connection
|
||||||
[1m${tcp_portmon 22 22 rip 9} [22m- displays the remote host ip of the
|
[1m${tcp_portmon 22 22 rip 9} [22m- displays the remote host ip of the
|
||||||
tenth sshd connection
|
tenth sshd connection
|
||||||
[1m${tcp_portmon 1 1024 rhost 0} [22m- displays the remote host name of
|
[1m${tcp_portmon 1 1024 rhost 0} [22m- displays the remote host name of
|
||||||
the first connection on a privileged port
|
the first connection on a privileged port
|
||||||
[1m${tcp_portmon 1 1024 rport 4} [22m- displays the remote host port of
|
[1m${tcp_portmon 1 1024 rport 4} [22m- displays the remote host port of
|
||||||
the fifth connection on a privileged port
|
the fifth connection on a privileged port
|
||||||
[1m${tcp_portmon 1 65535 lservice 14} [22m- displays the local service
|
[1m${tcp_portmon 1 65535 lservice 14} [22m- 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.
|
||||||
|
|
||||||
[1mtexeci interval command[0m
|
[1mtexeci interval command[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -1635,8 +1640,8 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mrss url delay_in_minutes action item_num[0m
|
[1mrss url delay_in_minutes action item_num[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -1652,14 +1657,14 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mtemplateN (arg1) (arg2) (arg3 ...)[0m
|
[1mtemplateN (arg1) (arg2) (arg3 ...)[0m
|
||||||
Evaluate the content of the templateN configuration variable
|
Evaluate the content of the templateN configuration variable
|
||||||
(where N is a value between 0 and 9, inclusively), applying sub‐
|
(where N is a value between 0 and 9, inclusively), applying sub‐
|
||||||
stitutions as described in the documentation of the correspond‐
|
stitutions as described in the documentation of the correspond‐
|
||||||
ing configuration variable. The number of arguments is option‐
|
ing configuration variable. The number of arguments is option‐
|
||||||
al, but must match the highest referred index in the template.
|
al, but must match the highest referred index in the template.
|
||||||
You can use the same special sequences in each argument as the
|
You can use the same special sequences in each argument as the
|
||||||
ones valid for a template definition, e.g. to allow an argument
|
ones valid for a template definition, e.g. to allow an argument
|
||||||
to contain a whitespace. Also simple nesting of templates is
|
to contain a whitespace. Also simple nesting of templates is
|
||||||
possible this way.
|
possible this way.
|
||||||
|
|
||||||
Here are some examples of template definitions:
|
Here are some examples of template definitions:
|
||||||
@ -1668,7 +1673,7 @@ conky(1) conky(1)
|
|||||||
template1 \1: ${fs_used \2} / ${fs_size \2}
|
template1 \1: ${fs_used \2} / ${fs_size \2}
|
||||||
template2 \1 \2
|
template2 \1 \2
|
||||||
|
|
||||||
The following list shows sample usage of the templates defined
|
The following list shows sample usage of the templates defined
|
||||||
above, with the equivalent syntax when not using any template at
|
above, with the equivalent syntax when not using any template at
|
||||||
all:
|
all:
|
||||||
|
|
||||||
@ -1681,7 +1686,7 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mtime (format)[0m
|
[1mtime (format)[0m
|
||||||
Local time, see man strftime to get more information about for‐
|
Local time, see man strftime to get more information about for‐
|
||||||
mat
|
mat
|
||||||
|
|
||||||
|
|
||||||
@ -1690,23 +1695,23 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mtztime (timezone) (format)[0m
|
[1mtztime (timezone) (format)[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mtotaldown net[0m
|
[1mtotaldown net[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mtop type, num[0m
|
[1mtop type, num[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -1715,7 +1720,7 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mtop_time type, num[0m
|
[1mtop_time type, num[0m
|
||||||
Same as top, except sorted by total CPU time instead of current
|
Same as top, except sorted by total CPU time instead of current
|
||||||
CPU usage
|
CPU usage
|
||||||
|
|
||||||
|
|
||||||
@ -1737,9 +1742,9 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
[1mupspeedgraph ("normal"|"log") (height),(width) (gradient colour 1)[0m
|
[1mupspeedgraph ("normal"|"log") (height),(width) (gradient colour 1)[0m
|
||||||
[1m(gradient colour 2) (scale) (net)[0m
|
[1m(gradient colour 2) (scale) (net)[0m
|
||||||
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. Uses a
|
scale is non-zero, it becomes the scale for the graph. Uses a
|
||||||
logarithmic scale (to see small numbers) when you use "log" in‐
|
logarithmic scale (to see small numbers) when you use "log" in‐
|
||||||
stead of "normal".
|
stead of "normal".
|
||||||
|
|
||||||
|
|
||||||
@ -1767,12 +1772,12 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mvoffset (pixels)[0m
|
[1mvoffset (pixels)[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
[1mvoltage_mv (n)[0m
|
[1mvoltage_mv (n)[0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -1891,12 +1896,12 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
[1mif_xmms2_connected[0m
|
[1mif_xmms2_connected[0m
|
||||||
Display everything between $if_xmms2_connected and the matching
|
Display everything between $if_xmms2_connected and the matching
|
||||||
$endif if xmms2 is running.
|
$endif if xmms2 is running.
|
||||||
|
|
||||||
|
|
||||||
[1meve api_userid api_key character_id[0m
|
[1meve api_userid api_key character_id[0m
|
||||||
Fetches your currently training skill from the Eve Online API
|
Fetches your currently training skill from the Eve Online API
|
||||||
servers (http://www.eve-online.com/) and displays the skill
|
servers (http://www.eve-online.com/) and displays the skill
|
||||||
along with the remaining training time.
|
along with the remaining training time.
|
||||||
|
|
||||||
@ -1915,13 +1920,13 @@ conky(1) conky(1)
|
|||||||
[1mBUGS[0m
|
[1mBUGS[0m
|
||||||
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.
|
||||||
|
|
||||||
[1mSEE ALSO[0m
|
[1mSEE ALSO[0m
|
||||||
@ -1932,11 +1937,11 @@ conky(1) conky(1)
|
|||||||
#conky on irc.freenode.net
|
#conky on irc.freenode.net
|
||||||
|
|
||||||
[1mCOPYING[0m
|
[1mCOPYING[0m
|
||||||
Copyright (c) 2005-2009 Brenden Matthews, Philip Kovacs, et. al. Any
|
Copyright (c) 2005-2009 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).
|
||||||
|
|
||||||
[1mAUTHORS[0m
|
[1mAUTHORS[0m
|
||||||
|
|||||||
12
doc/conky.1
12
doc/conky.1
@ -696,15 +696,15 @@ Executes a shell command and displays the output in conky. warning: this takes a
|
|||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\*(T<\fBexecbar\fR\*(T>\fR \*(T<\fBcommand\fR\*(T>
|
\fB\*(T<\fBexecbar\fR\*(T>\fR \*(T<\fBcommand\fR\*(T>
|
||||||
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 the bar is currently fixed, but that may change in the future.
|
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.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\*(T<\fBexecgauge\fR\*(T>\fR \*(T<\fBcommand\fR\*(T>
|
\fB\*(T<\fBexecgauge\fR\*(T>\fR \*(T<\fBcommand\fR\*(T>
|
||||||
Same as exec, except if the first value return is a value between 0-100, it will use that number for a gauge. The size for the gauge is currently fixed, but you may change that for the future conky release.
|
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.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\*(T<\fBexecgraph\fR\*(T>\fR \*(T<\fB("normal"|"log") (height),(width) (gradient colour 1) (gradient colour 2) (scale) command\fR\*(T>
|
\fB\*(T<\fBexecgraph\fR\*(T>\fR \*(T<\fB("normal"|"log") (height),(width) (gradient colour 1) (gradient colour 2) (scale) command\fR\*(T>
|
||||||
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.
|
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.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\*(T<\fBexeci\fR\*(T>\fR \*(T<\fBinterval command\fR\*(T>
|
\fB\*(T<\fBexeci\fR\*(T>\fR \*(T<\fBinterval command\fR\*(T>
|
||||||
@ -716,7 +716,11 @@ Same as execbar, except with an interval
|
|||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\*(T<\fBexecigraph\fR\*(T>\fR \*(T<\fBinterval command\fR\*(T>
|
\fB\*(T<\fBexecigraph\fR\*(T>\fR \*(T<\fBinterval command\fR\*(T>
|
||||||
Same as execgraph, but takes an interval arg graphs values
|
Same as execgraph, but takes an interval arg and graphs values.
|
||||||
|
|
||||||
|
.TP
|
||||||
|
\fB\*(T<\fBexecigauge\fR\*(T>\fR \*(T<\fBinterval command\fR\*(T>
|
||||||
|
Same as execgauge, but takes an interval arg and gauges values.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\*(T<\fBexecp\fR\*(T>\fR \*(T<\fBcommand\fR\*(T>
|
\fB\*(T<\fBexecp\fR\*(T>\fR \*(T<\fBcommand\fR\*(T>
|
||||||
|
|||||||
@ -611,7 +611,7 @@
|
|||||||
<option>command</option>
|
<option>command</option>
|
||||||
</term>
|
</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
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 the bar is currently fixed, but that may change in the future.
|
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.
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
@ -621,7 +621,7 @@
|
|||||||
<option>command</option>
|
<option>command</option>
|
||||||
</term>
|
</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
Same as exec, except if the first value return is a value between 0-100, it will use that number for a gauge. The size for the gauge is currently fixed, but you may change that for the future conky release.
|
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.
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
@ -631,7 +631,7 @@
|
|||||||
<option>("normal"|"log") (height),(width) (gradient colour 1) (gradient colour 2) (scale) command</option>
|
<option>("normal"|"log") (height),(width) (gradient colour 1) (gradient colour 2) (scale) command</option>
|
||||||
</term>
|
</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
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.
|
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.
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
@ -661,7 +661,17 @@
|
|||||||
<option>interval command</option>
|
<option>interval command</option>
|
||||||
</term>
|
</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
Same as execgraph, but takes an interval arg graphs values
|
Same as execgraph, but takes an interval arg and graphs values.
|
||||||
|
<para></para></listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>
|
||||||
|
<command><option>execigauge</option></command>
|
||||||
|
<option>interval command</option>
|
||||||
|
</term>
|
||||||
|
<listitem>
|
||||||
|
Same as execgauge, but takes an interval arg and gauges values.
|
||||||
<para></para></listitem>
|
<para></para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user