Getting Started

Installation

Installing throne is easy! You'll need a couple prerequisites to install today.

• Git
• Python >= 3.6
• Pip (for python3) >= 9.0.3

Prerequisite Install

RHEL/CentOS

sudo yum install -y git python3 python3-pip

Additionally, if you're running CentOS 8+ you can install using dnf:

sudo dnf install -y git python3 python3-pip

Debian/Ubuntu

sudo apt install -y git python3.6-dev python3-pip

Throne Installation

PyPi

You can install throne from PyPi using the command below.

pip install throne

Installing from PyPi

When installing throne from PyPi to a WSL machine, you may need to add /home/$USER/local/.bin to your path variable. This can be done by doing export PATH="/home/$USER/local/.bin:$PATH". Make sure to replace $USER with the username you're installing under on your system. Your system may not have the $USER variable set.

From Source

Once you have the prerequisites installed you can clone the repository

git clone https://github.com/throne/throne-cli

After the repository is cloned, go into its folder and run pip3 setup.py .

cd throne-cli

pip3 setup.py .

Installing from source

When installing throne from source, ensure you're using pip/pip3 setup.py . and not python/python3 setup.py install. Running the latter will cause errors when attempting to run the throne command. If you do install using the python install version you can run the pip version afterwards to overwrite and resolve errors.

Congratulations!

You've officially installed throne! It can now be executed just by running throne from the CLI.

[user@throne ~] throne
Usage: throne [OPTIONS] COMMAND [ARGS]...

  Throne is a command line tool to query various things on the internet.

Options:
  -v, --verbose  Enables verbose mode.
  --help         Show this message and exit.

Commands:
  api     Retrieve API keys from the throne API
  bgp     Retrieve BGP related information.
  ip      Retrieve IP related information.
  pdb     Retrieve information from PeeringDB.
  shodan  Retrieve information from Shodan.
  whois   Retrieve WHOIS information on domains.