StevenBlack/ghosts is one of the developer-focused repositories TopGit tracks, currently at 103 stars, written primarily in Go. 🔎 A CLI to mess with hosts files and domain lists, local or remote. It's written in Go.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
ghosts is a utility to evaluate, compare, and format hosts files. It's written in Go.
Here is what ghosts does:
Summarize any hosts file retrieved over HTTP, or from a local file.
Compare two hosts files, and determine their intersection.
Compare a reference hosts file with a list of hosts presently in your system clipboard.
List the tally of TLDs in the hosts file.
Output the hosts as a plain list of domains, or with IP4 pefix.
Sort the hosts coherently by domain, TLD, subdomain, subsubdomain, and so on.
Getting started
Get help just as you might expect
$ ghosts -h
Usage of ghosts:
-c string
Hosts list to compare.
A shortcut code, full URL, or a local file.
Use the -m option for the main comparison list.
Use the -clip option to use what is on the system clipboard.
Shortcut codes
==============
The following shortcut codes can be used to select among preset main lists.
Amalgamated lists' shortcuts:
-c b or -m base // use Steven Black's base amalgamated list.
-c f // use alternates/fakenews/hosts
-c fg // use alternates/fakenews-gambling/hosts
-c fgp // use alternates/fakenews-gambling-porn/hosts
-c fgps // use alternates/fakenews-gambling-porn-social/hosts
-c fgs // use alternates/fakenews-gambling-social/hosts
-c fp // use alternates/fakenews-porn/hosts
-c fps // use alternates/fakenews-porn-social/hosts
-c fs // use alternates/fakenews-social/hosts
-c g // use alternates/gambling/hosts
-c gp // use alternates/gambling-porn/hosts
-c gps // use alternates/gambling-porn-social/hosts
-c gs // use alternates/gambling-social/hosts
-c p // use alternates/porn/hosts
-c ps // use alternates/porn-social/hosts
-c s // use alternates/social/hosts
Source lists' shortcuts:
-c adaway // adaway.github.io
-c add2o7net // FadeMind add.2o7Net hosts
-c adddead // FadeMind add.Dead hosts
-c addrisk // FadeMind add.Risk hosts
-c addspam // FadeMind add.Spam hosts
-c adguard // AdguardTeam cname-trackers
-c baddboyz // mitchellkrogza Badd-Boyz-Hosts
-c clefspear // Clefspeare13 pornhosts
-c digitalside // davidonzo Threat-Intel
-c fakenews // marktron/fakenews
-c hostsvn // bigdargon hostsVN
-c kadhosts // PolishFiltersTeam
-c metamask // MetaMask eth-phishing hosts
-c mvps // winhelp2002.mvps.or
-c orca // orca.pet notonmyshift hosts
-c shady // hreyasminocha shady hosts
-c sinfonietta-gambling
-c sinfonietta-porn
-c sinfonietta-snuff
-c sinfonietta-social
-c someonewhocares // Sam Pollock someonewhocares.org
-c stevenblack // Steven Black ad-hoc list
-c tiuxo-porn
-c tiuxo-social
-c tiuxo // tiuxo list.
-c uncheckyads // FadeMind UncheckyAds
-c urlhaus // urlhaus.abuse.ch
-c yoyo // Peter Lowe yoyo.org
-clip
The comparison hosts are in the system clipboard
-d Include default hosts at the top of file.
-intersection
Return the list of intersection hosts? (default false)
-ip string
Localhost IP address (default "0.0.0.0")
-m string
The main list of hosts to analyze, or serve as a basis for comparison.
A shortcut code, a full URL, or a local file.
See the -c flag for the list of shortcut codes. (default "base")
-noheader
Remove the file header from output? (default false)
-o Return the list of hosts? (default false)
-p Return a plain output list of hosts, with no IP address prefix? (default false)
-root
Return the list of root domains and their tally (default false)
-s Sort the hosts? (default false)
-stats
display stats? (default true)
-tld
Return the list of TLD and their tally (default false)
-unique
List the unique domains in the comparison list
-v Return the current version
Summarize statistics from any hosts file
If you specify no hosts file, by default a summary of StevenBlack/hosts is produced.
Compare two hosts files, local or remote, and assess their intersection by specifying -m <location> option for the main hosts file and -c <location> option for the second comparison file.
Let's compare the someonewhocares.org hosts file (15,474 domains) to the one at mvps.org (8,730 domains). The basic report tells us there are 1,354 domains in the interseation of the two.
Here we use shortcut presets to specify the two lists to compare, but we could have specified full URLs for either source.
Compare two hosts files, local or remote, and LIST their intersection by specifying -m <location> option for the main hosts file, -c <location> option for the second comparison file, and add the --intersection flag to get the detailed list of the intersecting domains.
Let's compare the someonewhocares.org hosts file (14,401 domains) to the one at mvps.org (10,473 domains). The basic report shows us all 1,548 domains in the interseation of the two.
Here we use shortcut presets to specify the two lists to compare, but we could have specified full URLs for either source.
Compare two hosts files, local or remote, and list what's unique in the second file by specifying -m <location> option for the main hosts file, -c <location> option for the second comparison file, and add the --unique flag to get the list of domains in the comparison file that are not in the main hoss file.
Output a list of domains in hosts format, or as a plaintext list
To list domains, use the -o [optional file] option. If you provide no file mame, the list goes to stdout.
To sort the domains, use the -s flag.
Hosts format output
The output is in hosts format by default. The default IP address is 0.0.0.0, and you can change that with the -ip option. for example, -ip 127.0.0.1 will list the hosts with a 127.0.0.1 prefix.
The hosts output will include the header of the original source file. This header typically includes information about the author, and sometimes includes a copyright statement. To not include the header, use the -noheader flag.
To include the list of default hosts at the top of the hosts output, use the d flag. By default the list of hosts does not include the loopback hosts at the top of the list.
These are the default hosts that will be included with the -d flag.
The most recent commit recorded on StevenBlack/ghosts was 5.1 years ago, based on the GitHub push timestamp. The repository has 12 forks — one of the better signals of community interest.
How many stars does StevenBlack/ghosts have?
StevenBlack/ghosts has 103 GitHub stars — refresh the page for the live number, or check github.com/StevenBlack/ghosts. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is StevenBlack/ghosts open source?
Yes — StevenBlack/ghosts ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/StevenBlack/ghosts.
What else is in the Developer Tools space?
StevenBlack/ghosts is tracked by TopGit under the Developer Tools category, alongside 3 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is StevenBlack/ghosts?
StevenBlack/ghosts (StevenBlack/ghosts) is a Go project on GitHub. From the project's own README: 🔎 A CLI to mess with hosts files and domain lists, local or remote. It's written in Go.
What language is StevenBlack/ghosts written in?
StevenBlack/ghosts is written primarily in Go. GitHub's language field is based on the largest share of bytes in the default branch.
What license does StevenBlack/ghosts use?
StevenBlack/ghosts is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where do I read more about StevenBlack/ghosts?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/StevenBlack/ghosts is the definitive source.
Read full README in the tab above.
Still deciding about ghosts?
One click hands the question to an AI along with this page — see what it says about ghosts.