README

   1 Psensor - Temperature Monitoring For Linux
   2 ------------------------------------------
   3
   4 Psensor is a graphical temperature monitor for Linux.
   5
   6 It can monitor:
   7
   8   * the temperature of the motherboard and CPU sensors (using
   9     lm-sensors).
  10   * the temperature of the NVidia GPUs (using XNVCtrl).
  11   * the temperature of the Hard Disk Drives (using hddtemp).
  12   * the rotation speed of the fans (using lm-sensors).
  13   * the temperature of a remote computer.
  14
  15 Alarms using Desktop Notification can be set to each sensor to notify
  16 high temperatures.
  17
  18 For Ubuntu users, Psensor is providing an Application Indicator to
  19 alert users when a temperature is too high.
  20
  21 To monitor the temperature of a remote computer:
  22
  23   * start psensor-server on the remote computer. The default port is
  24     3131 and can be changed by using the '--port=PORT' command line
  25     option.
  26
  27   * start psensor with the '--url' option:
  28   psensor --url=http://hostname:3131
  29
  30 WARNING:
  31 psensor-server does not provide any way to restrict the connection to
  32 the HTTP server, worst, no effort has been made against malicious HTTP
  33 attacks.  You should make the psensor-server port available only to a
  34 network or computer you trust by using the usual network security
  35 tools of the system (for example, iptables).
  36
  37
  38 Installation
  39 ------------
  40
  41 Ubuntu
  42 ------
  43
  44 For Ubuntu, the easy way to install Psensor and Psensor-server is to
  45 use the dedicated PPA.
  46
  47 For the last stable version:
  48 sudo apt-get apt-add-repository ppa:/jfi/psensor
  49 sudo apt-get update
  50 sudo apt-get install psensor
  51
  52 For the last development version:
  53 sudo apt-get apt-add-repository ppa:/jfi/psensor-unstable
  54 sudo apt-get update
  55 sudo apt-get install psensor
  56 sudo apt-get install psensor-server
  57
  58 Alternatively, you can download Ubuntu binary packages from:
  59 http://wpitchoune.net/psensor/files/ubuntu/
  60 The manual installation of the psensor and psensor-server packages
  61 requires also the installation of psensor-common which contains
  62 the multiple languages support.
  63
  64 Installation from source archive
  65 --------------------------------
  66
  67 Psensor compilation requires:
  68
  69  * make/gcc
  70  * lm-sensors
  71  * library sensors4
  72  * library gtk2
  73  * library gconf2
  74  * help2man
  75  * library libnotify (optional)
  76  * library libappindicator (optional)
  77  * library libXNVCtrl (optional)
  78  * library json0 and curl (optional, required for remote monitoring)
  79  * library unity (>=v3.4.2, optional)
  80
  81 Psensor-server compilation requires:
  82  * make/gcc
  83  * lm-sensors
  84  * library sensors4
  85  * help2man
  86  * library libmicrohttpd
  87  * library json0
  88  * library LUA5.1 (optional, required to enable HTML page generation
  89  of the psensor-server webserver)
  90  * library gtop2 (optional, required for CPU usage)
  91
  92 Compilation and Installation Steps
  93 ----------------------------------
  94
  95  * Extract files from the source archive
  96  * Compilation:
  97    ./configure
  98    make clean all
  99
 100  * Installation:
 101    make install
 102
 103  * Start the sensor detection script: 'sensors-detect' and follows the
 104 instructions
 105
 106  * Verify the sensor detection by running: 'sensors'
 107
 108  * Run 'psensor'
 109
 110 Contact
 111 -------
 112 Bugs and comments can be sent to wpitchoune@gmail.com
 113 Home page: http://wpitchoune.net/psensor