Conf Meaning
alignment Aligned position on screen, may be top_left,
- top_right, bottom_left, bottom_right
+ top_right, bottom_left, bottom_right, none
background Boolean value, if true, Conky will be forked to
background when started
on_bottom Set conky on the bottom of all other applications
Argument Description
-V Prints version and exits
- -a ALIGNMENT Text alignment on screen, {top,bottom}_{left,right}
+ -a ALIGNMENT Text alignment on screen, {top,bottom}_{left,right} | none
-b Use double buffering (eliminates flicker)
-c FILE Config file to load instead of $HOME/.conkyrc
-d Daemonize, fork to background
TOP_RIGHT,
BOTTOM_LEFT,
BOTTOM_RIGHT,
+ NONE
};
x = workarea[2] - text_width - gap_x;
y = workarea[3] - text_height - gap_y;
break;
+
+ case NONE: // Let the WM manage the window
+ x = window.x;
+ y = window.y;
+
+ fixed_pos = 1;
+ fixed_size = 1;
+ break;
}
#ifdef OWN_WINDOW
- if (own_window) {
+ if (own_window && !fixed_pos) {
x += workarea[0];
y += workarea[1];
text_start_x = border_margin + 1;
return BOTTOM_LEFT;
else if (strcasecmp(s, "br") == 0)
return BOTTOM_RIGHT;
-
+ else if (strcasecmp(s, "none") == 0)
+ return NONE;
return TOP_LEFT;
}
#endif /* X11 */
#ifdef X11
update_text_area(); /* to get initial size of the window */
+#if defined OWN_WINDOW
init_window
(own_window,
- text_width
- + border_margin * 2 + 1, text_height + border_margin * 2 + 1, on_bottom);
+ text_width + border_margin * 2 + 1,
+ text_height + border_margin * 2 + 1,
+ on_bottom, fixed_pos);
+#else
+ init_winow
+ (own_window,
+ text_width + border_margin * 2 + 1,
+ text_height + border_margin * 2 + 1,
+ on_bottom);
+
+#endif
update_text_area(); /* to position text/window on screen */
#endif /* X11 */
#ifdef X11
#ifdef OWN_WINDOW
- if (own_window)
+ if (own_window && !fixed_pos)
XMoveWindow(display, window.window, window.x, window.y);
#endif
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>conky</title><meta name="generator" content="DocBook XSL Stylesheets V1.66.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="id2447358"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>conky — a system monitor for X originally based on the torsmo code, but more kickass.</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><tt class="command">conky</tt> [<i class="replaceable"><tt>options</tt></i>]</p></div></div><div class="refsect1" lang="en"><a name="id2476574"></a><h2>Description</h2><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>conky</title><meta name="generator" content="DocBook XSL Stylesheets V1.66.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="id257346"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>conky — a system monitor for X originally based on the torsmo code, but more kickass.</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><tt class="command">conky</tt> [<i class="replaceable"><tt>options</tt></i>]</p></div></div><div class="refsect1" lang="en"><a name="id222072"></a><h2>Description</h2><p>
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.
Please use the facilities at SourceForge to make bug reports, feature requests, and submit patches.
</p><p>
Thanks for your interest in Conky.
- </p></div><div class="refsect1" lang="en"><a name="id2476601"></a><h2>Compiling</h2><p>
+ </p></div><div class="refsect1" lang="en"><a name="id222093"></a><h2>Compiling</h2><p>
To compile and run Conky with all optional components (If you run Gentoo, see the "Ebuild" Section below):
</p><div class="variablelist"><dl><dt><span class="term">
<span><b class="command"><tt class="option">./configure </tt></b></span><tt class="option">
</p><p>
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.
- </p></div><div class="refsect1" lang="en"><a name="id2448032"></a><h2>You Should Know</h2><p>
+ </p></div><div class="refsect1" lang="en"><a name="id239594"></a><h2>You Should Know</h2><p>
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.
</p><p>
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).
- </p></div><div class="refsect1" lang="en"><a name="id2448051"></a><h2>Options</h2><p>Command line options override configurations defined in configuration file.</p><div class="variablelist"><dl><dt><span class="term"><span><b class="command"><tt class="option">-V</tt></b></span></span></dt><dd>
+ </p></div><div class="refsect1" lang="en"><a name="id239610"></a><h2>Options</h2><p>Command line options override configurations defined in configuration file.</p><div class="variablelist"><dl><dt><span class="term"><span><b class="command"><tt class="option">-V</tt></b></span></span></dt><dd>
Prints version and exits
<p></p></dd><dt><span class="term"><span><b class="command"><tt class="option">-a </tt></b></span><tt class="option">ALIGNMENT</tt></span></dt><dd>
Text alignment on screen, {top,bottom}_{left,right}
X position
<p></p></dd><dt><span class="term"><span><b class="command"><tt class="option">-y </tt></b></span><tt class="option">Y_COORDINATE</tt></span></dt><dd>
Y position
- <p></p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2447524"></a><h2>Configuration Settings</h2><p>
+ <p></p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id221336"></a><h2>Configuration Settings</h2><p>
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.
Use Xft (anti-aliased font and stuff)
<p></p></dd><dt><span class="term"><span><b class="command"><tt class="option">text</tt></b></span></span></dt><dd>
After this begins text to be formatted on screen
- <p></p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2517515"></a><h2>Variables</h2><p>
+ <p></p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id265183"></a><h2>Variables</h2><p>
Colors are parsed using XParsecolor(), there might be a list of them:
/usr/X11R6/lib/X11/rgb.txt. Also, <a href="http://sedition.com/perl/rgb.html" target="_top">
http://sedition.com/perl/rgb.html</a>
<span><b class="command"><tt class="option">seti_credit</tt></b></span>
</span></dt><dd>
Seti@home total user credit
- <p></p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2521839"></a><h2>Examples</h2><div class="variablelist"><dl><dt><span class="term"><tt class="varname">conky </tt><tt class="option">-t '${time %D %H:%m}' -o -u 30</tt></span></dt><dd>Start Conky in its own window with date and clock as text and 30 sec update interval.</dd><dt><span class="term"><tt class="varname">conky </tt><tt class="option">-a top_left -x 5 -y 500 -d</tt></span></dt><dd>Start Conky to background at coordinates (5, 500).</dd></dl></div></div><div class="refsect1" lang="en"><a name="id2521880"></a><h2>Files</h2><tt class="filename">~/.conkyrc</tt> default configuration file
- </div><div class="refsect1" lang="en"><a name="id2521893"></a><h2>Bugs</h2><p>
+ <p></p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id269404"></a><h2>Examples</h2><div class="variablelist"><dl><dt><span class="term"><tt class="varname">conky </tt><tt class="option">-t '${time %D %H:%m}' -o -u 30</tt></span></dt><dd>Start Conky in its own window with date and clock as text and 30 sec update interval.</dd><dt><span class="term"><tt class="varname">conky </tt><tt class="option">-a top_left -x 5 -y 500 -d</tt></span></dt><dd>Start Conky to background at coordinates (5, 500).</dd></dl></div></div><div class="refsect1" lang="en"><a name="id269443"></a><h2>Files</h2><tt class="filename">~/.conkyrc</tt> default configuration file
+ </div><div class="refsect1" lang="en"><a name="id269455"></a><h2>Bugs</h2><p>
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
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.
- </p></div><div class="refsect1" lang="en"><a name="id2521912"></a><h2>See Also</h2><p><a href="http://conky.sourceforge.net" target="_top">
+ </p></div><div class="refsect1" lang="en"><a name="id269470"></a><h2>See Also</h2><p><a href="http://conky.sourceforge.net" target="_top">
http://conky.sourceforge.net</a></p><p><a href="http://www.sourceforge.net/projects/conky" target="_top">
http://www.sourceforge.net/projects/conky</a></p><p>
#conky on irc.freenode.net
- </p></div><div class="refsect1" lang="en"><a name="id2521938"></a><h2>Authors</h2><p>
+ </p></div><div class="refsect1" lang="en"><a name="id269495"></a><h2>Authors</h2><p>
The Conky dev team. What's up now??!
</p></div></div></body></html>