]>

brenden1@users.sourceforge.net

Brenden Matthews 2007-08-08 conky 1 conky A system monitor for X originally based on the torsmo code, but more kickass. It just keeps on given'er. Yeah. conky options 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. For users compiling from source, make sure you have the X development libraries installed. This should be a package along the lines of "libx11-dev or xorg-x11-dev". Gentoo users -- Conky is in Gentoo's Portage... simply use "emerge app-admin/conky" for installation. There is also usually an up-to-date ebuild within Conky's package or in Svn. Debian,etc. users -- Conky will be in Debian's repositories soon (by mid-September, hopefully), and then Ubuntu shortly thereafter. Until then, "dpkg -i" the .deb package to install. Example to compile and run Conky with all optional components (note that some configure options may differ for your system): sh autogen.sh # Only required if building from Svn ./configure --prefix=/usr --mandir=/usr/share/man --infodir=/usr/share/info --datadir=/usr/share --sysconfdir=/etc --localstatedir=/var/lib --disable-own-window --enable-audacious[=yes|no|legacy] --enable-bmpx --disable-hddtemp --disable-mpd --enable-xmms2 --disable-portmon --disable-network --enable-debug --disable-x11 --disable-double-buffer --disable-xdamage --disable-xft make make install # Optional src/conky Conky probably doesn't compile with compilers other than gcc and icc. It doesn't compile with C89 compiler and not even with pure C99. It uses a 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 is generally very good on resources. However, certain objects in Conky are harder on resources then others. In particular, the $tail, $top, $font, 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's seriously wrong (mem leak, etc.). An easy way to force Conky to reload your ~/.conkyrc: "killall -SIGUSR1 conky". Saves you the trouble of having to kill and then restart. IMPORTANT: For previous Conky users, Conky 1.3 no longer supports the metar stuff. mdsplib was causing way too many problems. Hopefully there'll be a better solution in Conky 2.x... Command line options override configurations defined in configuration file. &command_options; Default configuration file is $HOME/.conkyrc (can be changed from conky.c among other things). See conkyrc.sample. If installing from Debian package, this should be in /usr/share/doc/conky/examples ("gunzip conkyrc.sample.gz" to get conkyrc.sample). You might want to copy it to $HOME/.conkyrc and then start modifying it. Other configs can be found at http://conky.sf.net &config_settings; Colors are parsed using XParsecolor(), there might be a list of them: /usr/X11R6/lib/X11/rgb.txt. Also, http://sedition.com/perl/rgb.html. 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. &variables; conky -t '${time %D %H:%M}' -o -u 30 Start Conky in its own window with date and clock as text and 30 sec update interval. conky -a top_left -x 5 -y 500 -d Start Conky to background at coordinates (5, 500). ~/.conkyrc default configuration file 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. http://conky.sourceforge.net http://www.sourceforge.net/projects/conky #conky on irc.freenode.net The Conky dev team. What's up now!