{"id":18812220,"url":"https://github.com/blobfolio/adbyss","last_synced_at":"2025-06-29T00:33:34.585Z","repository":{"id":57105835,"uuid":"308212612","full_name":"Blobfolio/adbyss","owner":"Blobfolio","description":"Adbyss is a DNS blocklist manager for x86-64 Linux machines.","archived":false,"fork":false,"pushed_at":"2025-04-03T19:44:34.000Z","size":2174,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-12T13:45:50.214Z","etag":null,"topics":["adblock-list","adblocking","adblocking-dns","dns-blocking","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"wtfpl","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Blobfolio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"Blobfolio"}},"created_at":"2020-10-29T04:00:09.000Z","updated_at":"2025-04-03T19:38:53.000Z","dependencies_parsed_at":"2024-02-08T20:28:14.202Z","dependency_job_id":"0f55a293-8ed1-4756-ac86-8d88f8d1107f","html_url":"https://github.com/Blobfolio/adbyss","commit_stats":{"total_commits":524,"total_committers":1,"mean_commits":524.0,"dds":0.0,"last_synced_commit":"53ffd8cc12d320a73d110f2e833e471e5058869c"},"previous_names":[],"tags_count":86,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blobfolio%2Fadbyss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blobfolio%2Fadbyss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blobfolio%2Fadbyss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blobfolio%2Fadbyss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Blobfolio","download_url":"https://codeload.github.com/Blobfolio/adbyss/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248782261,"owners_count":21160717,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adblock-list","adblocking","adblocking-dns","dns-blocking","rust"],"created_at":"2024-11-07T23:30:54.649Z","updated_at":"2025-04-13T21:10:55.273Z","avatar_url":"https://github.com/Blobfolio.png","language":"Rust","readme":"# Adbyss\n\n[![ci](https://img.shields.io/github/actions/workflow/status/Blobfolio/adbyss/ci.yaml?style=flat-square\u0026label=ci)](https://github.com/Blobfolio/adbyss/actions)\n[![deps.rs](https://deps.rs/repo/github/blobfolio/adbyss/status.svg?style=flat-square\u0026label=deps.rs)](https://deps.rs/repo/github/blobfolio/adbyss)\u003cbr\u003e\n[![license](https://img.shields.io/badge/license-wtfpl-ff1493?style=flat-square)](https://en.wikipedia.org/wiki/WTFPL)\n[![contributions welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square\u0026label=contributions)](https://github.com/Blobfolio/adbyss/issues)\n\nAdbyss is a DNS blocklist manager for x86-64 Linux machines.\n\nWhile 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.\n\nAdbyss 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.\n\n\n\n## Installation\n\nDebian and Ubuntu users can just grab the pre-built `.deb` package from the [latest release](https://github.com/Blobfolio/adbyss/releases/latest).\n\nThis application is written in [Rust](https://www.rust-lang.org/) and can alternatively be built from source using [Cargo](https://github.com/rust-lang/cargo):\n\n```bash\n# See \"cargo install --help\" for more options.\ncargo install \\\n    --git https://github.com/Blobfolio/adbyss.git \\\n    --bin adbyss\n\n# Optional: download/save the advanced settings template so you can make\n# changes if/as needed.\nwget -qO- https://raw.githubusercontent.com/Blobfolio/adbyss/refs/heads/master/adbyss/skel/adbyss.yaml | \\\n    sudo tee /etc/adbyss.yaml \u003e/dev/null\n```\n\n\n\n## Usage\n\nIt's easy.\n\nAdvanced settings are stored in `/etc/adbyss.yaml`. Just grab, edit, and save the [default config](https://raw.githubusercontent.com/Blobfolio/adbyss/refs/heads/master/adbyss/skel/adbyss.yaml) to that location if you want to change anything.\n\nOtherwise, just run `sudo adbyss [FLAGS] [OPTIONS]`.\n\nThe following flags are available:\n\n| Short | Long | Description |\n| ----- | ---- | ----------- |\n| | `--disable` | Remove all Adbyss entries from the hostfile. |\n| `-h` | `--help` | Print help information and exit. |\n| `-q` | `--quiet` | Do *not* summarize changes after write. |\n| | `--show` | Print a sorted blackholable hosts list to STDOUT, one per line. |\n| | `--stdout` | Print the would-be hostfile to STDOUT instead of writing it to disk. |\n| `-V` | `--version` | Print program version and exit. |\n| `-y` | `--yes` | Non-interactive mode; answer \"yes\" to all prompts. |\n\nAnd the following option is available:\n\n| Short | Long | Value | Description |\n| ----- | ---- | ----- | ----------- |\n| `-c` | `--config` | `\u003cPATH\u003e` | Use this configuration instead of /etc/adbyss.yaml. |\n\nAfter 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.\n\nRestart your browser and/or computer and everything should be peachy again.\n\nIf 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.\n\nIt 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.\n\n\n\n## Automation\n\nThe repository contains two `systemd` scripts — a [timer](https://github.com/Blobfolio/adbyss/tree/master/adbyss/skel/systemd/adbyss.timer) and a [service](https://github.com/Blobfolio/adbyss/tree/master/adbyss/skel/systemd/adbyss.service) — that can be used to automatically update your `/etc/hosts` file once daily using the global settings (stored in `/etc/adbyss.yaml`).\n\nIf 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!\n\n```bash\nsudo systemctl enable adbyss.timer\nsudo systemctl start adbyss.timer\n```\n\nIf you built Adbyss manually, you'll need to manually copy both scripts to the appropriate `/etc/systemd` or `/usr/lib/systemd` subfolder and run:\n\n```bash\nsudo systemctl daemon-reload\nsudo systemctl enable adbyss.timer\nsudo systemctl start adbyss.timer\n```\n\n\n\n## Removal\n\nIf you're using the `systemd` service, be sure to stop and disable those scripts before doing anything else:\n\n```bash\nsudo systemctl stop adbyss.timer\nsudo systemctl disable adbyss.timer\n```\n\nThen 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:\n\n```bash\nadbyss --disable\n```\n\nSave, reboot, and you should be back to normal!\n","funding_links":["https://github.com/sponsors/Blobfolio"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblobfolio%2Fadbyss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblobfolio%2Fadbyss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblobfolio%2Fadbyss/lists"}