Conky

From Gentoo Wiki
Jump to: navigation, search
This article is a stub. You can help by expanding it.

Conky is an advanced and highly configurable system monitor for the Xorg window system, which "can display arbitrary information (such as the date, CPU temperature from I2C, MPD info, and anything else you desire) to the root window in X. Conky normally does this by drawing to the root window, however Conky can also be run in windowed mode (though this is not how Conky was meant to be used)."[1]

Installation

USE flags

USE flags for app-admin/conky An advanced, highly configurable system monitor for X

X Add support for X11
apcupsd Enable support for sys-power/apcupsd
bundled-toluapp Enable support for bundled toluapp. This only makes sense in combination with the lua-* flags
cmus Enable monitoring of music played by media-sound/cmus
curl Add support for client-side URL transfer library
doc Add extra documentation (API, Javadoc, etc). It is recommended to enable per package instead of globally
hddtemp Enable monitoring of hdd temperature (app-admin/hddtemp)
ical Enable support for events from iCalendar (RFC 5545) files using dev-libs/libical
iconv Enable support for the iconv character set conversion library
imlib Add support for imlib, an image loading and rendering library
iostats Enable support for per-task I/O statistics
ipv6 Add support for IP version 6
irc Enable support for displaying everything from an irc channel using net-libs/libircclient
lua-cairo Enable if you want Lua Cairo bindings
lua-imlib Enable if you want Lua Imlib2 bindings
lua-rsvg Enable if you want Lua RSVG bindings
math Enable support for glibc's libm math library
moc Enable monitoring of music played by media-sound/moc
mpd Enable monitoring of music controlled by media-sound/mpd
mysql Add mySQL Database support
nano-syntax Enable syntax highlighting for app-editors/nano
ncurses Add ncurses support (console display library)
nvidia Enable reading of nvidia card temperature sensors via x11-drivers/nvidia-drivers
portmon Enable support for tcp (ip4) port monitoring
pulseaudio Add support for PulseAudio sound server
rss Enable support for RSS feeds
systemd Enable use of systemd-specific libraries and features like socket activation or session tracking
thinkpad Enable support for IBM/Lenovo notebooks
truetype Add support for FreeType and/or FreeType2 fonts
vim-syntax Pulls in related vim syntax scripts
weather-metar Enable support for metar weather service
webserver Enable support to act as a webserver serving conkys output using net-libs/libmicrohttpd
wifi Enable wireless network functions
xmms2 Enable monitoring of music played by media-sound/xmms2

Emerge

Install app-admin/conky:

root #emerge --ask app-admin/conky

Configuration

After installing Conky, decompress and copy the conky configuration file to the relevant user's ~/.conkyrc to customize the configuration. Note: the path will change based on the version of Conky installed:

user $bzip2 -cd /usr/share/doc/conky-1.10.8-r4/conky.conf.bz2 > ~/.conkyrc

The configuration file for Conky version 1.10 and prior will be located at /etc/conky/conky.conf, so adjust the above command as necessary when using an older version.

Open the configuration file with a text editor of choice and edit away.

See also

  • Conky/Guide — describes how to install and configure the system monitor known as Conky.

External resources

References