diff --git a/README b/README index 9ff82fb0..09cdd11a 100644 --- a/README +++ b/README @@ -2,329 +2,330 @@ WHAT IS CONKY? - Conky is a system monitor for Linux that sits in the corner of your - desktop. Conky renders itself on the root window (on the desktop) or to - its own transparent window any special eyecandy. - Conky can show lots of info about your system, including: - - * kernel version - * uptime - * network interface information - * memory and swap usage - * hostname - * machine, i686 for example - * system name, Linux for example - * temperatures from i2c-sensors + Conky is a system monitor for X originally based on the torsmo code. + Since it's original conception, Conky has changed a fair bit from + it's predecessor. Conky can display just about anything, either on + your root desktop or in it's own window. Conky has many built-in + objects, as well as the ability to execute programs and scripts, + then display the output from stdout. + + We are always looking for help, and anyone interested in becoming + a developer is welcome. Please use the facilities at SourceForge + to make bug reports, feature requests, and submit patches. + + Thanks for your interest in Conky. THINGS YOU SHOULD KNOW - Conky is generally very good on resources. However, certain objects in - Conky are harder on resources then others. In particular, the $tail and - $top objects are quite costly in comparison to the rest of Conky. - If you do use them, please do not complain about memory or CPU usage, - because you will simply be ignored. - - With that out of the way, if you have a better way of doing something, - please submit a patch for Conky. I know I am certainly not the world's - best programmer, and I still have a lot to learn. + Conky is generally very good on resources. However, certain objects in + Conky are harder on resources then others. In particular, the $tail, + $top, and $graph objects are quite costly in comparison to the rest of Conky. + If you do use them, please do not complain about memory or CPU usage, + unless you think something is going seriously wrong (mem leak, et cetera). COMPILING - To compile and run Conky with all optional components (If you run Gentoo, see the "Ebuild" Section below): + To compile and run Conky with all optional components (If you run Gentoo, see the "Ebuild" Section below): - ./configure --prefix=/usr --enable-xft --enable-mpd --enable-seti --enable-double-buffer --enable-own-window --enable-proc-uptime - make - ./conky + ./configure --prefix=/usr --enable-xft --enable-mpd --enable-seti --enable-double-buffer --enable-own-window --enable-proc-uptime --enable-metar --enable-mldonkey + make + ./conky - Conky doesn't probably compile with other compilers than gcc and icc. It - doesn't compile with C89 compiler and not even with pure C99. It uses few - things that might not exist: strdup(), strcasecmp(), strncasecmp(), optarg - variable with getopt() and long long (not in C89). Crashes in file system - statistics stuff when compiled with icc, I don't know exactly why. - - You can disable 'drawing to own window' feature in case you don't need it - by passing --disable-own-window to configure -script. + Conky doesn't probably compile with other compilers than gcc and icc. It + doesn't compile with C89 compiler and not even with pure C99. It uses few + things that might not exist: strdup(), strcasecmp(), strncasecmp(), optarg + variable with getopt() and long long (not in C89). Crashes in file system + statistics stuff when compiled with icc, I don't know exactly why. + + You can disable 'drawing to own window' feature in case you don't need it + by passing --disable-own-window to configure -script. EBUILD - Conky is in Gentoo's Portage. Simply use "emerge conky" to install conky. + Conky is in Gentoo's Portage. Simply use "emerge conky" to install conky. + There is also usually an up-to-date ebuild within Conky's package or in + CVS. CONFIGURING - Default configuration file is $HOME/.conkyrc (can be changed from - conky.c among other things). See conkyrc.sample. You might want to copy - it to $HOME/.conkyrc and then start modifying it. - - Configuration file confs - - Conf Meaning - alignment Aligned position on screen, may be top_left, - top_right, bottom_left, bottom_right - background Boolean value, if true, Conky will be forked to - background when started - border_margin Border margin in pixels - border_width Border width in pixels - cpu_avg_samples The number of samples to average for CPU monitoring - default_color Default color and border color - default_shade_color Default shading color and border's shading color - default_outline_color Default outline color - Use the Xdbe extension? (eliminates flicker) It is - double_buffer highly recommended to use own window with this one - so double buffer won't be so big. - draw_borders Draw borders around text? - draw_shades Draw shades? - draw_outline Draw outlines? - font Font name in X, xfontsel can be used to get a nice - font - gap_x Gap between right or left border of screen, same as - passing -x at command line - gap_y Gap between top or bottom border of screen, same as - passing -y at command line - no_buffers Substract (file system) buffers from used memory? - mail_spool Mail spool for mail checking - metar_station METAR station code for weather, see - http://www.wrh.noaa.gov/ if you need to find - your code. - metar_server Define a custom METAR ftp server - metar_path Path on server to use - minimum_size Minimum size of window - mldonkey_hostname Hostname for mldonkey stuff, defaults to localhost - mldonkey_port Mldonkey port, 4001 default - mldonkey_login Mldonkey login, default none - mldonkey_password Mldonkey password, default none - net_avg_samples The number of samples to average for net data - override_utf8_locale Force UTF8? requires XFT - own_window Boolean, create own window to draw? - pad_percents Pad percentages to this many decimals (0 = no - padding) - stippled_borders Border stippling (dashing) in pixels - total_run_times Total number of times for Conky to update before - quitting. Zero makes Conky run forever - update_interval Update interval in seconds - uppercase Boolean value, if true, text is rendered in upper - case - use_spacer Adds spaces after certain objects to stop them - from moving other things around. Note that - this only helps if you are using a mono font, - such as Bitstream Vera Sans Mono. - use_xft Use Xft (anti-aliased font and stuff) - text After this begins text to be formatted on screen - - Boolean variable without value in text means yes. Value may be also yes, - true or any negative or positive integer meaning yes. No, false or zero - meaning no. - There may be some variables in text. Variable is given either in format - $variable or in ${variable}. Latter allows characters right after the - variable and must be used in some stuff because of arguments. - - Command line options - - Argument Description - -V Prints version and exits - -a ALIGNMENT Text alignment on screen, {top,bottom}_{left,right} - -b Use double buffering (eliminates flicker) - -c FILE Config file to load instead of $HOME/.conkyrc - -d Daemonize, fork to background - -f FONT Font to use - -h Prints command line help and exits - -o Create own window to draw - -t TEXT Text to render, remember single quotes, like -t '$uptime' - -u SECS Update interval - -w WIN_ID Window id to draw - -x X X position - -y Y Y position - - Command line options override configurations defined in configuration - file. - - Variables in text - - Variable Arguments Description - - addr (interface) IP address for an interface - acpiacadapter ACPI ac adapter state. - acpifan ACPI fan state - acpitemp ACPI temperature. - adt746xcpu CPU temperature from therm_adt746x - adt746xfan Fan speed from therm_adt746x - alignr (num) Right-justify text, with space of N - alignc Align text to centre - battery (num) Remaining capasity in ACPI or APM - battery. ACPI battery number can be - given as argument (default is BAT0). - buffers Amount of memory buffered - cached Amount of memory cached - color (color) Change drawing color to color - cpu CPU usage in percents - cpubar (height) Bar that shows CPU usage, height is - bar's height in pixels - cpugraph (height),(width) (gradient colour 1) (gradient colour 2) - CPU usage graph - downspeed net Download speed in kilobytes - downspeedf net Download speed in kilobytes with one - decimal - downspeedgraph net (height),(width) (gradient colour 1) (gradient colour 2) - Download speed graph - exec shell command Executes a shell command and displays - the output in conky. warning: this - takes a lot more resources than other - variables. I'd recommend coding wanted - behaviour in C and posting a patch :-). - execbar shell command 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. - execgraph shell command Same as execbar, but graphs values - execi interval, shell Same as exec but with specific interval. - command Interval can't be less than - update_interval in configuration. - fs_bar (height), (fs) 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. - fs_free (fs) Free space on a file system available - for users. - fs_free_perc (fs) Free percentage of space on a file - system available for users. - fs_size (fs) File system size - fs_used (fs) File system used space - hr (height) Horizontal line, height is the height in - pixels - i2c (dev), type, n I2C sensor from sysfs (Linux 2.6). dev - may be omitted if you have only one I2C - device. type is either in (or vol) - meaning voltage, fan meaning fan or - temp/tempf (first in C, second in F) - meaning temperature. n is number of the - sensor. See /sys/bus/i2c/devices/ on - your local computer. - if_running (process) if PROCESS is running, display - everything if_running and the matching $endif - if_existing (file) if FILE exists, display everything between - if_existing and the matching $endif - if_mounted (mountpoint) if MOUNTPOINT is mounted, display everything between - if_mounted and the matching $endif - else Text to show if any of the above are not true - kernel Kernel version - linkstatus (interface) Get the link status for wireless connections - loadavg (1), (2), (3) System load average, 1 is for past 1 - minute, 2 for past 5 minutes and 3 for - past 15 minutes. - machine Machine, i686 for example - mails Mail count in mail spool. You can use - program like fetchmail to get mails from - some server using your favourite - protocol. See also new_mails. - mem Amount of memory in use - membar (height) Bar that shows amount of memory in use - memmax Total amount of memory - memperc Percentage of memory in use - - metar_ob_time - metar_temp - metar_tempf Temp in F - metar_windchill - metar_dew_point There are a bunch of these - metar_rh and they are self-explanatory - metar_windspeed - metar_winddir - metar_swinddir - metar_cloud - metar_u2d_time - - ml_upload_counter total session upload in mb - ml_download_counter total session download in mb - ml_nshared_files number of shared files - ml_shared_counter total session shared in mb, buggy - in some mldonkey versions - ml_tcp_upload_rate tcp upload rate in kb/s - ml_tcp_download_rate tcp download rate in kb/s - ml_udp_upload_rate udp upload rate in kb/s - ml_udp_download_rate udp download rate in kb/s - ml_ndownloaded_files number of completed files - ml_ndownloading_files number of downloading files - - mpd_artist Artist in current MPD song - (must be enabled at compile) - mpd_album Album in current MPD song - mpd_bar (height) Bar of mpd's progress - mpd_bitrate Bitrate of current song - mpd_status Playing, stopped, et cetera. - mpd_title Title of current MPD song - mpd_vol MPD's volume - mpd_elapsed Song's elapsed time - mpd_length Song's length - mpd_percent Percent of song's progress - new_mails Unread mail count in mail spool. - nodename Hostname - outlinecolor (color) Change outline color - pre_exec shell command Executes a shell command one time before - conky displays anything and puts output - as text. - processes Total processes (sleeping and running) - running_processes Running processes (not sleeping), - requires Linux 2.6 - shadecolor (color) Change shading color - stippled_hr (space), Stippled (dashed) horizontal line - (height) - swapbar (height) Bar that shows amount of swap in use - swap Amount of swap in use - swapmax Total amount of swap - swapperc Percentage of swap in use - sysname System name, Linux for example - offset pixels Move text over by N pixels - tail logfile, lines (interval) - Displays last N lines of supplied text - text file. If interval is not supplied, - Conky assumes 2x Conky's interval. - Max of 30 lines. - Max of 30 lines can be displayed. - time (format) Local time, see man strftime to get more - information about format - totaldown net 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 already done that before conky - has started. - top type, num This takes arguments in the form: - top - Basically, processes are ranked from - highest to lowest in terms of cpu - usage, which is what represents. - The types are: "name", "pid", "cpu", and - "mem". - There can be a max of 10 processes listed. - top_mem type, num Same as top, except sorted by mem usage - instead of cpu - totalup net Total upload, this one too, may overflow - updates Number of updates (for debugging) - upspeed net Upload speed in kilobytes - upspeedf net Upload speed in kilobytes with one - decimal - upspeedgraph net (height),(width) (gradient colour 1) (gradient colour 2) - Upload speed graph - uptime Uptime - uptime_short Uptime in a shorter format - - seti_prog Seti@home current progress - seti_progbar (height) Seti@home current progress bar - seti_credit Seti@hoome total user credit - - - colors are parsed using XParsecolor(), there might be a list of them: - /usr/X11R6/lib/X11/rgb.txt. color can be also in #rrggbb format (hex). - - Note that when displaying bytes, power is 1024 and not 1000 so 1M really - means 1024*1024 bytes and not 1000*1000. - + Default configuration file is $HOME/.conkyrc (can be changed from + conky.c among other things). See conkyrc.sample. You might want to copy + it to $HOME/.conkyrc and then start modifying it. + + Configuration file confs + + Conf Meaning + alignment Aligned position on screen, may be top_left, + top_right, bottom_left, bottom_right + background Boolean value, if true, Conky will be forked to + background when started + border_margin Border margin in pixels + border_width Border width in pixels + cpu_avg_samples The number of samples to average for CPU monitoring + default_color Default color and border color + default_shade_color Default shading color and border's shading color + default_outline_color Default outline color + Use the Xdbe extension? (eliminates flicker) It is + double_buffer highly recommended to use own window with this one + so double buffer won't be so big. + draw_borders Draw borders around text? + draw_shades Draw shades? + draw_outline Draw outlines? + font Font name in X, xfontsel can be used to get a nice + font + gap_x Gap between right or left border of screen, same as + passing -x at command line + gap_y Gap between top or bottom border of screen, same as + passing -y at command line + no_buffers Substract (file system) buffers from used memory? + mail_spool Mail spool for mail checking + metar_station METAR station code for weather, see + http://www.wrh.noaa.gov/ if you need to find + your code. + metar_server Define a custom METAR ftp server + metar_path Path on server to use + minimum_size Minimum size of window + mldonkey_hostname Hostname for mldonkey stuff, defaults to localhost + mldonkey_port Mldonkey port, 4001 default + mldonkey_login Mldonkey login, default none + mldonkey_password Mldonkey password, default none + net_avg_samples The number of samples to average for net data + override_utf8_locale Force UTF8? requires XFT + own_window Boolean, create own window to draw? + pad_percents Pad percentages to this many decimals (0 = no + padding) + stippled_borders Border stippling (dashing) in pixels + total_run_times Total number of times for Conky to update before + quitting. Zero makes Conky run forever + update_interval Update interval in seconds + uppercase Boolean value, if true, text is rendered in upper + case + use_spacer Adds spaces after certain objects to stop them + from moving other things around. Note that + this only helps if you are using a mono font, + such as Bitstream Vera Sans Mono. + use_xft Use Xft (anti-aliased font and stuff) + text After this begins text to be formatted on screen + + Boolean variable without value in text means yes. Value may be also yes, + true or any negative or positive integer meaning yes. No, false or zero + meaning no. + There may be some variables in text. Variable is given either in format + $variable or in ${variable}. Latter allows characters right after the + variable and must be used in some stuff because of arguments. + + Command line options + + Argument Description + -V Prints version and exits + -a ALIGNMENT Text alignment on screen, {top,bottom}_{left,right} + -b Use double buffering (eliminates flicker) + -c FILE Config file to load instead of $HOME/.conkyrc + -d Daemonize, fork to background + -f FONT Font to use + -h Prints command line help and exits + -o Create own window to draw + -t TEXT Text to render, remember single quotes, like -t '$uptime' + -u SECS Update interval + -w WIN_ID Window id to draw + -x X X position + -y Y Y position + + Command line options override configurations defined in configuration + file. + + Variables in text + + Variable Arguments Description + + addr (interface) IP address for an interface + acpiacadapter ACPI ac adapter state. + acpifan ACPI fan state + acpitemp ACPI temperature. + adt746xcpu CPU temperature from therm_adt746x + adt746xfan Fan speed from therm_adt746x + alignr (num) Right-justify text, with space of N + alignc Align text to centre + battery (num) Remaining capasity in ACPI or APM + battery. ACPI battery number can be + given as argument (default is BAT0). + buffers Amount of memory buffered + cached Amount of memory cached + color (color) Change drawing color to color + cpu CPU usage in percents + cpubar (height) Bar that shows CPU usage, height is + bar's height in pixels + cpugraph (height),(width) (gradient colour 1) (gradient colour 2) + CPU usage graph, with optional colours in hex, + minus the #. + downspeed net Download speed in kilobytes + downspeedf net Download speed in kilobytes with one + decimal + downspeedgraph net (height),(width) (gradient colour 1) (gradient colour 2) + Download speed graph, colours defined in + hex, minus the #. + exec shell command Executes a shell command and displays + the output in conky. warning: this + takes a lot more resources than other + variables. I'd recommend coding wanted + behaviour in C and posting a patch :-). + execbar shell command 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. + execgraph shell command Same as execbar, but graphs values + execi interval, shell command + Same as exec but with specific interval. + Interval can't be less than + update_interval in configuration. + fs_bar (height), (fs)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. + fs_free (fs) Free space on a file system available + for users. + fs_free_perc (fs) Free percentage of space on a file + system available for users. + fs_size (fs) File system size + fs_used (fs) File system used space + hr (height) Horizontal line, height is the height in + pixels + i2c (dev), type, n I2C sensor from sysfs (Linux 2.6). dev + may be omitted if you have only one I2C + device. type is either in (or vol) + meaning voltage, fan meaning fan or + temp/tempf (first in C, second in F) + meaning temperature. n is number of the + sensor. See /sys/bus/i2c/devices/ on + your local computer. + if_running (process) if PROCESS is running, display + everything if_running and the matching $endif + if_existing (file) if FILE exists, display everything between + if_existing and the matching $endif + if_mounted (mountpoint) if MOUNTPOINT is mounted, display everything between + if_mounted and the matching $endif + else Text to show if any of the above are not true + kernel Kernel version + linkstatus (interface) Get the link status for wireless connections + loadavg (1), (2), (3) System load average, 1 is for past 1 + minute, 2 for past 5 minutes and 3 for + past 15 minutes. + machine Machine, i686 for example + mails Mail count in mail spool. You can use + program like fetchmail to get mails from + some server using your favourite + protocol. See also new_mails. + mem Amount of memory in use + membar (height) Bar that shows amount of memory in use + memmax Total amount of memory + memperc Percentage of memory in use + + metar_ob_time + metar_temp + metar_tempf Temp in F + metar_windchill + metar_dew_point There are a bunch of these + metar_rh and they are self-explanatory + metar_windspeed + metar_winddir + metar_swinddir + metar_cloud + metar_u2d_time + + ml_upload_counter total session upload in mb + ml_download_counter total session download in mb + ml_nshared_files number of shared files + ml_shared_counter total session shared in mb, buggy + in some mldonkey versions + ml_tcp_upload_rate tcp upload rate in kb/s + ml_tcp_download_rate tcp download rate in kb/s + ml_udp_upload_rate udp upload rate in kb/s + ml_udp_download_rate udp download rate in kb/s + ml_ndownloaded_files number of completed files + ml_ndownloading_files number of downloading files + + mpd_artist Artist in current MPD song + (must be enabled at compile) + mpd_album Album in current MPD song + mpd_bar (height) Bar of mpd's progress + mpd_bitrate Bitrate of current song + mpd_status Playing, stopped, et cetera. + mpd_title Title of current MPD song + mpd_vol MPD's volume + mpd_elapsed Song's elapsed time + mpd_length Song's length + mpd_percent Percent of song's progress + new_mails Unread mail count in mail spool. + nodename Hostname + outlinecolor (color) Change outline color + pre_exec shell command Executes a shell command one time before + conky displays anything and puts output + as text. + processes Total processes (sleeping and running) + running_processes Running processes (not sleeping), + requires Linux 2.6 + shadecolor (color) Change shading color + stippled_hr (space), Stippled (dashed) horizontal line + (height) + swapbar (height) Bar that shows amount of swap in use + swap Amount of swap in use + swapmax Total amount of swap + swapperc Percentage of swap in use + sysname System name, Linux for example + offset pixels Move text over by N pixels + tail logfile, lines (interval) + Displays last N lines of supplied text + text file. If interval is not supplied, + Conky assumes 2x Conky's interval. + Max of 30 lines. + Max of 30 lines can be displayed. + time (format) Local time, see man strftime to get more + information about format + totaldown net 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 already done that before conky + has started. + top type, num This takes arguments in the form: + top + Basically, processes are ranked from + highest to lowest in terms of cpu + usage, which is what represents. + The types are: "name", "pid", "cpu", and + "mem". + There can be a max of 10 processes listed. + top_mem type, num Same as top, except sorted by mem usage + instead of cpu + totalup net Total upload, this one too, may overflow + updates Number of updates (for debugging) + upspeed net Upload speed in kilobytes + upspeedf net Upload speed in kilobytes with one + decimal + upspeedgraph net (height),(width) (gradient colour 1) (gradient colour 2) + Upload speed graph, colours defined in + hex, minus the #. + uptime Uptime + uptime_short Uptime in a shorter format + + seti_prog Seti@home current progress + seti_progbar (height) Seti@home current progress bar + seti_credit Seti@hoome total user credit + + + colors are parsed using XParsecolor(), there might be a list of them: + /usr/X11R6/lib/X11/rgb.txt. color can be also in #rrggbb format (hex). + + Note that when displaying bytes, power is 1024 and not 1000 so 1M really + means 1024*1024 bytes and not 1000*1000. + KNOWN PROBLEMS - - 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 - been reported that it doesn't work with KDE either. Nautilus can be - disabled from drawing to desktop with program gconf-editor. Uncheck - show_desktop in /apps/nautilus/preferences/. There is -w switch in 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 which makes - Conky to create its own window. + + 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 + been reported that it doesn't work with KDE either. Nautilus can be + disabled from drawing to desktop with program gconf-editor. Uncheck + show_desktop in /apps/nautilus/preferences/. There is -w switch in 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 which makes + Conky to create its own window. diff --git a/conky.c b/conky.c index a772cf66..ae18a1e5 100644 --- a/conky.c +++ b/conky.c @@ -356,7 +356,15 @@ static const char *scan_graph(const char *args, int *w, int *h, unsigned int *fi if (args) { if (sscanf(args, "%*s %d,%d %x %x", h, w, first_colour, last_colour) < 4) { if (sscanf(args, "%*s %x %x", first_colour, last_colour) < 2) { - sscanf(args, "%x %x", first_colour, last_colour); + if (sscanf(args, "%x %x", first_colour, last_colour) < 2) { + if (sscanf(args, "%d,%d", h, w) < 2) { + sscanf(args, "%*s %d,%d", h, w); + *first_colour = 0; + *last_colour = 0; + } + *first_colour = 0; + *last_colour = 0; + } *w = 0; *h = 25; } diff --git a/conky.h b/conky.h index 9de7e5d1..489f5ebf 100644 --- a/conky.h +++ b/conky.h @@ -381,7 +381,7 @@ int get_mldonkey_status(mldonkey_config * config, mldonkey_info * info); /* in linux.c */ -extern int show_nice_processes; +//static int show_nice_processes; /* in cairo.c */ diff --git a/conkyrc.sample b/conkyrc.sample index fcacc6c1..4d156cac 100644 --- a/conkyrc.sample +++ b/conkyrc.sample @@ -1,6 +1,6 @@ # conky configuration -# set to yes if you want tormo to be forked in the background +# set to yes if you want Conky to be forked in the background background no # X font when Xft is disabled, you can pick one with program xfontsel @@ -8,12 +8,19 @@ background no #font 6x10 #font 7x13 #font 8x13 -font 9x15 +#font 9x15 #font *mintsmild.se* #font -*-*-*-*-*-*-34-*-*-*-*-*-*-* + # Use Xft? -use_xft no +use_xft yes + +# Xft font when Xft is enabled +xftfont Bitstream Vera Sans Mono:size=8 + +# Text alpha when using Xft +xftalpha 0.8 # Print everything to stdout? # out_to_console no @@ -25,12 +32,6 @@ use_xft no # Print everything to console? # out_to_console no -# Xft font when Xft is enabled -xftfont courier-12 - -# Text alpha when using Xft -xftalpha 0.8 - # mail spool mail_spool $MAIL @@ -92,14 +93,14 @@ uppercase no # number of cpu samples to average # set to 1 to disable averaging -cpu_avg_samples 4 +cpu_avg_samples 2 # number of net samples to average # set to 1 to disable averaging -net_avg_samples 4 +net_avg_samples 2 # Force UTF8? note that UTF8 support required XFT -override_utf8_locale no +override_utf8_locale no # Add spaces to keep things from moving about? This only affects certain objects. @@ -111,6 +112,7 @@ use_spacer no # mldonkey_password Mldonkey password, default none # METAR station code for weather, get codes from weather.noaa.gov or google +# or http://www.maltalinks.com/weather/ (thanks Hopeless @ f.g.o) metar_station CYBW # METAR ftp server @@ -126,175 +128,179 @@ metar_station CYBW # # Variable Arguments Description -# addr (interface) IP address for an interface -# acpiacadapter ACPI ac adapter state. -# acpifan ACPI fan state -# acpitemp ACPI temperature. -# adt746xcpu CPU temperature from therm_adt746x -# adt746xfan Fan speed from therm_adt746x -# alignr (num) Right-justify text, with space of N -# alignc Align text to centre -# battery (num) Remaining capasity in ACPI or APM -# battery. ACPI battery number can be -# given as argument (default is BAT0). -# buffers Amount of memory buffered -# cached Amount of memory cached -# color (color) Change drawing color to color -# cpu CPU usage in percents -# cpubar (height) Bar that shows CPU usage, height is -# bar's height in pixels -# cpugraph (height),(width) (gradient colour 1) (gradient colour 2) -# CPU usage graph -# downspeed net Download speed in kilobytes -# downspeedf net Download speed in kilobytes with one -# decimal -# downspeedgraph net (height),(width) (gradient colour 1) (gradient colour 2) -# Download speed graph -# exec shell command Executes a shell command and displays -# the output in conky. warning: this -# takes a lot more resources than other -# variables. I'd recommend coding wanted -# behaviour in C and posting a patch :-). -# execbar shell command 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. -# execgraph shell command Same as execbar, but graphs values -# execi interval, shell Same as exec but with specific interval. -# command Interval can't be less than -# update_interval in configuration. -# fs_bar (height), (fs) 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. -# fs_free (fs) Free space on a file system available -# for users. -# fs_free_perc (fs) Free percentage of space on a file -# system available for users. -# fs_size (fs) File system size -# fs_used (fs) File system used space -# hr (height) Horizontal line, height is the height in -# pixels -# i2c (dev), type, n I2C sensor from sysfs (Linux 2.6). dev -# may be omitted if you have only one I2C -# device. type is either in (or vol) -# meaning voltage, fan meaning fan or -# temp/tempf (first in C, second in F) -# meaning temperature. n is number of the -# sensor. See /sys/bus/i2c/devices/ on -# your local computer. -# if_running (process) if PROCESS is running, display -# everything if_running and the matching $endif -# if_existing (file) if FILE exists, display everything between -# if_existing and the matching $endif -# if_mounted (mountpoint) if MOUNTPOINT is mounted, display everything between -# if_mounted and the matching $endif -# else Text to show if any of the above are not true -# kernel Kernel version -# linkstatus (interface) Get the link status for wireless connections -# loadavg (1), (2), (3) System load average, 1 is for past 1 -# minute, 2 for past 5 minutes and 3 for -# past 15 minutes. -# machine Machine, i686 for example -# mails Mail count in mail spool. You can use -# program like fetchmail to get mails from -# some server using your favourite -# protocol. See also new_mails. -# mem Amount of memory in use -# membar (height) Bar that shows amount of memory in use -# memmax Total amount of memory -# memperc Percentage of memory in use -# -# metar_ob_time -# metar_temp -# metar_tempf Temp in F -# metar_windchill -# metar_dew_point There are a bunch of these -# metar_rh and they are self-explanatory -# metar_windspeed -# metar_winddir -# metar_swinddir -# metar_cloud -# metar_u2d_time - -# ml_upload_counter total session upload in mb -# ml_download_counter total session download in mb -# ml_nshared_files number of shared files -# ml_shared_counter total session shared in mb, buggy -# in some mldonkey versions -# ml_tcp_upload_rate tcp upload rate in kb/s -# ml_tcp_download_rate tcp download rate in kb/s -# ml_udp_upload_rate udp upload rate in kb/s -# ml_udp_download_rate udp download rate in kb/s -# ml_ndownloaded_files number of completed files -# ml_ndownloading_files number of downloading files -# -# mpd_artist Artist in current MPD song -# (must be enabled at compile) -# mpd_album Album in current MPD song -# mpd_bar (height) Bar of mpd's progress -# mpd_bitrate Bitrate of current song -# mpd_status Playing, stopped, et cetera. -# mpd_title Title of current MPD song -# mpd_vol MPD's volume -# mpd_elapsed Song's elapsed time -# mpd_length Song's length -# mpd_percent Percent of song's progress -# new_mails Unread mail count in mail spool. -# nodename Hostname -# outlinecolor (color) Change outline color -# pre_exec shell command Executes a shell command one time before -# conky displays anything and puts output -# as text. -# processes Total processes (sleeping and running) -# running_processes Running processes (not sleeping), -# requires Linux 2.6 -# shadecolor (color) Change shading color -# stippled_hr (space), Stippled (dashed) horizontal line -# (height) -# swapbar (height) Bar that shows amount of swap in use -# swap Amount of swap in use -# swapmax Total amount of swap -# swapperc Percentage of swap in use -# sysname System name, Linux for example -# offset pixels Move text over by N pixels -# tail logfile, lines (interval) -# Displays last N lines of supplied text -# text file. If interval is not supplied, -# Conky assumes 2x Conky's interval. -# Max of 30 lines. -# Max of 30 lines can be displayed. -# time (format) Local time, see man strftime to get more -# information about format -# totaldown net 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 already done that before conky -# has started. -# top type, num This takes arguments in the form: -# top -# Basically, processes are ranked from -# highest to lowest in terms of cpu -# usage, which is what represents. -# The types are: "name", "pid", "cpu", and -# "mem". -# There can be a max of 10 processes listed. -# top_mem type, num Same as top, except sorted by mem usage -# instead of cpu -# totalup net Total upload, this one too, may overflow -# updates Number of updates (for debugging) -# upspeed net Upload speed in kilobytes -# upspeedf net Upload speed in kilobytes with one -# decimal -# upspeedgraph net (height),(width) (gradient colour 1) (gradient colour 2) -# Upload speed graph -# uptime Uptime -# uptime_short Uptime in a shorter format -# -# seti_prog Seti@home current progress -# seti_progbar (height) Seti@home current progress bar -# seti_credit Seti@hoome total user credit +# addr (interface) IP address for an interface +# acpiacadapter ACPI ac adapter state. +# acpifan ACPI fan state +# acpitemp ACPI temperature. +# adt746xcpu CPU temperature from therm_adt746x +# adt746xfan Fan speed from therm_adt746x +# alignr (num) Right-justify text, with space of N +# alignc Align text to centre +# battery (num) Remaining capasity in ACPI or APM +# battery. ACPI battery number can be +# given as argument (default is BAT0). +# buffers Amount of memory buffered +# cached Amount of memory cached +# color (color) Change drawing color to color +# cpu CPU usage in percents +# cpubar (height) Bar that shows CPU usage, height is +# bar's height in pixels +# cpugraph (height),(width) (gradient colour 1) (gradient colour 2) +# CPU usage graph, with optional colours in hex, +# minus the #. +# downspeed net Download speed in kilobytes +# downspeedf net Download speed in kilobytes with one +# decimal +# downspeedgraph net (height),(width) (gradient colour 1) (gradient colour 2) +# Download speed graph, colours defined in +# hex, minus the #. +# exec shell command Executes a shell command and displays +# the output in conky. warning: this +# takes a lot more resources than other +# variables. I'd recommend coding wanted +# behaviour in C and posting a patch :-). +# execbar shell command 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. +# execgraph shell command Same as execbar, but graphs values +# execi interval, shell command +# Same as exec but with specific interval. +# Interval can't be less than +# update_interval in configuration. +# fs_bar (height), (fs)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. +# fs_free (fs) Free space on a file system available +# for users. +# fs_free_perc (fs) Free percentage of space on a file +# system available for users. +# fs_size (fs) File system size +# fs_used (fs) File system used space +# hr (height) Horizontal line, height is the height in +# pixels +# i2c (dev), type, n I2C sensor from sysfs (Linux 2.6). dev +# may be omitted if you have only one I2C +# device. type is either in (or vol) +# meaning voltage, fan meaning fan or +# temp/tempf (first in C, second in F) +# meaning temperature. n is number of the +# sensor. See /sys/bus/i2c/devices/ on +# your local computer. +# if_running (process) if PROCESS is running, display +# everything if_running and the matching $endif +# if_existing (file) if FILE exists, display everything between +# if_existing and the matching $endif +# if_mounted (mountpoint) if MOUNTPOINT is mounted, display everything between +# if_mounted and the matching $endif +# else Text to show if any of the above are not true +# kernel Kernel version +# linkstatus (interface) Get the link status for wireless connections +# loadavg (1), (2), (3) System load average, 1 is for past 1 +# minute, 2 for past 5 minutes and 3 for +# past 15 minutes. +# machine Machine, i686 for example +# mails Mail count in mail spool. You can use +# program like fetchmail to get mails from +# some server using your favourite +# protocol. See also new_mails. +# mem Amount of memory in use +# membar (height) Bar that shows amount of memory in use +# memmax Total amount of memory +# memperc Percentage of memory in use +# +# metar_ob_time +# metar_temp +# metar_tempf Temp in F +# metar_windchill +# metar_dew_point There are a bunch of these +# metar_rh and they are self-explanatory +# metar_windspeed +# metar_winddir +# metar_swinddir +# metar_cloud +# metar_u2d_time +# +# ml_upload_counter total session upload in mb +# ml_download_counter total session download in mb +# ml_nshared_files number of shared files +# ml_shared_counter total session shared in mb, buggy +# in some mldonkey versions +# ml_tcp_upload_rate tcp upload rate in kb/s +# ml_tcp_download_rate tcp download rate in kb/s +# ml_udp_upload_rate udp upload rate in kb/s +# ml_udp_download_rate udp download rate in kb/s +# ml_ndownloaded_files number of completed files +# ml_ndownloading_files number of downloading files +# +# mpd_artist Artist in current MPD song +# (must be enabled at compile) +# mpd_album Album in current MPD song +# mpd_bar (height) Bar of mpd's progress +# mpd_bitrate Bitrate of current song +# mpd_status Playing, stopped, et cetera. +# mpd_title Title of current MPD song +# mpd_vol MPD's volume +# mpd_elapsed Song's elapsed time +# mpd_length Song's length +# mpd_percent Percent of song's progress +# new_mails Unread mail count in mail spool. +# nodename Hostname +# outlinecolor (color) Change outline color +# pre_exec shell command Executes a shell command one time before +# conky displays anything and puts output +# as text. +# processes Total processes (sleeping and running) +# running_processes Running processes (not sleeping), +# requires Linux 2.6 +# shadecolor (color) Change shading color +# stippled_hr (space), Stippled (dashed) horizontal line +# (height) +# swapbar (height) Bar that shows amount of swap in use +# swap Amount of swap in use +# swapmax Total amount of swap +# swapperc Percentage of swap in use +# sysname System name, Linux for example +# offset pixels Move text over by N pixels +# tail logfile, lines (interval) +# Displays last N lines of supplied text +# text file. If interval is not supplied, +# Conky assumes 2x Conky's interval. +# Max of 30 lines. +# Max of 30 lines can be displayed. +# time (format) Local time, see man strftime to get more +# information about format +# totaldown net 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 already done that before conky +# has started. +# top type, num This takes arguments in the form: +# top +# Basically, processes are ranked from +# highest to lowest in terms of cpu +# usage, which is what represents. +# The types are: "name", "pid", "cpu", and +# "mem". +# There can be a max of 10 processes listed. +# top_mem type, num Same as top, except sorted by mem usage +# instead of cpu +# totalup net Total upload, this one too, may overflow +# updates Number of updates (for debugging) +# upspeed net Upload speed in kilobytes +# upspeedf net Upload speed in kilobytes with one +# decimal +# upspeedgraph net (height),(width) (gradient colour 1) (gradient colour 2) +# Upload speed graph, colours defined in +# hex, minus the #. +# uptime Uptime +# uptime_short Uptime in a shorter format +# +# seti_prog Seti@home current progress +# seti_progbar (height) Seti@home current progress bar +# seti_credit Seti@hoome total user credit # variable is given either in format $variable or in ${variable}. Latter @@ -306,25 +312,31 @@ metar_station CYBW TEXT $nodename - $sysname $kernel on $machine $stippled_hr -${color grey}Uptime$color $uptime -${color grey}RAM Usage:$color $mem/$memmax - $memperc% ${membar 6} -${color grey}Swap Usage:$color $swap/$swapmax - $swapperc% ${swapbar 6} -${color grey}CPU Usage:$color $cpu% ${cpubar 6} -${color grey}Processes:$color $processes ${color grey}Running:$color $running_processes -${color grey}Mails: ${color}$mails${color grey} New: ${color}$new_mails${color grey} +${color lightgrey}Uptime:$color $uptime ${color lightgrey}- Load:$color $loadavg +${color lightgrey}CPU Usage:${color #cc2222} $cpu% ${cpubar} +${color red}${cpugraph 0000ff 00ff00} +${color lightgrey}RAM Usage:$color $mem/$memmax - $memperc% ${membar} +${color lightgrey}Swap Usage:$color $swap/$swapmax - $swapperc% ${swapbar} +${color lightgrey}Processes:$color $processes ${color grey}Running:$color $running_processes $color$stippled_hr -${color grey}Networking: - Up:$color ${upspeed eth0} k/s${color grey} - Down:$color ${downspeed eth0} k/s -${color grey}File systems: - / $color${fs_free /}/${fs_size /} ${fs_bar 6 /} -${color grey}Temperatures: - CPU:$color ${i2c temp 1}°C${color grey} - MB:$color ${i2c temp 2}°C -${color grey}MPD: -$mpd_status ${alignc}$mpd_artist - $mpd_title from $mpd_album at $mpd_vol $mpd_bitrate -$mpd_bar -${color grey}Name PID CPU% MEM% - ${color lightgrey} ${top name 1} ${top pid 1} ${top cpu 1} ${top mem 1} - ${color lightgrey} ${top name 2} ${top pid 2} ${top cpu 2} ${top mem 2} - ${color lightgrey} ${top name 3} ${top pid 3} ${top cpu 3} ${top mem 3} -${tail /var/log/Xorg.0.log 3 30} -${metar_temp}C $metar_cloud +${color lightgrey}Networking: + Down:${color #8844ee} ${downspeed eth0} k/s${color lightgrey} ${offset 80}Up:${color #22ccff} ${upspeed eth0} k/s +${color #0000ff}${downspeedgraph eth0 32,150 ff0000 0000ff} ${color #22ccff}${upspeedgraph eth0 32,150 0000ff ff0000} +${color lightgrey}File systems: + / $color${fs_used /}/${fs_size /} ${fs_bar /} +${color lightgrey}Temperatures: + CPU:$color ${i2c temp 2}C${color grey} - MB:$color ${i2c temp 1}C +${color #88aadd}MPD: ${alignc}$mpd_artist - $mpd_title +${color #88aadd}$mpd_bar +${color #88aadd}${alignc}$mpd_status +${color}Name PID CPU% MEM% +${color #ddaa00} ${top name 1} ${top pid 1} ${top cpu 1} ${top mem 1} +${color lightgrey} ${top name 2} ${top pid 2} ${top cpu 2} ${top mem 2} +${color lightgrey} ${top name 3} ${top pid 3} ${top cpu 3} ${top mem 3} +${color lightgrey} ${top name 4} ${top pid 4} ${top cpu 4} ${top mem 4} +${color}Mem usage +${color #ddaa00} ${top_mem name 1} ${top_mem pid 1} ${top_mem cpu 1} ${top_mem mem 1} +${color lightgrey} ${top_mem name 2} ${top_mem pid 2} ${top_mem cpu 2} ${top_mem mem 2} +${color lightgrey} ${top_mem name 3} ${top_mem pid 3} ${top_mem cpu 3} ${top_mem mem 3} +${color}Current conditions: ${color lightgrey}${metar_temp}C $metar_cloud +${tail /var/log/Xorg.0.log 3 30} \ No newline at end of file