名称

conky - 最初基于躯干代码的X系统监视器,但更多的kickass。它只是继续给予它。是啊。



概要



conky [ options



描述

Conky是最初基于torsmo的X系统监视器。自成立以来,Conky已经与其前身发生了显着变化,同时保持了简洁性和可配置性。Conky可以在您的根桌面或自己的窗口中显示任何内容。Conky不仅有许多内置对象,它还可以通过脚本和其他外部程序显示任何信息。

Conky拥有超过250个内置对象,包括支持过多的操作系统统计数据(uname,正常运行时间,CPU使用率,内存使用情况,磁盘使用率,“顶级”,如进程统计数据和网络监控,仅举几例),内置在IMAP和POP3的支持下,内置支持许多流行音乐播放器(MPD,XMMS2,BMPx,Audacious)等等。Conky可以将这些信息显示为文本,或使用简单的进度条和图形小部件,以及不同的字体和颜色。

我们一直在寻求帮助,无论是报告错误,编写补丁还是编写文档。如果您有任何疑问或想要贡献,请使用SourceForge上的工具来制作错误报告,功能请求和提交补丁,或者通过irc.freenode.net上的#conky停止。

感谢您对Conky的兴趣。



编译

对于从二进制发行版上的源代码编译的用户,请确保安装了X开发库(除非您使用“--disable-x11”提供configure)。对于X11库,这应该是“libx11-dev”或“xorg-x11-dev”的包,对于其他所需的库,它应该是类似的“-dev”格式(取决于你的配置选项)。您应该能够通过阅读从“./configure”获得的错误来查看需要安装的额外软件包。您可以通过提供配置选项来启用/禁用内容,但要小心禁用。例如:使用--disable-math,您将不会出现错误,但对数图将是正常的图形,并且仪表将错过它们的线。

Conky已经(在一段时间内)可以在最流行的发行版的存储库中使用。以下是一些安装说明:

Gentoo用户 - Conky在Gentoo的Portage中......只需使用“emerge app-admin / conky”进行安装。

Debian等用户 - Conky应该在您的存储库中,并且可以通过“aptitude install conky”来安装。

使用所有可选组件编译和运行Conky的示例(请注意,某些配置选项可能因系统而异):



sh autogen.sh # Only required if building from the git repo ./configure --prefix=/usr --mandir=/usr/share/man --infodir=/usr/share/info --datadir=/usr/share --sysconfdir=/etc --localstatedir=/var/lib --disable-own-window --enable-audacious[=yes|no|legacy] --enable-bmpx --disable-hddtemp --disable-mpd --enable-xmms2 --disable-portmon --disable-network --enable-debug --disable-x11 --disable-double-buffer --disable-xdamage --disable-xft make make install # Optional src/conky



Conky已经过测试,可以与C99 C兼容,但是它没有经过gcc以外的任何测试,并且不能保证与其他编译器一起使用。

 



你应该知道

Conky通常对资源非常好。也就是说,你尝试使Conky做的越多,它将消耗的资源就越多。

迫使Conky重新加载〜/ .conkyrc的简单方法:“killall -SIGUSR1 conky”。为您省去必须杀死然后重新启动的麻烦。您现在也可以使用SIGHUP执行相同的操作。



选项

命令行选项会覆盖配置文件中定义的配置。



-v | -V | --version

 


-q | --quiet


 


-D | --debug


 


-a | --alignment= ALIGNMENT


 


-b | --double-buffer


 


-c | --config= FILE


 


-C | --print-config


 


-d | --daemonize


 


-f | --font= FONT


 


-h | --help


 


-o | --own-window


 


-t | --text= TEXT


 


-p | --pause= SECONDS


 


-u | --interval= SECONDS


 


-w | --window-id= WIN_ID


 


-X | --display= DISPLAY


 


-x X_COORDINATE


 


-y Y_COORDINATE


 


-i COUNT


 



配置设置

默认配置文件位置是$ HOME / .conkyrc或$ {sysconfdir} /conky/conky.conf。在大多数系统上,sysconfdir是/ etc,你可以在那里找到示例配置文件(/etc/conky/conky.conf)。

您可能希望将其复制到$ HOME / .conkyrc,然后开始修改它。其他配置可以在http://conky.sf.net/找到



TEXT

 


alignment


 


append_file


 


background


 


border_inner_margin


 


border_outer_margin


 


border_width


 


colorN


 


cpu_avg_samples


 


default_bar_size


 


default_color


 


default_gauge_size


 


default_graph_size


 


default_outline_color


 


default_shade_color


 


disable_auto_reload


 


diskio_avg_samples


 


display


 


double_buffer


 


draw_borders


 


draw_graph_borders


 


draw_outline


 


draw_shades


 


extra_newline


 


font


 


format_human_readable


 


gap_x


 


gap_y


 


hddtemp_host


 


hddtemp_port


 


if_up_strictness


 


imap


 


imlib_cache_flush_interval


 


imlib_cache_size


 


lua_draw_hook_post function_name [function arguments]


 


lua_draw_hook_pre function_name [function arguments]


 


lua_load


 


lua_shutdown_hook function_name [function arguments]


 


lua_startup_hook function_name [function arguments]


 


mail_spool


 


max_port_monitor_connections


 


max_specials


 


max_text_width width


 


max_user_text bytes


 


maximum_width pixels


 


minimum_size width (height)


 


mpd_host


 


mpd_password


 


mpd_port


 


music_player_interval


 


net_avg_samples


 


no_buffers


 


nvidia_display


 


out_to_console


 


out_to_ncurses


 


out_to_stderr


 


out_to_x


 


override_utf8_locale


 


overwrite_file


 


own_window


 


own_window_class


 


own_window_colour colour


 


own_window_hints undecorated,below,above,sticky,skip_taskbar,skip_pager


 


own_window_title


 


own_window_argb_visual


 


own_window_argb_value


 


own_window_transparent


 


own_window_type


 


pad_percents


 


pop3


 


short_units


 


show_graph_range


 


show_graph_scale


 


stippled_borders


 


temperature_unit


 


templateN


'\ n' - >换行符

'\\' - >反斜杠

'\' - >空间

'\ N' - >模板参数N.

 


text_buffer_size bytes


 


times_in_seconds


 


top_cpu_separate


 


top_name_width


 


total_run_times


 


update_interval seconds


 


update_interval_on_battery seconds


 


uppercase


 


use_spacer


 


use_xft


 


xftalpha


 


xftfont


 



对象/变量

使用XParsecolor()解析颜色,可能有一个列表:/usr/share/X11/rgb.txt。颜色也可以是#rrggbb格式(十六进制)。

有些对象可能会创建线程,有时这些线程在Conky终止之前不会被销毁。在Conky运行时无法销毁或清理线程。例如,如果使用MPD变量,MPD线程将继续运行,直到Conky死亡。一些线程对象将使用其中一个参数作为“键”,因此您只有一个相关的线程在运行(例如,$ curl,$ rss和$ weather对象为每个URI启动一个线程)。



acpiacadapter (adapter)

 


acpifan


 


acpitemp


 


addr (interface)


 


addrs (interface)


 


adt746xcpu


 


adt746xfan


 


alignc (num)


 


alignr (num)


 


apcupsd host port


 


apcupsd_cable


 


apcupsd_charge


 


apcupsd_lastxfer


 


apcupsd_linev


 


apcupsd_load


 


apcupsd_loadbar


 


apcupsd_loadgauge (height),(width)


 


apcupsd_loadgraph (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l)


 


apcupsd_model


 


apcupsd_name


 


apcupsd_status


 


apcupsd_temp


 


apcupsd_timeleft


 


apcupsd_upsmode


 


apm_adapter


 


apm_battery_life


 


apm_battery_time


 


audacious_bar (height),(width)


 


audacious_bitrate


 


audacious_channels


 


audacious_filename


 


audacious_frequency


 


audacious_length


 


audacious_length_seconds


 


audacious_main_volume


 


audacious_playlist_length


 


audacious_playlist_position


 


audacious_position


 


audacious_position_seconds


 


audacious_status


 


audacious_title (max length)


 


battery (num)


 


battery_bar (height),(width) (num)


 


battery_percent (num)


 


battery_short (num)


 


battery_time (num)


 


blink text_and_other_conky_vars


 


bmpx_album


 


bmpx_artist


 


bmpx_bitrate


 


bmpx_title


 


bmpx_track


 


bmpx_uri


 


buffers


 


cached


 


cmdline_to_pid string


 


color (color)


 


colorN


 


combine var1 var2


 


conky_build_arch


 


conky_build_date


 


conky_version


 


cpu (cpuN)


 


cpubar (cpuN) (height),(width)


 


cpugauge (cpuN) (height),(width)


 


cpugraph (cpuN) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l)


 


