added follow button
[www.git] / src / psensor / index.adoc
index 3df983e..7219fd0 100644 (file)
@@ -1 +1,121 @@
-= psensor - A Graphical Temperature Monitoring Application
+= psensor
+:docinfo2:
+
+== A Graphical Temperature Monitoring Application
+
+++++
+<g:plusone></g:plusone>
+<div class="g-follow" data-annotation="bubble" data-height="20" data-href="//plus.google.com/u/0/100166747457211594542" data-rel="publisher"></div>
+++++
+
+`psensor` is a graphical hardware temperature monitor for Linux.
+
+It can monitor:
+
+- the temperature of the motherboard and CPU sensors (using http://www.lm-sensors.org/[lm-sensors]).
+- the temperature of the NVidia GPUs (using XNVCtrl).
+- the temperature of ATI/AMD GPUs (not enabled in Ubuntu PPAs or official
+  distribution repositories, see the link:README.html#_ati_amd_gpu_support[instructions for enabling its support]).
+- the temperature of the Hard Disk Drives (using hddtemp or libatasmart).
+- the rotation speed of the fans (using lm-sensors).
+- the CPU usage (since 0.6.2.10 and using Gtop2).
+
+image::http://wpitchoune.net/psensor/screenshots/psensor-last.png[]
+image::http://wpitchoune.net/psensor/screenshots/psensor-2011-06-16.png[]
+
+The application is designed to be simple and easy to use. The CPU and memory consumption are not significant.
+
+Psensor is released under GPLv2 license terms.
+
+== Usage Information
+
+First step is to install `lm-sensors`.
+
+For Ubuntu:
+
+[source,script]
+----
+sudo apt-get install lm-sensors
+----
+
+Then, starts the detection of your hardware sensors:
+
+[source,script]
+----
+sudo sensors-detect
+----
+
+Verify that it works:
+
+[source,script]
+----
+sensors
+----
+
+It should display something like:
+
+----
+coretemp-isa-0000
+Adapter: ISA adapter
+Core 0:      +46.0C  (high = +76.0C, crit = +100.0C)
+
+coretemp-isa-0001
+Adapter: ISA adapter
+Core 1:      +44.0C  (high = +76.0C, crit = +100.0C)
+
+...
+----
+
+Then you can proceed to the installation of `psensor`. For Ubuntu and derivatives,
+ you should look at the link:ubuntu.html[Ubuntu support page].
+
+And finally launch the `psensor` executable.
+
+More information are available in the link:faq.html[Psensor FAQ].
+
+== Source Code
+
+* link:files[Download psensor]
+* Get source from the GIT repository:
+----
+git clone http://git.wpitchoune.net/psensor.git
+----
+* link:http://git.wpitchoune.net/gitweb?p=psensor.git[Browse source code]
+
+== Linux Distribution Support
+
+`psensor` should compile on any modern distribution including `GTK+`
+v3 and `lm-sensors` which are quite common. For the Linux
+distributions still stuck on `GTK+` v2, the old 0.6.x releases of
+`psensor` can be used.
+
+If you have trouble compiling `psensor` on a specific Linux distribution,
+don’t hesitate to report it.
+
+Binary packages of `psensor` are available for few Linux distributions:
+
+* package for Ubuntu is in the official universe repository since version 11.10 (Oneiric)
+* http://packages.qa.debian.org/p/psensor.html[package for Debian] is in the standard repository since 7.0
+* https://launchpad.net/~jfi/+archive/ubuntu/ppa[PPA for Ubuntu]
+* http://software.opensuse.org/package/psensor[package for OpenSuse]
+* https://aur.archlinux.org/packages/psensor/[package for ArchLinux].
+
+== Misc
+
+* link:ubuntu.html[Psensor on Ubuntu]
+* link:remote.html[Remote monitoring]
+* link:contribute.html[How to contribute to psensor]
+* link:faq.html[FAQ]
+
+== Contact
+
+The Google Group https://groups.google.com/forum/?fromgroups&hl=en#!forum/psensor-users[psensor-users] can be used for discussion, questions and bug report.
+
+For announces or general information subscribe to Psensor https://plus.google.com/100166747457211594542[Google+ page]
+or click on:
+
+++++
+<div class="g-follow" data-annotation="bubble" data-height="20" data-href="//plus.google.com/u/0/100166747457211594542" data-rel="publisher"></div>
+++++
+
+Alternatively, you can contact me by e-mail: jeanfi@gmail.com.