ONIOFF ~ Project

September 29, 2016

ONIOFF - Onion URL Inspector

ONIOFF Screenshot

A simple tool - written in pure python - for inspecting Deep Web URLs (or onions). It takes specified onion links and returns their current status along with the site's title.

The Idea

While checking out some exceedingly peculiar Deep Web Links, I was truly frustrated by the fact that more than half of the URLs I tried navigating to were not responding.

It was at that point that the brainstorming began. I thought - why not create a tool which effortlessly allows me to check which of the onion links are actually active. And that is precisely what I did. I created ONIOFF.


You can download ONIOFF by cloning the Git Repo and simply installing its requirements:

~ ❯❯❯ git clone https://github.com/k4m4/onioff.git
~ ❯❯❯ cd onioff
~/onioff ❯❯❯ pip install -r requirements.txt
~/onioff ❯❯❯ python onioff.py

NOTE: In order for ONIOFF to work, Tor must be correctly configured and running.


Usage: python onioff.py {onion} [options]
--version show program's version number and exit
-h, --help show this help message and exit
-f FILE, --file=FILE name of onion file
output filename
python onioff.py http://xmh57jrzrnw6insl.onion/
python onioff.py -f ~/onions.txt -o ~/report.txt
python onioff.py https://facebookcorewwwi.onion/ -o ~/report.txt

To view all available options run:

~/onioff ❯❯❯ python onioff.py -h


Here's a short demo:

(For more demos click here.)


Copyright © 2016 by Nikolaos Kamarinakis. Some rights reserved.

ONIOFF is under the terms of the MIT License, following all clarifications stated in the license file.


  • Nikolaos Kamarinakis (@nikolaskama)

You can contact me anytime at nikolaskam{at}gmail{dot}com. I will be more than grateful to hear any sort of feedback.