curl url (interval_in_minutes)


使用Curl以指定的时间间隔从URI下载数据。间隔可以是大于0的浮点值,否则默认为15分钟。与Lua和Lua API一起使用时最有用。该对象是线程化的,一旦创建了一个线程,就无法显式地销毁它。将为指定的每个URI运行一个线程。您可以使用Curl支持的任何协议。


desktop


 


desktop_name


 


desktop_number


 


disk_protect device


 


diskio (device)


 


diskio_read (device)


 


diskio_write (device)


 


diskiograph (device) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l)


 


diskiograph_read (device) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l)


 


diskiograph_write (device) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l)


 


downspeed (net)


 


downspeedf (net)


 


downspeedgraph (netdev) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l)


 


draft_mails (maildir) (interval)


 


else


 


endif


 


entropy_avail


 


entropy_bar (height),(width)


 


entropy_perc


 


entropy_poolsize


 


eval string


 


eve api_userid api_key character_id


 


exec command


 


execbar command


 


execgauge command


 


execgraph (-t) (-l) command


 


execi interval command


 


execibar interval command


 


execigauge interval command


 


execigraph interval (-t) (-l) command


 


execp command


 


execpi interval command


 


flagged_mails (maildir) (interval)


 


font (font)


 


format_time seconds format


 


