summaryrefslogtreecommitdiffstats
path: root/README.md
blob: bc894dba33e09a3fdd129a187e683e9ad552eaa6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
## NAME
     bb — your system's Big Brother

## SYNOPSIS
```
     bb
```

## DESCRIPTION
simple process viewer (for functionalities, press `h` within `bb` or see shortcuts below)

![screenshot](screenshot.png) 

## WHY
This is a "weekend" side-project made for fun, but it ended up somewhat useful and fast. Performance seems on par with `htop` without having done any benchmarks, however in contrast to `htop`, `bb` doesn't leave artifacts when it redraws the screen. I am not completely sure this is `htop`'s fault though, feel free to correct me.

## INSTALL
Prerequisites: [cargo](https://www.rust-lang.org/tools/install) >= 1.36, Linux

```
cargo install bb
```

## BUILD
     Prerequisites: rustc, cargo >= 1.36, Linux

     Execute `cargo build --release`, resulting binary will be in
     ./target/release/bb

## SHORTCUTS
```
      'h'   Toggle help overlay
      'F'   Follow process and its children. Type the pid you want to follow
      'L'   Highlight process. Type the pid you want to highlight
      'k'   Kill process under cursor
            Press Enter to confirm kill, or Esc to cancel
      'f'   (un)freeze process list updates
      '/'   Search process list
			'n'   Next search result
			'N'   Previous search result
      Space Filter process list
      't'   toggle tree view
      F1    toggles/activates username sorting
      F2    toggles/activates vm_rss sorting
      F3    toggles/activates cpu% sorting
      F4    toggles/activates cmd_line sorting
      Esc   Cancel action
```

## AUTHORS
     Copyright 2019 Manos Pitsidianakis <epilys@nessuent.xyz> Released
     under the GPL, version 3 or greater. This software carries no warranty of
     any kind. (See COPYING for full copyright and warranty notices.)

⟨ https://nessuent.xyz/ ⟩

                                 September 04, 2019