mirror of
https://github.com/Llewellynvdm/conky.git
synced 2025-01-13 19:22:58 +00:00
Regenerate docs.
This commit is contained in:
Brenden Matthews
parent
3d56128925
commit
c8e2437f1e
387
README
387
README
@ -677,6 +677,12 @@ conky(1) conky(1)
|
|||||||
$cpu for more info on SMP.
|
$cpu for more info on SMP.
|
||||||
|
|
||||||
|
|
||||||
|
1mcpugauge (cpu number) (height),(width)0m
|
||||||
|
Elliptical gauge that shows CPU usage, height and width are
|
||||||
|
gauge's vertical and horizontal axis respectively. See $cpu for
|
||||||
|
more info on SMP.
|
||||||
|
|
||||||
|
|
||||||
1mcpugraph ("normal"|"log") (height),(width) (gradient colour 1) (gradi‐0m
|
1mcpugraph ("normal"|"log") (height),(width) (gradient colour 1) (gradi‐0m
|
||||||
1ment colour 2) (scale) (cpu number)0m
|
1ment colour 2) (scale) (cpu number)0m
|
||||||
CPU usage graph, with optional colours in hex, minus the #. See
|
CPU usage graph, with optional colours in hex, minus the #. See
|
||||||
@ -769,15 +775,22 @@ conky(1) conky(1)
|
|||||||
bar is currently fixed, but that may change in the future.
|
bar is currently fixed, but that may change in the future.
|
||||||
|
|
||||||
|
|
||||||
|
1mexecgauge command0m
|
||||||
|
Same as exec, except if the first value return is a value be‐
|
||||||
|
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
|
||||||
|
future conky release.
|
||||||
|
|
||||||
|
|
||||||
1mexecgraph ("normal"|"log") (height),(width) (gradient colour 1) (gradi‐0m
|
1mexecgraph ("normal"|"log") (height),(width) (gradient colour 1) (gradi‐0m
|
||||||
1ment colour 2) (scale) command0m
|
1ment colour 2) (scale) command0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
1mexeci interval command0m
|
1mexeci interval command0m
|
||||||
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
|
||||||
|
|
||||||
|
|
||||||
@ -791,14 +804,14 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
1mexecp command0m
|
1mexecp command0m
|
||||||
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.
|
||||||
|
|
||||||
@ -806,41 +819,41 @@ conky(1) conky(1)
|
|||||||
1mexecpi interval command0m
|
1mexecpi interval command0m
|
||||||
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) fs0m
|
1mfs_bar (height),(width) fs0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -868,23 +881,23 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mgw_iface0m
|
1mgw_iface0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -893,15 +906,15 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mhwmon (dev) type n0m
|
1mhwmon (dev) type n0m
|
||||||
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_to0m
|
1miconv_start codeset_from codeset_to0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -910,70 +923,70 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mi2c (dev) type n0m
|
1mi2c (dev) type n0m
|
||||||
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_status0m
|
1mi8k_ac_status0m
|
||||||
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_bios0m
|
1mi8k_bios0m
|
||||||
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_status0m
|
1mi8k_buttons_status0m
|
||||||
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_temp0m
|
1mi8k_cpu_temp0m
|
||||||
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_rpm0m
|
1mi8k_left_fan_rpm0m
|
||||||
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_status0m
|
1mi8k_left_fan_status0m
|
||||||
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_rpm0m
|
1mi8k_right_fan_rpm0m
|
||||||
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_status0m
|
1mi8k_right_fan_status0m
|
||||||
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_serial0m
|
1mi8k_serial0m
|
||||||
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_version0m
|
1mi8k_version0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -982,13 +995,13 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mibm_temps N0m
|
1mibm_temps N0m
|
||||||
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_volume0m
|
1mibm_volume0m
|
||||||
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).
|
||||||
|
|
||||||
|
|
||||||
@ -998,14 +1011,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1014,11 +1027,11 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mif_match expression0m
|
1mif_match expression0m
|
||||||
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:
|
||||||
|
|
||||||
1mdouble22m: argument consists of only digits and a single dot.
|
1mdouble22m: argument consists of only digits and a single dot.
|
||||||
@ -1030,8 +1043,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1041,8 +1054,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
|
||||||
|
|
||||||
|
|
||||||
@ -1052,17 +1065,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‐
|
||||||
@ -1081,7 +1094,7 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mioscheduler disk0m
|
1mioscheduler disk0m
|
||||||
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")
|
||||||
|
|
||||||
|
|
||||||
@ -1099,8 +1112,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".
|
||||||
|
|
||||||
|
|
||||||
@ -1113,9 +1126,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1125,32 +1138,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1161,33 +1174,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 subject0m
|
1mmboxscan (-n number of messages to print) (-fw from width) (-sw subject0m
|
||||||
1mwidth) mbox0m
|
1mwidth) mbox0m
|
||||||
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"}
|
||||||
|
|
||||||
|
|
||||||
@ -1198,14 +1211,18 @@ conky(1) conky(1)
|
|||||||
Bar that shows amount of memory in use
|
Bar that shows amount of memory in use
|
||||||
|
|
||||||
|
|
||||||
1mmemgraph ("normal"|"log") (height),(width) (gradient colour 1) (gradi‐0m
|
1mmemgauge (height),(width)0m
|
||||||
|
Gauge that shows amount of memory in use (see cpugauge)
|
||||||
|
|
||||||
|
|
||||||
|
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".
|
||||||
|
|
||||||
|
|
||||||
1mmemeasyfree0m
|
1mmemeasyfree0m
|
||||||
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)
|
||||||
|
|
||||||
|
|
||||||
@ -1221,39 +1238,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1375,12 +1392,12 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mif_mpd_playing0m
|
1mif_mpd_playing0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -1389,8 +1406,8 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mnvidia threshold temp ambient gpufreq memfreq imagequality0m
|
1mnvidia threshold temp ambient gpufreq memfreq imagequality0m
|
||||||
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.
|
||||||
|
|
||||||
1mthreshold22m: the thresholdtemperature at which the gpu slows down
|
1mthreshold22m: the thresholdtemperature at which the gpu slows down
|
||||||
@ -1408,25 +1425,25 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
1mpb_battery item0m
|
1mpb_battery item0m
|
||||||
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:
|
||||||
|
|
||||||
1mstatus22m: Display if battery is fully charged, charging, discharg‐
|
1mstatus22m: Display if battery is fully charged, charging, discharg‐
|
||||||
ing or absent (running on AC)
|
ing or absent (running on AC)
|
||||||
1mpercent22m: Display charge of battery in percent, if charging or
|
1mpercent22m: 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.
|
||||||
1mtime22m: Display the time remaining until the battery will be fully
|
1mtime22m: 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 n0m
|
1mplatform (dev) type n0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -1441,13 +1458,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1465,14 +1482,14 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mscroll length (step) text0m
|
1mscroll length (step) text0m
|
||||||
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").
|
||||||
|
|
||||||
@ -1482,35 +1499,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 INDEX0m
|
1msmapi_bat_power INDEX0m
|
||||||
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 INDEX0m
|
1msmapi_bat_temp INDEX0m
|
||||||
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.
|
||||||
|
|
||||||
@ -1555,36 +1572,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 command0m
|
1mtexeci interval command0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -1593,8 +1610,8 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mrss url delay_in_minutes action item_num0m
|
1mrss url delay_in_minutes action item_num0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -1609,14 +1626,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:
|
||||||
@ -1625,7 +1642,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:
|
||||||
|
|
||||||
@ -1638,7 +1655,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
|
||||||
|
|
||||||
|
|
||||||
@ -1647,23 +1664,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 net0m
|
1mtotaldown net0m
|
||||||
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, num0m
|
1mtop type, num0m
|
||||||
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.
|
||||||
|
|
||||||
|
|
||||||
@ -1672,7 +1689,7 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mtop_time type, num0m
|
1mtop_time type, num0m
|
||||||
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
|
||||||
|
|
||||||
|
|
||||||
@ -1694,9 +1711,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".
|
||||||
|
|
||||||
|
|
||||||
@ -1724,12 +1741,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1848,12 +1865,12 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mif_xmms2_connected0m
|
1mif_xmms2_connected0m
|
||||||
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_id0m
|
1meve api_userid api_key character_id0m
|
||||||
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.
|
||||||
|
|
||||||
@ -1872,13 +1889,13 @@ conky(1) conky(1)
|
|||||||
1mBUGS0m
|
1mBUGS0m
|
||||||
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 ALSO0m
|
1mSEE ALSO0m
|
||||||
@ -1889,11 +1906,11 @@ conky(1) conky(1)
|
|||||||
#conky on irc.freenode.net
|
#conky on irc.freenode.net
|
||||||
|
|
||||||
1mCOPYING0m
|
1mCOPYING0m
|
||||||
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).
|
||||||
|
|
||||||
1mAUTHORS0m
|
1mAUTHORS0m
|
||||||
@ -1901,4 +1918,4 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
2008-12-07 conky(1)
|
2009-03-15 conky(1)
|
||||||
|
|||||||
14
doc/conky.1
14
doc/conky.1
@ -5,7 +5,7 @@
|
|||||||
\\$2 \(la\\$1\(ra\\$3
|
\\$2 \(la\\$1\(ra\\$3
|
||||||
..
|
..
|
||||||
.if \n(.g .mso www.tmac
|
.if \n(.g .mso www.tmac
|
||||||
.TH conky 1 2008-12-07 "" ""
|
.TH conky 1 2009-03-15 "" ""
|
||||||
.SH NAME
|
.SH NAME
|
||||||
conky \- A system monitor for X originally based on the torsmo code, but more kickass. It just keeps on given'er. Yeah.
|
conky \- A system monitor for X originally based on the torsmo code, but more kickass. It just keeps on given'er. Yeah.
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
@ -610,6 +610,10 @@ CPU usage in percents. For SMP machines, the CPU number can be provided as an ar
|
|||||||
\fB\*(T<\fBcpubar\fR\*(T>\fR \*(T<\fB(cpu number) (height),(width)\fR\*(T>
|
\fB\*(T<\fBcpubar\fR\*(T>\fR \*(T<\fB(cpu number) (height),(width)\fR\*(T>
|
||||||
Bar that shows CPU usage, height is bar's height in pixels. See $cpu for more info on SMP.
|
Bar that shows CPU usage, height is bar's height in pixels. See $cpu for more info on SMP.
|
||||||
|
|
||||||
|
.TP
|
||||||
|
\fB\*(T<\fBcpugauge\fR\*(T>\fR \*(T<\fB(cpu number) (height),(width)\fR\*(T>
|
||||||
|
Elliptical gauge that shows CPU usage, height and width are gauge's vertical and horizontal axis respectively. See $cpu for more info on SMP.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\*(T<\fBcpugraph\fR\*(T>\fR \*(T<\fB("normal"|"log") (height),(width) (gradient colour 1) (gradient colour 2) (scale) (cpu number)\fR\*(T>
|
\fB\*(T<\fBcpugraph\fR\*(T>\fR \*(T<\fB("normal"|"log") (height),(width) (gradient colour 1) (gradient colour 2) (scale) (cpu number)\fR\*(T>
|
||||||
CPU usage graph, with optional colours in hex, minus the #. See $cpu for more info on SMP. Uses a logarithmic scale (to see small numbers) when you use "log" instead of "normal".
|
CPU usage graph, with optional colours in hex, minus the #. See $cpu for more info on SMP. Uses a logarithmic scale (to see small numbers) when you use "log" instead of "normal".
|
||||||
@ -678,6 +682,10 @@ Executes a shell command and displays the output in conky. warning: this takes a
|
|||||||
\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 the bar is currently fixed, but that may change in the future.
|
||||||
|
|
||||||
|
.TP
|
||||||
|
\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.
|
||||||
|
|
||||||
.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.
|
||||||
@ -1030,6 +1038,10 @@ Amount of memory in use
|
|||||||
\fB\*(T<\fBmembar\fR\*(T>\fR \*(T<\fB(height),(width)\fR\*(T>
|
\fB\*(T<\fBmembar\fR\*(T>\fR \*(T<\fB(height),(width)\fR\*(T>
|
||||||
Bar that shows amount of memory in use
|
Bar that shows amount of memory in use
|
||||||
|
|
||||||
|
.TP
|
||||||
|
\fB\*(T<\fBmemgauge\fR\*(T>\fR \*(T<\fB(height),(width)\fR\*(T>
|
||||||
|
Gauge that shows amount of memory in use (see cpugauge)
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\*(T<\fBmemgraph\fR\*(T>\fR \*(T<\fB("normal"|"log") (height),(width) (gradient colour 1) (gradient colour 2) (scale)\fR\*(T>
|
\fB\*(T<\fBmemgraph\fR\*(T>\fR \*(T<\fB("normal"|"log") (height),(width) (gradient colour 1) (gradient colour 2) (scale)\fR\*(T>
|
||||||
Memory usage graph. Uses a logarithmic scale (to see small numbers) when you use "log" instead of "normal".
|
Memory usage graph. Uses a logarithmic scale (to see small numbers) when you use "log" instead of "normal".
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user