# Bbot (otlite)

The recursive internet scanner for hackers.

- Takes: Domain, IP address
- Install: `otlite install bbot`, into its own virtualenv
- Pinned: [bbot==3.0.2](https://pypi.org/project/bbot/3.0.2/)
- Command: `bbot`
- Python: any otlite runs on (3.10 or newer)
- Verified: 24 Sept 2026, version 3.0.2 on Ubuntu 26.04 LTS, Python 3.12.14
- Licence: AGPL-3.0; 10,616 GitHub stars
- Source: https://github.com/blacklanternsecurity/bbot

otlite is the no-Docker edition of OTInstaller for Linux and macOS: [install it](https://otinstaller.com/otlite) with `curl -fsSL https://get.otinstaller.com/otlite | sh`.

## Run it

| Input | otlite command | Bbot receives |
| --- | --- | --- |
| Domain | `otlite run bbot -- d:example.com` | `bbot -y -p subdomain-enum -t example.com` |
| IP address | `otlite run bbot -- ip:192.0.2.1` | `bbot -y -p subdomain-enum -t 192.0.2.1` |

Arguments after `--` that aren't typed inputs go to the tool unchanged.

## What a run leaves

- `results/bbot/example.com/<time>_bbot_example.com_<run id>.txt`
- `results/bbot/example.com/<time>_bbot_example.com_<run id>.meta.json`
- `results/bbot/example.com/<time>_bbot_example.com_<run id>.envelope.json`

The envelope is the same shape for every tool: the tool and version, the input, timing, exit code and status, the emails, domains, IP addresses and URLs found in the output, and the output file's path, hash and size. `otlite results --tool bbot` lists saved runs, `otlite extract bbot` pulls out indicators and `otlite diff bbot example.com` compares the two latest runs.

## With other tools

`otlite run --all d:example.com` and `otlite auto example.com` run it with every other installed tool that takes the same input.

## Related tools

- [Spiderfoot](https://otinstaller.com/otlite/tools/spiderfoot.md): SpiderFoot automates OSINT for threat intelligence and mapping your attack surface
- [Dnstwist](https://otinstaller.com/otlite/tools/dnstwist.md): Domain name permutation engine for detecting homograph phishing attacks, typo squatting, and brand impersonation
- [Ivre](https://otinstaller.com/otlite/tools/ivre.md): Network recon framework
- [Finalrecon](https://otinstaller.com/otlite/tools/finalrecon.md): All In One Web Recon
- [Fierce](https://otinstaller.com/otlite/tools/fierce.md): A DNS reconnaissance tool for locating non-contiguous IP space
- [Secator](https://otinstaller.com/otlite/tools/secator.md): secator - the pentester's swiss knife

[All 47 otlite tools](https://otinstaller.com/otlite/tools) · [otlite docs](https://otinstaller.com/docs/otlite.md)