https://github.com/biswajitthakur/host-rs
A CLI tool that manage website blocking, unblocking, redirection.
https://github.com/biswajitthakur/host-rs
cli-app host rust web
Last synced: 5 months ago
JSON representation
A CLI tool that manage website blocking, unblocking, redirection.
- Host: GitHub
- URL: https://github.com/biswajitthakur/host-rs
- Owner: BiswajitThakur
- License: mit
- Created: 2024-02-04T04:01:22.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-02T14:27:11.000Z (6 months ago)
- Last Synced: 2024-12-02T14:41:22.903Z (6 months ago)
- Topics: cli-app, host, rust, web
- Language: Rust
- Homepage: https://crates.io/crates/host-rs
- Size: 118 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Host-RS
[](https://crates.io/crates/host-rs)
[](https://crates.io/crates/host-rs)
Blazingly fast CLI tool written in Rust to manage website blocking, unblocking, redirection.
## Features
- [x] **Block Website:** Add websites to blocklist to prevent access.
- [x] **Unblock Website:** Remove websites from the blocklist to allow access.
- [x] **Redirect Website:** Redirect traffic from one website to another.
- [x] **Add Host Sources:** Add host source (A url that contains a list of hostnames).
- [x] **Update Host Sources:** Update host sources.
- [x] **Import hosts:** Import hostnames stored in a file and block or unblock them.
- [x] **Export hosts:** Export the list of currently blocked or unblocked hosts.
## Installation
Ensure you have Rust installed (If you dont want to install Rust, install from precompiled binary).
## Linux & macOS
```bash
git clone https://github.com/BiswajitThakur/host-rs.git
cd host-rs/
./install.sh
```
## Other
```
cargo install host-rs
```
## **Usage**
- **Help**
```
> host-rs --help
This is a CLI tool to manage website blocking, unblocking, redirection.
Usage: host-rs [OPTIONS] [COMMAND]
Commands:
insert Add host or url to allow, block, redirect, sources list
remove Remove allow, block, redirect host and host sources
print Print allow, block, redirect, etc host and host sources
import Import host or url from file
export Expoer user data (you can import it later)
update Update sources or self
help Print this message or the help of the given subcommand(s)
Options:
--allow ... Add host to allow list & removed from block list
--block ... Add to block list & remove from allow list
--redirect ... Add to redirect list & remove from allow and block
--restore delete all host, host sources and restore /etc/hosts file
-h, --help Print help
-V, --version Print version
```
- **Block Website**
```bash
host-rs --block ...
```
- **Remove Website from Blocklist**
```bash
host-rs rm --block ...
# or
# host-rs remove --block ...
```
- **Allow Website**
use this when, you added hostsources and if it block some website and you don't want to block it.
```bash
host-rs --allow ...
```
- **Remove Website from Allow List**
```bash
host-rs rm --allow ...
```
- **Redirection**
In the following example, `` redirected to `` and `` redirected to ``
```bash
host-rs --redirect ...
```
- **Remove from Redirect**
```bash
host-rs rm --redirect ...
```
- **Add Host Sources**
You will get verious sources from [this](https://github.com/StevenBlack/hosts) repo.
```bash
host-rs insert --sources
```
- **Update Host Sources**
```bash
host-rs update --sources
```
- **Remove Host Sources**
```bash
host-rs remove --sources
```
- **Uninstall**
```bash
host-rs remove --self
```
## **Contributing**
Contributions are welcome! If you find any bugs, want to request a new feature or improve the code feel free to open an issue or submit a pull request.
## License
This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.