forwarded_mails (maildir) (interval)


 


freq (n)


 


freq_g (n)


 


fs_bar (height),(width) fs


 


fs_bar_free (height),(width) fs


 


fs_free (fs)


 


fs_free_perc (fs)


 


fs_size (fs)


 


fs_type (fs)


 


fs_used (fs)


 


fs_used_perc (fs)


 


goto x


 


gw_iface


 


gw_ip


 


hddtemp (dev)


 


head logfile lines (next_check)


 


hr (height)


 


hwmon (dev) type n (factor offset)


 


i2c (dev) type n (factor offset)


 


i8k_ac_status


 


i8k_bios


 


i8k_buttons_status


 


i8k_cpu_temp


 


i8k_left_fan_rpm


 


i8k_left_fan_status


 


i8k_right_fan_rpm


 


i8k_right_fan_status


 


i8k_serial


 


i8k_version


 


ibm_brightness


 


ibm_fan


 


ibm_temps N


 


ibm_volume


 


iconv_start codeset_from codeset_to


 


iconv_stop


 


if_empty (var)


 


if_existing file (string)


 


if_gw


 


if_match expression


double参数仅由数字和单个点组成。

long Argument只包含数字。

string参数用引号括起来(“)


有效的操作数是:'>','<','> =','<=','==','!='。

 


if_mixer_mute (mixer)


 


if_mounted (mountpoint)


 


if_mpd_playing


 


if_running (process)


 


if_smapi_bat_installed (INDEX)


 


if_up (interface)


 


if_updatenr (updatenr)


 


if_xmms2_connected


 


image <path to image> (-p x,y) (-s WxH) (-n) (-f interval)


 


imap_messages (args)


 


imap_unseen (args)


 


include path


在路径中加载配置文件,将配置设置置于原始配置中的配置设置后面,并将变量置于包含变量所在的位置。


ioscheduler disk


 


kernel


 


laptop_mode


 


lines textfile


 


loadavg (1|2|3)


 


loadgraph (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l)


 


lua function_name (function parameters)


 


lua_bar (height, width) function_name (function parameters)


 


lua_gauge (height, width) function_name (function parameters)


 


lua_graph function_name (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l)


 


lua_parse function_name (function parameters)


 


machine


 


mails (mailbox) (interval)


 


