Skip to content
/ oryx Public

🕵️‍♂️ TUI for sniffing network traffic using eBPF on Linux

License

Notifications You must be signed in to change notification settings

pythops/oryx

Folders and files

NameName
Last commit message
Last commit date

Latest commit

db22351 · Mar 19, 2025

History

48 Commits
Sep 1, 2024
Mar 10, 2025
Mar 8, 2025
Mar 10, 2025
Mar 19, 2025
Sep 1, 2024
Oct 17, 2024
Mar 19, 2025
Mar 10, 2025
Oct 17, 2024
Sep 2, 2024
Mar 10, 2025
Mar 10, 2025
Oct 17, 2024

Repository files navigation

TUI for sniffing network traffic using eBPF

📸 Demo

✨ Features

  • Real-time traffic inspection and visualization.
  • Comprehensive Traffic Statistics.
  • Firewall functionalities.
  • Metrics explorer.
  • Fuzzy search.

💡 Prerequisites

A Linux based OS.

Note

You might need to install nerdfonts for the icons to be displayed correctly.

🚀 Installation

📥 Binary release

You can download the pre-built binaries from the release page release page

🐧Arch Linux

You can install oryx from the AUR with using an AUR helper.

paru -S oryx

⚒️ Build from source

To build oryx:

1. Install Rust nightly toolchain

rustup toolchain install nightly --component rust-src

2. Install bpf-linker

Check bpf-linker Installation section .

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

Note

You can start oryx with args as well. Check oryx --help to see the available options

⌨️ 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.

Inspection Section

i: Show more infos about the selected packet.

/: Start fuzzy search.

Firewall Section

Space: Toggle firewall rules status.

n : Add new firewall rule.

e: Edit a firewall rule.

s: Save firewall rules to ~/oryx/firewall.json

Enter: Create or Save a firewall rule.

⚖️ License

GPLv3