mirror of
https://github.com/Llewellynvdm/conky.git
synced 2024-12-27 04:32:55 +00:00
update README and manpage
This commit is contained in:
parent
72e217fae2
commit
ecabc1a29b
253
README
253
README
@ -1042,18 +1042,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.
|
resets when the highest UPDATENR is reached. Example :
|
||||||
Example : "{$if_updatenr 1}foo$endif{$if_updatenr 2}bar$endif
|
"{$if_updatenr 1}foo$endif{$if_updatenr 2}bar$endif{$if_updatenr
|
||||||
{$if_updatenr 4}$endif" shows foo 25% of the time followed by
|
4}$endif" shows foo 25% of the time followed by bar 25% of the
|
||||||
bar 25% of the time followed by nothing the other half of the
|
time followed by nothing the other half of the time.
|
||||||
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‐
|
||||||
@ -1072,7 +1071,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")
|
||||||
|
|
||||||
|
|
||||||
@ -1090,8 +1089,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".
|
||||||
|
|
||||||
|
|
||||||
@ -1104,9 +1103,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1116,32 +1115,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1152,33 +1151,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"}
|
||||||
|
|
||||||
|
|
||||||
@ -1189,14 +1188,14 @@ 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
|
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)
|
||||||
|
|
||||||
|
|
||||||
@ -1212,39 +1211,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1366,12 +1365,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1380,8 +1379,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
|
||||||
@ -1399,25 +1398,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1432,13 +1431,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1456,14 +1455,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").
|
||||||
|
|
||||||
@ -1473,35 +1472,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.
|
||||||
|
|
||||||
@ -1546,36 +1545,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1584,8 +1583,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1600,14 +1599,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:
|
||||||
@ -1616,7 +1615,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:
|
||||||
|
|
||||||
@ -1629,7 +1628,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
|
||||||
|
|
||||||
|
|
||||||
@ -1638,23 +1637,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1663,7 +1662,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
|
||||||
|
|
||||||
|
|
||||||
@ -1685,9 +1684,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".
|
||||||
|
|
||||||
|
|
||||||
@ -1715,12 +1714,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.
|
||||||
|
|
||||||
|
|
||||||
@ -1839,12 +1838,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.
|
||||||
|
|
||||||
@ -1863,13 +1862,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
|
||||||
@ -1880,11 +1879,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
|
||||||
|
@ -909,7 +909,11 @@ if INTERFACE exists and is up, display everything between $if_up and the matchin
|
|||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\*(T<\fBif_updatenr\fR\*(T>\fR \*(T<\fB(updatenr)\fR\*(T>
|
\fB\*(T<\fBif_updatenr\fR\*(T>\fR \*(T<\fB(updatenr)\fR\*(T>
|
||||||
If it's the UPDATENR-th time that conky updates, display everything between $if_updatenr and the matching $endif. The counter resets when the highest UPDATENR is reached. Example : "{$if_updatenr 1}foo$endif{$if_updatenr 2}bar$endif{$if_updatenr 4}$endif" shows foo 25% of the time followed by bar 25% of the time followed by nothing the other half of the time.
|
If it's the UPDATENR-th time that conky updates,
|
||||||
|
display everything between $if_updatenr and the matching $endif.
|
||||||
|
The counter resets when the highest UPDATENR is reached.
|
||||||
|
Example : "{$if_updatenr 1}foo$endif{$if_updatenr 2}bar$endif{$if_updatenr 4}$endif"
|
||||||
|
shows foo 25% of the time followed by bar 25% of the time followed by nothing the other half of the time.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\*(T<\fBimap_messages\fR\*(T>\fR \*(T<\fB(args)\fR\*(T>
|
\fB\*(T<\fBimap_messages\fR\*(T>\fR \*(T<\fB(args)\fR\*(T>
|
||||||
|
Loading…
Reference in New Issue
Block a user