mboxscan (-n number of messages to print) (-fw from width) (-sw subject width) mbox


 


mem


 


membar (height),(width)


 


memeasyfree


 


memfree


 


memgauge (height),(width)


 


memgraph (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l)


 


memmax


 


memperc


 


mixer (device)


 


mixerbar (device)


 


mixerl (device)


 


mixerlbar (device)


 


mixerr (device)


 


mixerrbar (device)


 


moc_album


 


moc_artist


 


moc_bitrate


 


moc_curtime


 


moc_file


 


moc_rate


 


moc_song


 


moc_state


 


moc_timeleft


 


moc_title


 


moc_totaltime


 


monitor


 


monitor_number


 


mpd_album


 


mpd_artist


 


mpd_bar (height),(width)


 


mpd_bitrate


 


mpd_date


 


mpd_elapsed


 


mpd_file


 


mpd_length


 


mpd_name


 


mpd_percent


 


mpd_random


 


mpd_repeat


 


mpd_smart (max length)


 


mpd_status


 


mpd_title (max length)


 


mpd_track


 


mpd_vol


 


nameserver (index)


 


new_mails (mailbox) (interval)


 


nodename


 


nodename_short


 


nvidia threshold temp ambient gpufreq memfreq imagequality


 The thresholdtemperature at which the gpu slows down

温度 Gives the gpu current temperature

周围 Gives current air temperature near GPU case

gpufreq Gives the current gpu frequency

memfreq Gives the current mem frequency

画面质量 Which imagequality should be chosen by OpenGL applications

 


offset (pixels)


 


outlinecolor (color)


 


pb_battery item


状态 Display if battery is fully charged, charging, discharging or absent (running on AC)

百分 Display charge of battery in percent, if charging or discharging. Nothing will be displayed, if battery is fully charged or absent.

时间 Display the time remaining until the battery will be fully charged or discharged at current rate. Nothing is displayed, if battery is absent or if it's present but fully charged and not discharging.

 


pid_chroot pid


 


pid_cmdline pid


 


pid_cwd pid


 


pid_environ pid varname


 


pid_environ_list pid


 


pid_exe pid


 


pid_nice pid


 


pid_openfiles pid


 


pid_parent pid


 


pid_priority pid


 


pid_read pid


 


pid_state pid


 


pid_state_short pid


 


pid_stderr pid


 


pid_stdin pid


 


pid_stdout pid


 


pid_threads pid


 


pid_thread_list pid


 


pid_time_kernelmode pid


 


pid_time_usermode pid


 


pid_time pid


 


pid_uid pid


 


pid_euid pid


 


pid_suid pid


 


pid_fsuid pid


 


pid_gid pid


 


pid_egid pid


 


pid_sgid pid


 


pid_fsgid pid


 


pid_vmpeak pid


 


pid_vmsize pid


 


pid_vmlck pid


 


pid_vmhwm pid


 


pid_vmrss pid


 


pid_vmdata pid


 


pid_vmstk pid


 


pid_vmexe pid


 


pid_vmlib pid


 


pid_vmpte pid


 


pid_write pid


 


platform (dev) type n (factor offset)


 


pop3_unseen (args)


 


pop3_used (args)


 


pre_exec shell command


 


processes


 


read_tcp (host) port


 


replied_mails (maildir) (interval)


 


rss uri interval_in_minutes action (num_par (spaces_in_front))


下载并解析RSS源。间隔可以是大于0的浮点值,否则默认为15分钟。动作可以是以下之一:feed_title,item_title(具有num par),item_desc(具有num par)和item_titles(当使用此动作时,spaces_in_front被赋予了每个项目前面的许多空格的可靠位置)。该对象是线程化的,一旦创建了一个线程,就无法显式地销毁它。将为指定的每个URI运行一个线程。您可以使用Curl支持的任何协议。


running_processes


 


running_threads


 


scroll length (step) text


 


seen_mails (maildir) (interval)


 


shadecolor (color)


 


smapi (ARGS)


 


smapi_bat_bar (INDEX),(height),(width)


 


smapi_bat_perc (INDEX)


 


smapi_bat_power INDEX


 


