{"id":13467971,"url":"https://github.com/ZingerLittleBee/netop","last_synced_at":"2025-03-26T03:31:21.286Z","repository":{"id":37036418,"uuid":"497259846","full_name":"ZingerLittleBee/netop","owner":"ZingerLittleBee","description":"Network Top -- Help you monitor network traffic with bpf","archived":false,"fork":false,"pushed_at":"2025-03-10T21:52:30.000Z","size":2372,"stargazers_count":198,"open_issues_count":10,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-23T20:04:37.298Z","etag":null,"topics":["cli","network","rust","terminal","traffic"],"latest_commit_sha":null,"homepage":"https://crates.io/crates/netop","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ZingerLittleBee.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-28T08:32:04.000Z","updated_at":"2025-03-23T09:37:35.000Z","dependencies_parsed_at":"2024-02-08T20:29:58.449Z","dependency_job_id":"22bacf1f-9091-4442-a27b-210c7e98a533","html_url":"https://github.com/ZingerLittleBee/netop","commit_stats":{"total_commits":78,"total_committers":5,"mean_commits":15.6,"dds":0.4358974358974359,"last_synced_commit":"90b92f050cddb940dcc88276ef086b7441ee2284"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZingerLittleBee%2Fnetop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZingerLittleBee%2Fnetop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZingerLittleBee%2Fnetop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZingerLittleBee%2Fnetop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ZingerLittleBee","download_url":"https://codeload.github.com/ZingerLittleBee/netop/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245162190,"owners_count":20570692,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","network","rust","terminal","traffic"],"created_at":"2024-07-31T15:01:03.417Z","updated_at":"2025-03-26T03:31:21.239Z","avatar_url":"https://github.com/ZingerLittleBee.png","language":"Rust","funding_links":[],"categories":["Rust","terminal"],"sub_categories":[],"readme":"Language : 🇺🇸 English | [🇨🇳 简体中文](./README.zh-CN.md)\n\n\u003ch1 align=\"center\"\u003enetop\u003c/h1\u003e\n\u003cdiv align=\"center\"\u003e\n\n[![Docker Pulls](https://img.shields.io/docker/pulls/zingerbee/netop?style=flat-square)](https://hub.docker.com/r/zingerbee/netop)\n[![Docker Image Size](https://img.shields.io/docker/image-size/zingerbee/netop?style=flat-square)](https://hub.docker.com/r/zingerbee/netop/tags)\n[![Docker Image Version (latest by date)](https://img.shields.io/docker/v/zingerbee/netop?style=flat-square)](https://hub.docker.com/r/zingerbee/netop/tags)\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/ZingerLittleBee/netop/publish.yml?style=flat-square)](https://github.com/ZingerLittleBee/netop/actions)\n[![Last Commit](https://img.shields.io/github/last-commit/ZingerLittleBee/netop?style=flat-square)](https://github.com/ZingerLittleBee/netop/commits/main)\n[![LICENSE](https://img.shields.io/crates/l/netop?style=flat-square)](./LICENSE)\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"./snapshot/dashboard.gif\"\u003e\n\u003c/div\u003e\n\n## Overview\n`netop` is a terminal command line interface that can customize the filter **network traffic** rule 🎯\n\n### Features\n- Use the `bpf` rule filter\n- Multi-rule switching\n- Real-time rate\n- Total traffic\n- Response UI\n- Resource occupation is small, `rust` Written\n- Support `docker` deployment\n\n## Installation\n\n### Docker\n```bash\ndocker run -it --rm --net=host zingerbee/netop\n```\n\n\n### Cargo\nneed `rust` and `pcap`, detail look at [How to build](#How-to-build-from-source)\n```bash\n# install\nsudo cargo install netop\n# and then run\nnetop\n# or designated network interface card running\nnetop -n eth0\n```\n\n### NetBSD\nOn NetBSD there's an official package available.\nTo install a pre-compiled binary, simply run\n```bash\npkgin install netop\n```\n\nOr, if you prefer to build it from source,\n```bash\ncd /usr/pkgsrc/net/netop\nmake install\n```\n\n### Arch Linux\n[AUR](https://aur.archlinux.org/packages/netop)\n\u003e Thanks to @kemelzaidan for the contribution!\n\n## How to use\n\n- Press `e` to **enter edit mode** input [bpf rule](https://biot.com/capstats/bpf.html), and then press `enter`\n- Press `Esc` to **exit edit mode**\n- Use the `\u003c-` or `-\u003e` to switch between different rules\n- Not in edit mode, press `dd` to delete current rule\n- Not in edit mode, press `q` to quit\n\n### View help\n```bash\nnetop -h\n# docker\ndocker run -it --rm --net=host zingerbee/netop -h\n```\nOutput as follows\n```bash\nnetop 0.1.4\n\nUSAGE:\n    netop [OPTIONS]\n\nOPTIONS:\n    -h, --help           Print help information\n    -n, --name \u003cNAME\u003e    Name of Network Interface Card\n    -V, --version        Print version information\n```\n\n### Designated network interface card running\n\u003e The parameter is **name of network interface card**\n\u003e\n\u003e *unix: Use `ifconfig` to view network interface cards information\n\u003e\n\u003e windows: Use `ipconfig` to view network interface cards information\n```bash\nnetop -n eth0\n# docker\ndocker run -it --rm --net=host zingerbee/netop -n eth0\n```\n\n## How to build from source\nDevelopment environment\n- It is best to be `root` user, `pcap` requires permissions\n- `rust` \u003e= 1.40.0\n- `pcap`\n    - Ubuntu、Debian: `apt install libpcap-dev`\n    - MacOS: installed by default\n    - Windows: Download the [WinPcap](https://www.winpcap.org/install/default.htm) Developer's Pack. Add the /Lib or /Lib/x64 folder to your LIB environment variable.\n\n```bash\nsudo cargo install --path .\n# or\nsudo cargo run\n```\n\n## Found an issue or have a proposal\n[Create an issue](https://github.com/ZingerLittleBee/netop/issues)\n\n## Release Notes\nSEE [CHANGELOG](./CHANGELOG.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZingerLittleBee%2Fnetop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FZingerLittleBee%2Fnetop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZingerLittleBee%2Fnetop/lists"}