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):
-
- ./configure --prefix=/usr --enable-xft --enable-mpd --enable-seti --enable-double-buffer --enable-own-window --enable-proc-uptime
- make
- ./conky
+ To compile and run Conky with all optional components (If you run Gentoo, see the "Ebuild" Section below):
- 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.
+ ./configure --prefix=/usr --enable-xft --enable-mpd --enable-seti --enable-double-buffer --enable-own-window --enable-proc-uptime --enable-metar --enable-mldonkey
+ make
+ ./conky
- 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 <name> <number>
- Basically, processes are ranked from
- highest to lowest in terms of cpu
- usage, which is what <num> 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 <name> <number>
+ Basically, processes are ranked from
+ highest to lowest in terms of cpu
+ usage, which is what <num> 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.
# 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
#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
# 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
# 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.
# 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
#
# 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 <name> <number>
-# Basically, processes are ranked from
-# highest to lowest in terms of cpu
-# usage, which is what <num> 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 <name> <number>
+# Basically, processes are ranked from
+# highest to lowest in terms of cpu
+# usage, which is what <num> 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
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
projects / monky / commitdiff