Adbyss is a DNS blocklist manager for x86-64 Linux machines.

While ad-blocking browser extensions are extremely useful, they only block unwatned content in the browser, and require read/write access to every page you visit, which adds overhead and potential security/privacy issues.

Adbyss instead writes "blackhole" records directly to your system's /etc/hosts file, preventing all spammy connection attempts system-wide. As this is just a text file, no special runtime scripts are required, and there is very little overhead.

Debian and Ubuntu users can just grab the pre-built .deb package from the latest release.

This application is written in Rust and can alternatively be built from source using Cargo:

# Clone the source.
git clone https://github.com/Blobfolio/adbyss.git

# Go to it.
cd adbyss

# Copy the configuration file.
sudo cp adbyss/misc/adbyss.yaml /etc

# Build as usual. Specify additional flags as desired.
cargo build \
    --bin adbyss \
    --release

(This should work under other 64-bit Unix environments too, like MacOS.)

It's easy.

Settings are stored in /etc/adbyss.yaml. Edit those as needed.

Otherwise, just run sudo adbyss [FLAGS] [OPTIONS].

The following flags are available:

And the following option is available:

After running Adbyss for the first time, you might find some web sites are no longer working as expected. Most likely you're blocking an evil dependency the web site thinks it needs. No worries, just open your browser's Network Dev Tool window and reload the page. Make note of any failing domain(s), and update the /etc/adbyss.yaml configuration accordingly.

Restart your browser and/or computer and everything should be peachy again.

If ads persist in displaying even after running Adbyss and rebooting, double-check the browser isn't bypassing your computer's local DNS records. (Firefox's DNS-Over-HTTPS feature sometimes does this.) Tweak your settings as needed and you should be back in business.

It is important to remember that scammers and capitalists birth new schemes all the time. It is a good idea to rerun Adbyss weekly or so to ensure your hosts list contains the latest updates.

The repository contains two systemd scripts — a timer and a service — that can be used to automatically update your /etc/hosts file once daily using the global settings (stored in /etc/adbyss.yaml).

If you installed Adbyss using the pre-built .deb package, all you need to do is enable and start the timer, then you can forget all about it!

sudo systemctl enable adbyss.timer
sudo systemctl start adbyss.timer

If you built Adbyss manually, you'll need to manually copy both scripts to the appropriate /etc/systemd or /lib/systemd subfolder and run:

sudo systemctl daemon-reload
sudo systemctl enable adbyss.timer
sudo systemctl start adbyss.timer

If you're using the systemd service, be sure to stop and disable those scripts before doing anything else:

sudo systemctl stop adbyss.timer
sudo systemctl disable adbyss.timer

Then to remove all blocked entries, you can either open the hostfile in an editor and remove the # ADBYSS # marker and all subsequent lines, or run:

adbyss --disable

Save, reboot, and you should be back to normal!

See also: CREDITS.md

Copyright © 2024 Blobfolio, LLC <hello@blobfolio.com>

This work is free. You can redistribute it and/or modify it under the terms of the Do What The Fuck You Want To Public License, Version 2.

DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
Version 2, December 2004

Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>

Everyone is permitted to copy and distribute verbatim or modified
copies of this license document, and changing it is allowed as long
as the name is changed.

DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

0. You just DO WHAT THE FUCK YOU WANT TO.