conky中文文档

Conky中文文档v2.0制作：wtry原著：canghaiwuhen2010-7-14安装一些常用linux版本的安装方法：gentoo-emergaapp-admin/conkydebian/ubuntu-apt-getinstallconky或者aptitudeinstallconkyarchlinux-pacman-Sconky或者yaourt-Sconky编译安装方法为：下载源码解压然后进入解压目录shautogen.sh./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-xftmakemakeinstallsrc/conky选项命令行下启动conky时可用的选项conky[options]-v|-V|--version显示版本并退出-q|--quietquiet模式运行conky也就是无输出-D|--debugdebug模式运行conky会显示更详细的输出-a|--alignment=ALIGNMENT自定义conky的显示位置{top,bottom,middle}_{left,right,middle}比如top_right.-b|--double-buffer双缓冲模式(消除闪烁)-c|--config=FILE自定义加载配置文件-C|--print-config显示默认配置文件-v参数显示的信息中有该文件位置-d|--daemonize后台保护conky进程-f|--font=FONT自定义使用的字体-h|--help显示帮助并退出-o|--own-window在自己窗口运行conky-t|--text=TEXT调用临时TEXT用单引号引起来比如-t'$uptime'-u|--interval=SECONDS自定义刷新时间-w|--window-id=WIN_ID定义窗口ID-X|--display=DISPLAY使用X11显示-xX_COORDINATEX轴位置-yY_COORDINATEY轴位置-iCOUNT定义刷新次数完成该次数后退出关闭conky用的命令为killallconky重启conky用的命令为killall-SIGUSR1conky配置配置文件位于$HOME/.conkyrc或者${sysconfdir}/conky/conky.conf示例文件/etc/conky/conky.conf在可以找到很多配置文件TEXT启动以后显示比如主机名内核用户那些所用的文本也就是配置文件的主体部分alias创建变量第一个参数是新名称第二个是老名称其他的参数都是传递给变量的比如以$yun代替${yunsifeng}应写成aliasyunyunsifeng注意这仅仅只是创建一个别名你也可以用环境变量在开始的时候写明yun=yunsifengalignment屏幕中的位置可以是top_left,top_right,top_middle,bottom_left,bottom_right,bottom_middle,middle_left,middle_right也可以缩写为tl,tr,tm,bl,br,bm,ml,mr也可以不设置直接看gap_x和gap_yappend_file附加文件作为注释background是否嵌入背景这是布尔值真则为嵌入假则不嵌入border_margin边框周边的空白以像素为单位border_width边框线的宽度以像素为单位colorN预先定义TEXT中使用的颜色N是从0到9的数字当以颜色以十六进制表示的时候可以省略开头的#cpu_avg_samplescpu数据监测模式一般选2default_bar_size默认进度条的宽度和高度例如：default_bar_size06注意前面的是宽度这对于没有具体大小参数的执行程序的进度条(execbar和execibar)很有用default_color默认颜色default_gauge_size仪表显示用的仪表(样式类似汽车的仪表盘)的宽度和高度例如：default_gauge_size2525这对于没有具体大小参数的执行程序的显示仪表(execgauge和execigauge)很有用default_graph_size频谱显示用的框图的宽度和高度例如：default_graph_size025这对于没有具体大小参数的执行程序的监测表(execgraph和execigraph)很有用default_outline_color默认边框外缘的颜色default_shade_color默认阴影颜色和边界的阴影颜色diskio_avg_samples硬盘输入输出监测displayX窗口的连接double_buffer消除闪烁需要own_window支持draw_borders创建字体边框draw_graph_borders创建图形边框draw_outline创建边缘draw_shades创建阴影font字体设置可以用xfontsel选择你喜欢的gap_x与屏幕左右边界的距离以像素为单位gap_y与屏幕上下边界的距离以像素为单位if_up_strictness监视端口比如上传连接分配的ip地址imap默认IMAP服务器参数为：hostuserpass[-iinterval(inseconds)][-ffolder][-pport][-ecommand][-rretries]默认端口143默认文件夹INBOX默认时间间隔5分钟默认重试次数5如果设置了密码启动conky时会提示输入密码imlib_cache_sizeMLIB2图像缓存大小单位为字节默认用$image设置参数设置为0禁用图像缓存lua_load加载lua脚本用空格分隔mail_spool邮件检查max_port_monitor_connections监视的最大端口连接数默认256max_specials特殊选项的最大数比如字体偏移默认512max_user_textbytes用户文本缓冲区的大小也就是TEXT部分的大小默认16384字节maximum_width(height)pixels窗口最大宽度(高度)单位为像素minimum_sizewidth(height)窗口最小宽度(高度)单位为像素mpd_hostMPD服务器地址mpd_passwordMPD服务器密码mpd_portMPD服务器端口music_player_interval音乐播放器线程刷新时间间隔（默认为Conky的刷新间隔）net_avg_samples网络传输平均数据监测no_buffers从内存中清除文件系统缓冲区out_to_console输出文本到标准输入也就是终端out_to_stderr输出文本到错误输入out_to_x设置为no将不会有任何输出在X(和out_to_console差不多)如果设置为no必须确认这是位于所有其他的X相关的设置之前(以第一条的configfile为准)默认yesoverride_utf8_locale强制uft8编码需要xft支持overwrite_file覆写文件作为注释own_window布尔值创建自主窗口own_window_class手动设置WM_CLASS名称默认为Conkyown_window_colour如果窗口不透明则需设置颜色默认为黑参数为十六进制颜色或者RGB颜色名字(/usr/share/X11/rgb.txt)own_window_hints参数为undecorated,below,above,sticky,skip_taskbarskip_pager如果own_windows为yes就能用这个得到conky窗口提示注意如果用了own_window_type窗口提示就会被忽略own_window_title手动设置窗口的名称默认为hostname-conkyown_window_transparent布尔值窗口是否透明own_window_type如果own_window为yes可以指定窗口样式为normal,desktop,dock或者override默认为nomaldesktop是指没有装饰置顶不显示在pager和taskbar上出现在所有workspace上的的特殊窗口override指的是不在控制之下的窗口会忽略提示某些时候很有用pad_percents小数的百分比形式0没有百分比形式pop3默认POP3服务器参数为hostuserpass[-iinterval(inseconds)][-pport][-ecommand][-rretries]默认端口110默认时间间隔5分钟默认重复次数5次如果设有密码启动conky的时候会提示输入short_units缩写单位字符比如kib-kGib-G默认为offshow_graph_range频谱图的时间范围show_graph_scale频谱图显示最大数值stippled_borders虚线框单位像素temperature_unit期望输出电脑的所有器件显示温度参数是fahrenheit(华氏)或celsius(摄氏)默认的单位是摄氏度templateN为后面TEXT中的使用定义一个模板N为0到9的数字TEXT中的一些转义:'\n'-换行'\\'-下划线'\'-空格'\N'-模板参数Ntext_buffer_sizebytes标准文本缓冲区的大小默认256字节增大缓冲区会降低conky的性能但会增加显示的文本的数量设置的大小不能小于默认的256字节top_cpu_separate设为trueCPU的上方显示一个在使用处理器的功率设为falseCPU的上方显示在使用的所有处理器的功率总和top_name_width顶端名字$top的宽度默认15字节total_run_timesconky运行的次数指刷新的次数0为永远运行update_interval刷新的间隔时间单位为秒间隔时间越长系统负担越轻监控实时性越差uppercase大写变换设置为true输出的所有字母变大写use_spacer增加部件周围的空间阻止它们移动到别的周边参数有left,right和none(默认的)注意这只是使用等宽字体是需要的比如BitstreamVeraSansMonouse_xft使用xft反锯齿(anti-aliasedfont和stuff)xftalphaxft字体的开头必须是一个数值或者0和1xftfont使用xft字体函数颜色一般用的是十六进制参数可以看/usr/share/X11/rgb.txt也可以直接对照使用ACPI的话显示的AC适配器acpifan使用ACPI的话显示风扇状态acpitemp使用ACPI的话显示cpu的摄氏温度addrinterfaceIP地址如果没分配则NoAddressaddrsinterfaceIP地址(如果分配了地址就合addr一样)仅在linux下有效adt746xcpuCPU温度得自therm_adt746xadt746xfan风扇速度得自therm_adt746xalignc(num)文本中心对齐alignr(num)文本右对齐apcupsdhostport建立连接ap