author+date
[www.git] / src / psensor / ubuntu.adoc
1 = Psensor Ubuntu Support
2 :docinfo2:
3 :icons: font
4
5 == Specific Features On Ubuntu
6
7 Psensor has few specific features to improve the user experience on Ubuntu.
8
9 image::screenshots/psensor-2011-06-16.png[]
10
11 === Application Indicator Support
12
13 The Application Indicator is providing a quick access to sensor values and
14  settings. When a sensor temperature is too much hot, a desktop notification
15   bubble appears and the Application Indicator icon is changed to a red one.
16
17 Psensor graph window can be closed and raised by using the ‘show’ menu. It is also possible to hide the graph window at startup.
18
19 === Integration With Unity Desktop Environment
20
21 The Unity Launcher of Psensor can display the higher temperature.
22
23 == How To Install Psensor On Ubuntu
24
25 === Stable Version
26
27 For Ubuntu Karmic(9.10), Lucid(10.04), Maverick(10.10) and Natty(11.04) the recommended way is to use the stable PPA:
28
29 ----
30 sudo apt-add-repository ppa:jfi/ppa
31 sudo apt-get update
32 sudo apt-get install psensor
33 ----
34
35 Since Oneiric, Psensor is available in the official Ubuntu repository. The stable version of Psensor can be installed without adding any PPAs. The Ubuntu Software Center can be used, or the following command line:
36
37 ----
38 sudo apt-get install psensor
39 ----
40
41 === Development Version
42
43 The development version is providing the last features and should not have any major bugs. It can be installed by using a dedicated PPA with the following command lines:
44
45 ----
46 sudo apt-add-repository ppa:jfi/psensor-unstable
47 sudo apt-get update
48 sudo apt-get install psensor
49 ----
50
51 === Daily Snapshot
52
53 Each day a package is automatically built directly from the source repository. The purpose of this daily build is to test Psensor and report bugs.  It can be installed by using a dedicated PPA with the following command lines:
54
55 ----
56 sudo apt-add-repository ppa:jfi/psensor-daily-trunk
57 sudo apt-get update
58 sudo apt-get install psensor
59 ----
60
61 === Installation From Source Archive
62
63 Of course, it is also possible to compile and install Psensor from the source archive. There is no real benefit except to tune compilation settings or hack the source code.
64
65 First, all build prerequisites must be installed:
66
67 ----
68 sudo apt-get install autoconf automake gettext autopoint
69                      libgtk2.0-dev libgconf2-dev libnotify-dev
70                      libsensors4-dev help2man libcurl4-openssl-dev
71                      libjson0-dev libmicrohttpd-dev
72                      libgtop2-dev perl libunity-dev libgtop2-dev
73                      libappindicator-dev nvidia-settings
74 ----
75
76 Downloads the source archive from: http://wpitchoune.net/psensor/files/.
77
78 Extracts the content of the archive, and from the created directory, compiles psensor:
79
80 ----
81 ./configure
82 make clean all
83 ----
84
85 And finally install `psensor`:
86
87 ----
88 sudo make install
89 ----