summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorManos Pitsidianakis <el13635@mail.ntua.gr>2019-10-26 08:56:41 +0300
committerManos Pitsidianakis <el13635@mail.ntua.gr>2019-10-26 08:56:41 +0300
commit2973194d9d1d9a9dc91f8824ae929dd1d0ed26a2 (patch)
tree7b0325f2ffb571fe3a8ae123f69499e662177352 /README.md
parenta487c4e01dd07e67449b69f1bab90d13c59b54d9 (diff)
Update README
Convert README to Markdown, add new shortcuts etc
Diffstat (limited to 'README.md')
-rw-r--r--README.md47
1 files changed, 47 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..71d2f89
--- /dev/null
+++ b/README.md
@@ -0,0 +1,47 @@
+## NAME
+ bb — your system's Big Brother
+
+## SYNOPSIS
+```
+ bb
+```
+
+## DESCRIPTION
+simple process viewer (for functionalities, 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
+```
+ 'F' Follow process and its children. Type the pid you want to follow
+ 'k' Kill process under cursor
+ Press Enter to confirm kill, or Esc to cancel
+ 'f' (un)freeze process list updates
+ '/' Filter process list
+ 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