xn-twist 1.3.0

Stable release

To install XN Twist, run this command in your terminal:

pip install xn-twist

This is the preferred method to install XN Twist, as it will always install the most recent stable release.

If you don’t have pip installed, this Python installation guide can guide you through the process.

From sources

The sources for XN Twist can be downloaded from the Github repo.

You can either clone the public repository:

$ git clone git://github.com/xn-twist/xn-twist

Or download the tarball:

$ curl  -OL https://github.com/xn-twist/xn-twist/tarball/master

Once you have a copy of the source, you can install it with:

$ python setup.py install

Via Python

You can use XN-Twist in a script as follows:

from xn_twist import XNTwist
xn = XNTwist()
twist_results = xn.twist('example.com')

There is an optional limit value that can be passed into the twist function to limit the number of characters used as a spoofs. This cuts down on the processing load and makes the results manageable. An example usage is shown below.

from xn_twist import XNTwist
xn = XNTwist()
twist_results = xn.twist('example.com', limit=2)

The response will be json that looks something like:

{
    "datetime": "2018-04-06 05:33:45.889048",
    "possible_squats": [
        {
            "displayed": "\u0430.com",
            "punycode": "xn--80a.com"
        },
        {
            "displayed": "\u0105.com",
            "punycode": "xn--2da.com"
        },
        {
            "displayed": "\u03ac.com",
            "punycode": "xn--hxa.com"
        },
        {
            "displayed": "\u00e1.com",
            "punycode": "xn--1ca.com"
        },
        {
            "displayed": "\u01ce.com",
            "punycode": "xn--tja.com"
        },
        {
            "displayed": "\u1f05.com",
            "punycode": "xn--ing.com"
        },
        {
            "displayed": "\u01df.com",
            "punycode": "xn--bka.com"
        },
        {
            "displayed": "\u1f00.com",
            "punycode": "xn--dng.com"
        },
        {
            "displayed": "\u1f01.com",
            "punycode": "xn--eng.com"
        },
        {
            "displayed": "\u00e4.com",
            "punycode": "xn--4ca.com"
        }
    ],
    "count": 10,
    "xn_twist_version": "1.2.0"
}

Via Command Line

You can use XN-Twist from the command line as follows:

xntwist example.com

The usage for the command line form of XN-Twist is as follows:

XN Twist.

Usage:
    xntwist <domain> [--limit=LIMIT] [--dns] [--output=OUTPUT]
    xntwist (-h | --help)
    xntwist --version

Options:
    -h --help     Show this screen.
    --version     Show version.
    -l=LIMIT --limit=LIMIT    Limit the number of characters used as spoofs [default: 5].
    -d --dns  Query DNS for each domain.
    -o=OUTPUT --output=OUTPUT  Specify an output file.