= Psensor README :docinfo2: Introduction ------------ Psensor is a graphical hardware monitoring application for Linux. It draws realtime charts and raises alerts about: * the temperature of the motherboard and CPU sensors (using lm-sensors). * the temperature of the NVidia GPUs (using XNVCtrl). * the temperature of ATI GPUs (using ATI ADL SDK). * the temperature of the Hard Disk Drives (using hddtemp, libatasmart or udisks2). * the rotation speed of the fans. * the temperature of a remote computer. * the CPU load. Alerts are using Desktop Notification and a specific GTK+ status icon. For Ubuntu users, Psensor is providing an Application Indicator which turns red under alert and a menu for quickly check all sensors. It is possible to monitor remotely a computer: * start +psensor-server+ on the remote computer. * start +psensor+ using: +psensor --url=http://hostname:3131+. +psensor-server+ is a minimal Web server, a Web browser can be used to monitor the remote computer by opening the URL: +http://hostname:3131+. [WARNING] +psensor-server+ does not provide any way to restrict the connection to the HTTP server, worst, no effort has been made against malicious HTTP attacks. You should make the +psensor-server+ port available only to a network or computer you trust by using the usual network security tools of the system (for example: http://www.netfilter.org/projects/iptables/index.html[iptables]). Installation Using Distribution Packages ---------------------------------------- Debian ~~~~~~ For Debian, the binary and source packages are available in the Wheezy, unstable and testing repositories. Debian package information is available at: http://packages.qa.debian.org/p/psensor.html. To do the installation: -------------------------------------------- sudo apt-get install psensor psensor-server -------------------------------------------- Ubuntu ~~~~~~ Since Ubuntu Oneiric (11.10), psensor is available in the universe repository of Ubuntu. To install +psensor+ or +psensor-server+: ------------------------------------ sudo apt-get install psensor sudo apt-get install psensor-server ------------------------------------ Or search them in the Ubuntu Software Center. For other Ubuntu releases or user the more recent release, the easiest way is to use the dedicated PPA. Last stable version: ------------------------------------------------- sudo apt-get apt-add-repository ppa:/jfi/psensor sudo apt-get update sudo apt-get install psensor sudo apt-get install psensor-server ------------------------------------------------- Last development version which should not contain major bugs: ---------------------------------------------------------- sudo apt-get apt-add-repository ppa:/jfi/psensor-unstable sudo apt-get update sudo apt-get install psensor sudo apt-get install psensor-server ---------------------------------------------------------- Daily trunk build which may contain major bugs and partialy implemented features: ------------------------------------------------------------- sudo apt-get apt-add-repository ppa:/jfi/psensor-daily-trunk sudo apt-get update sudo apt-get install psensor sudo apt-get install psensor-server ------------------------------------------------------------- Installation From Source Archive -------------------------------- +psensor+ and +psensor-server+ can be compiled and installed on any modern GNU/Linux distribution. Compilation Prerequisites ~~~~~~~~~~~~~~~~~~~~~~~~~ The compilation of +psensor+ requires: * make * gcc (or llvm) * lm-sensors * library sensors4 * library gtk3 >=3.4 * help2man (optional, required to produce the manpage) * asciidoc (optional, required to produce the html version of the faq) * cppcheck (optional, static source checker) * library libnotify (optional) * library libappindicator >= 3.0 (optional) * library libXNVCtrl (optional) * library json-c >= 0.11.99 and curl (optional, required for remote monitoring) * library unity (>=v3.4.2, optional) * library gtop2 (optional, required for CPU usage) * library atasmart (optional, for disk monitoring) * library udisk2 (optional, for disk monitoring) The specific requirements for +psensor-server+: * library libmicrohttpd * library json-c >= 0.11.99 Compilation and Installation Steps ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1. download the source archive from: http://wpitchoune.net/psensor/files 2. Extract files from the source archive 3. Compilation: +./configure;make clean all+ 4. Installation: +make install+ (require to have root permission) 5. Start the sensor detection script: +sensors-detect+ and follows the instructions. Reboot or activate the kernel modules which have been found. 6. Run: +psensor+ ATI/AMD GPU Support ~~~~~~~~~~~~~~~~~~~ When the OpenSource ATI driver is used, the monitoring information is available throw lm-sensors and does not require the following instructions. When the proprietary ATI driver(Catalyst) is used, the build is requiring an additional library. Download the http://developer.amd.com/sdks/ADLSDK/Pages/default.aspx[ATI ADL SDK] and extracts the files of the archive into a directory [dir]. Replace the step 3. of the above section by +./configure --with-libatiadl=[dir]+ where +[dir]+ must be the directory where you have extracted the ATI ADL SDK. Other steps are indentical. Contact ------- Bugs and comments can be sent to jeanfi@gmail.com. Home page: http://wpitchoune.net/psensor