Skip to content

Commit

Permalink
Add Readme
Browse files Browse the repository at this point in the history
  • Loading branch information
pythops committed Sep 1, 2024
1 parent 824d3f6 commit ae0c972
Showing 1 changed file with 84 additions and 0 deletions.
84 changes: 84 additions & 0 deletions Readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
<div align="center">
<h2> TUI for sniffing network traffic using eBPF </h2>
</div>

## 📸 Demo

## ✨ Features

- Real-time traffic inspection and visualization.
- Comprehensive Traffic Statistics.
- Fuzzy search.

## 💡 Prerequisites

A Linux based OS.

> [!NOTE]
> You might need to install [nerdfonts](https://www.nerdfonts.com/) for the icons to be displayed correctly.
## 🚀 Installation

### 📥 Binary release

You can download the pre-built binaries from the release page [release page](https://github.com/pythops/oryx/releases)

### ⚒️ Build from source

To build `oryx`:

1. Install Rust nightly toolchain

```
rustup toolchain install nightly --component rust-src
```

2. Install [bpf-linker](https://github.com/aya-rs/bpf-linker)

```
cargo install bpf-linker
```

3. Build

```
cargo xtask build --release
```

This will produce an executable file at `target/release/oryx` that you can copy to a directory in your `$PATH`.

## 🪄 Usage

Run the following command to start `oryx`:

```
sudo oryx
```

## ⌨️ Key Bindings

`?`: Show help.

`Tab` or `Shift + Tab`: Switch between different sections.

`j` or `Down` : Scroll down.

`k` or `Up`: Scroll up.

`esc`: Dismiss the different pop-ups and modes.

`q` or `ctrl + c`: Quit the app.

`Space`: Select/Deselect interface or filter.

`f`: Update the applied filters.

`ctrl + r`: Reset the app.

`ctrl + s`: Export the capture to `~/oryx/capture` file.

`/`: Start fuzzy finding.

## ⚖️ License

GPLv3

0 comments on commit ae0c972

Please sign in to comment.