Skip to content

Commit ae0c972

Browse files
committed
Add Readme
1 parent 824d3f6 commit ae0c972

File tree

1 file changed

+84
-0
lines changed

1 file changed

+84
-0
lines changed

Readme.md

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
<div align="center">
2+
<h2> TUI for sniffing network traffic using eBPF </h2>
3+
</div>
4+
5+
## 📸 Demo
6+
7+
## ✨ Features
8+
9+
- Real-time traffic inspection and visualization.
10+
- Comprehensive Traffic Statistics.
11+
- Fuzzy search.
12+
13+
## 💡 Prerequisites
14+
15+
A Linux based OS.
16+
17+
> [!NOTE]
18+
> You might need to install [nerdfonts](https://www.nerdfonts.com/) for the icons to be displayed correctly.
19+
20+
## 🚀 Installation
21+
22+
### 📥 Binary release
23+
24+
You can download the pre-built binaries from the release page [release page](https://github.com/pythops/oryx/releases)
25+
26+
### ⚒️ Build from source
27+
28+
To build `oryx`:
29+
30+
1. Install Rust nightly toolchain
31+
32+
```
33+
rustup toolchain install nightly --component rust-src
34+
```
35+
36+
2. Install [bpf-linker](https://github.com/aya-rs/bpf-linker)
37+
38+
```
39+
cargo install bpf-linker
40+
```
41+
42+
3. Build
43+
44+
```
45+
cargo xtask build --release
46+
```
47+
48+
This will produce an executable file at `target/release/oryx` that you can copy to a directory in your `$PATH`.
49+
50+
## 🪄 Usage
51+
52+
Run the following command to start `oryx`:
53+
54+
```
55+
sudo oryx
56+
```
57+
58+
## ⌨️ Key Bindings
59+
60+
`?`: Show help.
61+
62+
`Tab` or `Shift + Tab`: Switch between different sections.
63+
64+
`j` or `Down` : Scroll down.
65+
66+
`k` or `Up`: Scroll up.
67+
68+
`esc`: Dismiss the different pop-ups and modes.
69+
70+
`q` or `ctrl + c`: Quit the app.
71+
72+
`Space`: Select/Deselect interface or filter.
73+
74+
`f`: Update the applied filters.
75+
76+
`ctrl + r`: Reset the app.
77+
78+
`ctrl + s`: Export the capture to `~/oryx/capture` file.
79+
80+
`/`: Start fuzzy finding.
81+
82+
## ⚖️ License
83+
84+
GPLv3

0 commit comments

Comments
 (0)