smapi_bat_temp INDEX


 


sony_fanspeed


 


stippled_hr (space)


 


swap


 


swapbar (height),(width)


 


swapfree


 


swapmax


 


swapperc


 


sysname


 


tab (width, (start))


 


tail logfile lines (next_check)


 


tcp_portmon port_begin port_end item (index)


TCP端口(IPv6和IPv4)监视指定的本地端口。端口号必须在1到65535之间。有效的项目是:

计数 Total number of connections in the range

RIP Remote ip address

rhost的 Remote host name

RPORT Remote port number

rservice Remote service name from /etc/services

 Local ip address

lhost Local host name

学习端口 Local port number

lservice Local service name from /etc/services

连接索引使您可以访问端口监视器中的每个连接。监视器将返回从0到n-1个连接的索引值的信息。高于n-1的值将被忽略。对于“count”项,必须省略连接索引。所有其他物品都需要它。

例子:

$ {tcp_portmon 6881 6999 count} Displays the number of connections in the bittorrent port range

$ {tcp_portmon 22 22 rip 0} Displays the remote host ip of the first sshd connection

$ {tcp_portmon 22 22 rip 9} Displays the remote host ip of the tenth sshd connection

$ {tcp_portmon 1 1024 rhost 0} Displays the remote host name of the first connection on a privileged port

$ {tcp_portmon 1 1024 rport 4} Displays the remote host port of the fifth connection on a privileged port

$ {tcp_portmon 1 65535 lservice 14} Displays the local service name of the fifteenth connection in the range of all ports

请注意,共享相同端口范围的端口监视器变量实际上是指同一个监视器,因此对不同项目和不同索引的单个端口范围的许多引用都在内部使用相同的监视器。换句话说,该程序避免创建冗余监视器。


templateN (arg1) (arg2) (arg3 ...)


评估templateN配置变量的内容(其中N是介于0和9之间的值,包括),应用相应配置变量文档中描述的替换。参数的数量是可选的,但必须与模板中最高的引用索引匹配。您可以在每个参数中使用与模板定义相同的特殊序列,例如,允许参数包含空格。这种方式也可以简单地嵌套模板。

以下是模板定义的一些示例:

template0 $ \ 1 \ 2

template1 \ 1:$ {fs_used \ 2} / $ {fs_size \ 2}

template2 \ 1 \ 2

以下列表显示了上面定义的模板的示例用法,以及完全不使用任何模板时的等效语法:



表格1。 



使用模板

同样没有模板

$ {template0节点名称}

$节点名称

$ {template1 root /}

root:$ {fs_free /} / $ {fs_size /}

$ {template1 $ {template2 \ disk \ root} /}

磁盘根:$ {fs_free /} / $ {fs_size /}


texeci interval command


 


threads


 


time (format)


 


to_bytes size


 


top type num


 


top_io type num


 


top_mem type num


 


top_time type num


 


totaldown (net)


 


totalup (net)


 


trashed_mails (maildir) (interval)


 


tztime (timezone (format))


 


gid_name gid


 


uid_name uid


 


unflagged_mails (maildir) (interval)


 


unforwarded_mails (maildir) (interval)


 


unreplied_mails (maildir) (interval)


 


unseen_mails (maildir) (interval)


 


updates Number of updates


 


upspeed (net)


 


upspeedf (net)


 


upspeedgraph (netdev) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (-t) (-l)


 


uptime


 


uptime_short


 


user_names


 


user_number


 


user_terms


 


user_times


 


user_time console


 


utime (format)


 


voffset (pixels)


 


voltage_mv (n)


 


voltage_v (n)


 


weather URI locID data_type (interval_in_minutes)


下载,解析和显示METAR数据。

对于'URI',有两种可能性:

http://weather.noaa.gov/pub/data/observations/metar/stations/

http://xoap.weather.com/weather/local/

第一个是免费使用,但第二个需要您注册并获取您的合作伙伴ID和许可证密钥。必须将这两个空格分隔成一个名为.xoaprc的文件,该文件需要放在您的主目录中。

