https://github.com/juancarlospaco/nim-dnsprotec

DNS /etc/hosts file manager, Block 1 Million malicious domains with 1 command
https://github.com/juancarlospaco/nim-dnsprotec

alpine antispam arch-linux dns docker hosts-file hosts-file-edit hostsfile linux mac

Last synced: 7 months ago
JSON representation

DNS /etc/hosts file manager, Block 1 Million malicious domains with 1 command

• Host: GitHub
• URL: https://github.com/juancarlospaco/nim-dnsprotec
• Owner: juancarlospaco
• License: mit
• Created: 2019-10-30T18:55:13.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2019-11-04T10:55:51.000Z (almost 6 years ago)
• Last Synced: 2025-04-12T00:42:45.912Z (7 months ago)
• Topics: alpine, antispam, arch-linux, dns, docker, hosts-file, hosts-file-edit, hostsfile, linux, mac
• Language: Nim
• Homepage:
• Size: 125 KB
• Stars: 9
• Watchers: 5
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# DNS Protec

![](https://img.shields.io/github/languages/top/juancarlospaco/nim-dnsprotec?style=for-the-badge)

![](https://img.shields.io/github/languages/count/juancarlospaco/nim-dnsprotec?logoColor=green&style=for-the-badge)

![](https://img.shields.io/github/stars/juancarlospaco/nim-dnsprotec?style=for-the-badge "Star nim-dnsprotec on GitHub!")

![](https://img.shields.io/maintenance/yes/2019?style=for-the-badge "2019")

![](https://img.shields.io/github/languages/code-size/juancarlospaco/nim-dnsprotec?style=for-the-badge)

![](https://img.shields.io/github/issues-raw/juancarlospaco/nim-dnsprotec?style=for-the-badge "Bugs")

![](https://img.shields.io/github/issues-pr-raw/juancarlospaco/nim-dnsprotec?style=for-the-badge "PRs")

![](https://img.shields.io/github/commit-activity/y/juancarlospaco/nim-dnsprotec?style=for-the-badge)

![](https://img.shields.io/github/last-commit/juancarlospaco/nim-dnsprotec?style=for-the-badge "Commits")

- DNS `/etc/hosts` file manager, Block 1 Million malicious domains on 1 command.

- 1 File, 0 Dependency, no config, no setup, works Offline, for any Linux, 60 lines of code.

- Does **NOT overwrite `/etc/hosts` by default**, Backup by default, can delete itself (for Docker), runs on Alpine.

![](https://raw.githubusercontent.com/juancarlospaco/nim-dnsprotec/master/temp.png "Does NOT run 'sudo mv', just prints the command for you")

# Use

```

$ dnsprotec

```

- If you reply `n` to everything it gives you your current `/etc/hosts` file.

# Download

- https://github.com/juancarlospaco/nim-dnsprotec/releases

# Install

- `nimble install dnsprotec`

# Compile

```

$ nim c dnsprotec.nim

```

- Force overwriting of `/etc/hosts` with `-d:overwrite`.

- Your current `/etc/hosts` will be statically read as a base template for new host files.

- Compilation requires Internet, but after that it works 100% Offline.

- You can add your custom local or remote DNS Blacklists on `hosts` file format, separated by comma:

```

-d:customUrls="http://foo.io/hosts,http://bar.io/blacklist,http://127.0.0.1/blockedDNS"

```

# Spotify

As a side-effect, Spotify desktop app behaves like Premium, it will not show Ads, but plays music.

If it stops playing music disable the DNS protec, use it for a while, and you can enable it back later,

it seems from time to time it checks with Spotify servers, but yeah Spotify Premium for free ;)

# Why

I know there are other scripts, but those need a virtual machine or interpreter,

and need to be online to work properly, I needed one that can work offline and standalone.

# Stars

![Star nim-dnsprotec on GitHub](https://starchart.cc/juancarlospaco/nim-dnsprotec.svg "Star nim-dnsprotec on GitHub!")