A link scanner used for scanning .onion links
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Onion Scanner

Created: 2015-06-01
Author: Darkvengance
Version: 1.8
Updated: 2015-06-05

#Purpose Onion Scanner is a simple TOR Domain scanner. It has the ability to scan .onion domains from a list (with one domain per line) or, if no list is provided, it will scan all the links provided by Yet Another Tor Directory (YATD).

If you wish to can visit YATD yourself or you can use notEvil which is a DarkNet search engine. Keep in mind that if you use these they will not neccesarily give you active, working links.


iinputstringNoFile to read URLs from
ooutputstringYesDirectory to write lists to
vverboseboolNoEnables verbosity
uproxyurlstringNoThe URL for the HTTP Proxy to get to TOR [use privoxy]
pproxyportintNoThe port number for the HTTP Proxy to get to TOR [use privoxy]
ssaveboolNoIf set saves bad and seized links as well
ddescboolNoIf set saves site title with URLs
aagentstringNoThe User-Agent to emulate
nnumlinksintNoNumber of links to scan [0=all]

#Setup Since Onion Scanner currently has no method of utilizing a SOCKS5 proxy, it relys on some kind of HTTP proxy that has the ability to forward all traffic to TOR. The best proxy I have found to do the job is Privoxy.

In order to use privoxy with TOR you must first install Privoxy. Next edit the config file and search for the line

# forward-socks5 / localhost:9050 .

Uncomment this line and change the Port Number to whatever port TOR uses, now just configure a browser to use privoxy via HTTP Proxy to see if it's working. You can check over at TORCheck.

By default Onion Scanner uses port number 8118 and the url to connect to privoxy. You can change this using the -u and -p parameters respectively.

#Usage Once you have Onion Scanner setup, you can now run it using the paramters provided in the "Options" section. If you have a list of .onion URLs that you would like to scan, simply feed it into the program using the -i option. Just ensure that there is only 1 URL per line.

If you do not have a list of URLs, Onion Scanner will grab all the URLs from YetAnotherTorDirectory and check them. It could take quite some time since (at the time of this writing) there are well over 8k URLs.