'locID'必须是所需uri的有效位置标识符。对于NOAA网站,这必须是有效的ICAO(例如参见https://pilotweb.nas.faa.gov/qryhtml/icao/)。对于weather.com网站,这必须是有效的位置ID(例如参见http://aspnetresources.com/tools/locid.aspx)。

'data_type'必须是以下之一:

最后更新

数据的日期和时间戳。结果取决于使用的URI。对于NOAA站点,它是日期(yyyy / mm / dd)和UTC时间。对于weather.com,它是日期([m] m / [d] d / yy)和电台的本地时间。

温度

空气温度(您可以使用'temperature_unit'配置设置更改单位)

cloud_cover

最高云覆盖状态

压力

毫巴的气压

风速

风速以km / h为单位

wind_dir

风向

wind_dir_DEG

指南针风向

湿度

相对湿度%

天气

任何相关的天气事件(下雨,下雪等)。如果您要查询weather.com网站,则不会使用此方法,因为此数据已汇总到cloud_cover网站中

图标

天气图标(仅适用于www.weather.com)。可以与注册到他们服务时提供的图标工具包一起使用。

'delay_in_minutes'(可选,默认为30)不能少于30分钟。

该对象是线程化的,一旦创建了一个线程,就无法显式地销毁它。将为指定的每个URI运行一个线程。

请注意,这些变量仍然是实验性的,可能会受到许多未来的变化。


weather_forecast URI locID day data_type (interval_in_minutes)


下载,解析和显示特定日期的天气预报数据(仅限白天)。

对于'URI',暂时只支持http://xoap.weather.com/weather/local/。有关使用详情,请参阅上面的“天气”

'locID',见上面的'天气'。

'day'是从0(今天)到4(3天后)的数字。

'data_type'必须是以下之一:

 Day of the week

日期 Date, in the form MMM DD (ie. Jul 14)

 Minimun temperature (you can use the 'temperature_unit' config setting to change units)

 Maximum temperature (you can use the 'temperature_unit' config setting to change units)

图标 Weather icon. Can be used together with the icon kit provided upon registering to the weather.com service

预测 Weather forecast (sunny, rainy, etc.)

风速 Wind speed in km/h

wind_dir Wind direction

wind_dir_DEG Compass wind direction

湿度 Relative humidity in %

沉淀 Probability of having a precipitation (in %)

'delay_in_minutes'(可选,默认为210)不能低于210分钟。

该对象是线程化的,一旦创建了一个线程,就无法显式地销毁它。将为指定的每个URI运行一个线程。您可以使用Curl支持的任何协议。

请注意,这些变量仍然是实验性的,可能会受到许多未来的变化。


wireless_ap (net)


 


wireless_bitrate (net)


 


wireless_essid (net)


 


wireless_link_bar (height),(width) (net)


 


wireless_link_qual (net)


 


wireless_link_qual_max (net)


 


wireless_link_qual_perc (net)


 


wireless_mode (net)


 


words textfile


 


xmms2_album


 


xmms2_artist


 


xmms2_bar (height),(width)


 


xmms2_bitrate


 


xmms2_comment


 


xmms2_date


 


xmms2_duration


 


xmms2_elapsed


 


xmms2_genre


 


xmms2_id


 


xmms2_percent


 


xmms2_playlist


 


xmms2_size


 


xmms2_smart


 


xmms2_status


 


xmms2_timesplayed


 


xmms2_title


 


xmms2_tracknr


 


xmms2_url


 



Lua API

Conky具有Lua编程API,并且还为一些有用的库提供了Lua绑定。Conky定义了可以从Conky中运行的Lua代码访问的某些全局函数和变量。

要使用Lua Conky,首先需要确保你有一个启用了Lua支持的Conky版本(``conky -v''会报告这个)。必须首先使用lua_load配置选项加载脚本。然后你通过Conky的$ lua,$ lua_read和Lua钩子调用Lua中的函数。

通过Lua API创建线程对象时要小心。如果每次迭代都创建一个线程,那么最终可以运行一大堆线程。

此时,Lua API不应该被认为是稳定的,并且随着它的成熟,可能会从一个版本急剧变化到另一个版本。

注意:为了适应cairo库的API中的某些功能,Conky将导出一些额外的功能来创建某些结构。这些记录如下。



conky_parse(string) function

此函数接受一个按照Conky的TEXT部分计算的字符串,然后返回一个包含结果的字符串。


conky_set_update_interval(number) function


将Conky的更新间隔(以秒为单位)设置为“数字”。


conky_window table


此表包含有关Conky窗口的一些信息。下表描述了包含的值:

绘制 Window's drawable (Xlib Drawable), requires Lua extras enabled at compile time.

视觉 Window's visual (Xlib Visual), requires Lua extras enabled at compile time.

显示 Window's display (Xlib Display), requires Lua extras enabled at compile time.

宽度 Window width (in pixels).

高度 Window height (in pixels).

border_inner_margin Window's inner border margin (in pixels).

border_outer_margin Window's outer border margin (in pixels).

BORDER_WIDTH Window's border width (in pixels).

text_start_x The x component of the starting coordinate of text drawing.

text_start_y The y component of the starting coordinate of text drawing.

text_width The width of the text drawing region.

text_height The height of the text drawing region.

注意:此表仅在启用X支持时定义。


conky_info table


该表包含有关Conky内部数据的一些信息。下表描述了包含的值:

更新周期 Conky's update interval (in seconds).

运行时间 System uptime, in seconds.


conky_build_info string


包含此特定Conky实例的构建信息的字符串,包括版本,构建日期和体系结构。


conky_build_date string


包含此特定Conky实例的构建日期的字符串。


conky_build_arch string


包含此特定Conky实例的构建体系结构的字符串。


conky_version string


包含Conky当前实例版本的字符串。


conky_config string


包含当前Conky配置文件路径的字符串。


cairo_text_extents_t:create() function


调用此函数以返回新的cairo_text_extents_t结构。cairo API不提供此结构的创建函数。调用此函数后,您应该对返回值使用tolua.takeownership()以确保正确传递所有权。


cairo_font_extents_t:create() function


调用此函数以返回新的cairo_font_extents_t结构。cairo API不提供此结构的创建函数。调用此函数后,您应该对返回值使用tolua.takeownership()以确保正确传递所有权。


cairo_matrix_t:create() function


调用此函数可返回新的cairo_matrix_t结构。cairo API不提供此结构的创建函数。调用此函数后,您应该对返回值使用tolua.takeownership()以确保正确传递所有权。



例子



conky -t '${time %D %H:%M}' -o -u 30 在自己的窗口中启动Conky,日期和时钟为文本,30秒更新间隔。 conky -a top_left -x 5 -y 500 -d 在坐标(5,500)处开始Conky到背景。 conky -C > ~/.conkyrc 不要启动Conky,但要将内置的默认配置文件输出到〜/ .conkyrc以便以后自定义。





${sysconfdir}/conky/conky.conf 默认的系统范围配置文件。$ {sysconfdir}的值取决于编译时选项(很可能是/ etc)。 ~/.conkyrc 默认的个人配置文件。



错误

直接绘制到root或其他桌面窗口不适用于所有窗口管理器。特别是与Gnome不兼容,据报道它也不适用于KDE。可以使用程序gconf-editor禁用Nautilus从绘图到桌面。取消选中/ apps / nautilus / preferences /中的show_desktop。在Conky中有-w开关来设置一些特定的窗口ID。您可能会发现xwininfo -tree对于查找要绘制的窗口很有用。您还可以使用-o参数使Conky创建自己的窗口。如果您尝试在自己的窗口中运行Conky,请务必阅读own_window_type设置并进行实验。



也可以看看

http://conky.sourceforge.net/

http://www.sourceforge.net/projects/conky

http://wiki.conky.be

irc.freenode.net上的#conky



仿形

版权所有(c)2005-2010 Brenden Matthews,Philip Kovacs等。人。任何原始的躯干代码都是根据BSD许可证授权的(请参阅LICENSE.BSD以获取副本)。自twmo fork以来编写的所有代码都是根据GPL许可的(参见LICENSE.GPL副本),除非另有说明(例如在portmon代码中,定时线程代码和大胆代码是LGPL,而prss是一个MIT式许可证)。



作者

Conky开发团队(请参阅AUTHORS了解完整的贡献者列表)。