wmnut - A wmaker dock app that displays UPS statistics from NUT's upsd Copyright (C) 2002-2003 Arnaud Quette wmnut is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Comments are welcome. Installation instructions for WMNUT. Requirements -------------------------------------------------------------- WMNUT requires the: * X Window client and Xpm libraries and development files * NUT framework (www.exploits.org/nut) installed with misc files (upsclient.h/o installed in /usr/local/ups/lib by make install-misc). In order to compile WMNUT using the Makefile, GNU make must be used (FreeBSD users, the default BSD 'make' does not work, so use gmake instead). Installation -------------------------------------------------------------- 1) % tar -zxvf wmnut-X.YZ.tar.gz or % tar -jxvf wmnut-X.YZ.tar.bz2 2) % cd wmnut-X.YZ/ 3) % ./configure Note that you can force NUT library files path by using "--with-nut-libs" and "--with-nut-includes" or only "--with-nut" to indicate the respective directories of upsclient.o and upsclient.h. 4) % make (or gmake on most *BSD systems) 5) % make install (must be root) or simply copy binary (and optionally the man page) to a directory in your path. 6) (Optional) edit and tune (if needed) wmnutrc, then copy it to your home or/and etc directory : % cp wmnutrc /etc/wmnutrc or / and % cp wmnutrc ~/.wmnutrc Notes: - if both files exist, "~/.wmnutrc" takes precedence. - command lines options takes precedence on above files. - on debian, wmnutrc is located in /usr/share/doc/wmnut/ 7) % wmnut & (or 'wmnut -h' for help, or 'man wmnut' for the man page) If no parameter is given, wmnut will try to access the UPS at "localhost" address ; otherwise try "wmnut -U upsname@hostname" or edit your wmnutrc files. Be sure to read the HINTS and TODO files too! - Arnaud Quette