README 1.99 KB
Newer Older
1
[![Build Status](https://travis-ci.org/hishamhm/htop.svg?branch=master)](https://travis-ci.org/hishamhm/htop)
Hisham Muhammad's avatar
Hisham Muhammad committed
2
htop
Hisham Muhammad's avatar
Hisham Muhammad committed
3
4
====

5
by Hisham Muhammad <hisham@gobolinux.org> (2004 - 2016)
Hisham Muhammad's avatar
Hisham Muhammad committed
6

Hisham Muhammad's avatar
Hisham Muhammad committed
7
Introduction
Hisham Muhammad's avatar
Hisham Muhammad committed
8
------------
Hisham Muhammad's avatar
Hisham Muhammad committed
9

10
11
This is `htop`, an interactive process viewer.
It requires `ncurses`. It is developed primarily on Linux,
Hisham Muhammad's avatar
Hisham Muhammad committed
12
13
but we also have code for running under FreeBSD and Mac OS X
(help and testing are wanted for these platforms!)
Hisham Muhammad's avatar
Hisham Muhammad committed
14

Hisham Muhammad's avatar
Hisham Muhammad committed
15
This software has evolved considerably over the years,
Christian Hesse's avatar
Christian Hesse committed
16
and is reasonably complete, but there is always room for improvement.
Hisham Muhammad's avatar
Hisham Muhammad committed
17

18
Comparison between `htop` and classic `top`
Hisham Muhammad's avatar
Hisham Muhammad committed
19
-------------------------------------------
Hisham Muhammad's avatar
Hisham Muhammad committed
20

21
* In `htop` you can scroll the list vertically and horizontally
Hisham Muhammad's avatar
Hisham Muhammad committed
22
  to see all processes and full command lines.
23
* In `top` you are subject to a delay for each unassigned
Hisham Muhammad's avatar
Hisham Muhammad committed
24
25
  key you press (especially annoying when multi-key escape
  sequences are triggered by accident).
26
* `htop` starts faster (`top` seems to collect data for a while
Hisham Muhammad's avatar
Hisham Muhammad committed
27
  before displaying anything).
28
29
30
31
32
33
* In `htop` you don't need to type the process number to
  kill a process, in `top` you do.
* In `htop` you don't need to type the process number or
  the priority value to renice a process, in `top` you do.
* In `htop` you can kill multiple processes at once.
* `top` is older, hence, more tested.
Hisham Muhammad's avatar
Hisham Muhammad committed
34
35

Compilation instructions
Hisham Muhammad's avatar
Hisham Muhammad committed
36
------------------------
Hisham Muhammad's avatar
Hisham Muhammad committed
37
38

This program is distributed as a standard autotools-based package.
39
40
41
42
43
See the [INSTALL](/INSTALL) file for detailed instructions, but you are
probably used to the common routine:

    ./autogen.sh && ./configure && make

44
45
By default `make install` will install into `/usr/local`, for changing
the path use `./configure --prefix=/some/path`.
46
47
48
49
50
51
52
53
54

See the manual page (`man htop`) or the on-line help ('F1' or 'h'
inside `htop`) for a list of supported key commands.

If not all keys work check your curses configuration.

### Prerequisites

#### Debian/Ubuntu
Hisham Muhammad's avatar
Hisham Muhammad committed
55

56
    apt-get install build-essential libncursesw5-dev autotools-dev
Hisham Muhammad's avatar
Hisham Muhammad committed
57

58
## License
Hisham Muhammad's avatar
Hisham Muhammad committed
59

60
GNU General Public License, version 2 (GPL-2.0)