{"id":48116578,"url":"https://github.com/astrovm/hosty","last_synced_at":"2026-04-04T16:16:15.277Z","repository":{"id":21485370,"uuid":"24804178","full_name":"astrovm/hosty","owner":"astrovm","description":"System-wide ad blocker for Linux/Unix/BSD/Mac","archived":false,"fork":false,"pushed_at":"2025-11-03T14:24:02.000Z","size":362,"stargazers_count":156,"open_issues_count":0,"forks_count":11,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-01-14T03:48:52.921Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://4st.li/hosty/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/astrovm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2014-10-04T23:25:05.000Z","updated_at":"2026-01-12T06:48:07.000Z","dependencies_parsed_at":"2025-08-03T06:21:07.018Z","dependency_job_id":"d828e70e-844a-4ddd-a6cc-773f145904bf","html_url":"https://github.com/astrovm/hosty","commit_stats":null,"previous_names":["astrovm/hosty","astrolince/hosty","juankfree/hosty"],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/astrovm/hosty","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astrovm%2Fhosty","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astrovm%2Fhosty/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astrovm%2Fhosty/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astrovm%2Fhosty/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/astrovm","download_url":"https://codeload.github.com/astrovm/hosty/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astrovm%2Fhosty/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31405699,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-04-04T16:16:14.727Z","updated_at":"2026-04-04T16:16:15.226Z","avatar_url":"https://github.com/astrovm.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hosty\n\n[![GitHub code size](https://img.shields.io/github/languages/code-size/astrovm/hosty.svg)\n![GitHub last commit](https://img.shields.io/github/last-commit/astrovm/hosty.svg)\n![GitHub license](https://img.shields.io/github/license/astrovm/hosty.svg)\n![GitHub watchers](https://img.shields.io/github/watchers/astrovm/hosty.svg?label=Watch\u0026style=social)\n![GitHub stars](https://img.shields.io/github/stars/astrovm/hosty.svg?label=Star\u0026style=social)\n![GitHub forks](https://img.shields.io/github/forks/astrovm/hosty.svg?label=Fork\u0026style=social)](https://github.com/astrovm/hosty)\n\nSystem-wide ad blocker for Linux/Unix/BSD/Mac.\n\nHosty aims to block annoying things designed to steal time like ads, dangerous software such as spyware and things that harms user privacy. By default it works by downloading a predefined list of domains to block and adding them to the hosts file of your system (keeping the existing rules intact).\n\nIn the predefined list we don't accept political censorship or paternalistic goals like blocking porn or gambling, we don't accept anything that harms user freedom.\n\n![Comparison of total memory usage](https://i.imgur.com/qRVKMOQ.png)\n\n## Installation\n\n### Requirements\n\n- curl\n- awk\n- crontab (optional for automatic hosts file update)\n\n### Install the requirements\n\n- **Ubuntu/Mint/Pop/Debian:**\n  `$ sudo apt install curl gawk cron`\n\n- **Arch/Manjaro/Endeavour:**\n  `$ sudo pacman -S --needed curl gawk cronie`\n\n- **Fedora/RHEL/Rocky:**\n  `$ sudo dnf in curl gawk cronie`\n\n### Install hosty\n\nJust run:\n\n`$ curl -L https://4st.li/hosty/install.sh | sh`\n\nYou will be asked if you want to automatically run hosty to update your hosts file with the latest domains list.\n\n## Run hosty\n\nEnable system-wide ad blocking with:\n\n`$ sudo hosty`\n\nYou probably want to run it periodically to update your hosts file with latest domains list.\n\n## Automatic run configuration\n\nHosty can be configured to periodically update your hosts file with:\n\n`$ sudo hosty -a (--autorun)`\n\nIt will ask how often you want to execute it and change your crontab.\n\n## Blacklist\n\nHosty will keep your hosts file modifications if you don't write them below the indicated line, but you can also use a blacklist.\n\nAdd the domains to block editing the file `/etc/hosty/blacklist` (with root permissions), one domain name per line:\n\n```\nfacebook.com\nwwww.facebook.com\n```\n\n## Whitelist\n\nYou can include exceptions editing the file `/etc/hosty/whitelist` (with root permissions), one domain name per line:\n\n```\n4st.li\nwww.4st.li\n```\n\n## Custom sources\n\nIf you want to add additional custom sources from the internet, create a text file in:\n\n`/etc/hosty/blacklist.sources` for files with domains to block\n\nor/and\n\n`/etc/hosty/whitelist.sources` for files with domains to unblock\n\nand write in them one url per line:\n\n`https://www.malwaredomainlist.com/hostslist/hosts.txt`\n\nHosty will take all domains separated by some symbol, space or new line, so it supports hosts-style files and files with just domains.\n\nABP, uBlock Origin, Brave and AdGuard files are accepted too, but take in account that ANY not-commented domain will be used, so it's safer to use them in whitelists than in blacklists (a website that you don't want to block can end up blocked if exists in the file).\n\nYou can also run hosty using ONLY your custom sources with:\n\n`$ sudo hosty -i (--ignore-default-sources)`\n\nand you can config autorun to run that way too:\n\n`$ sudo hosty -ai (--autorun --ignore-default-sources)`\n\nKeep in mind that this is an advanced function that we do not recommend using, hosty is designed and tested to be used with the default configuration and in that way we believe that it will give you the best experience.\n\n## Restore your original hosts file\n\nIf you want to disable hosty ad blocking:\n\n`$ sudo hosty -r (--restore)`\n\n## Read the modified hosts without modifying your system\n\nYou can debug what hosty will do to your system with:\n\n`$ hosty -d (--debug)`\n\n## Uninstalling hosty\n\nIf you don't use it anymore:\n\n`$ sudo hosty -u (--uninstall)`\n\nIf you want to restore your original hosts file, run that option first.\n\n## Development\n\nContributions are welcome. Before submitting changes:\n\n- Format scripts with `shfmt -i 4 -ci -sr -w *.sh`\n- Lint scripts with `shellcheck hosty.sh install.sh`\n- Smoke test with `./hosty.sh -d` and `./hosty.sh -di`\n\nThese steps help ensure consistent style and basic correctness.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastrovm%2Fhosty","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fastrovm%2Fhosty","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastrovm%2Fhosty/lists"}