iptui

A terminal IP toolkit with 52 tools and ASCII art.

Pure Python standard library, zero dependencies. Works as an interactive TUI or a quick CLI.

 ___ ____ _____ _   _ ___
|_ _|  _ \_   _| | | |_ _|
 | || |_) || | | | | || |
 | ||  __/ | | | |_| || |
|___|_|    |_|  \___/|___|

✨ Features

• 🌐 52 networking tools — geolocation, DNS, WHOIS, port scan, subnet math and more
• 🖥 Interactive TUI with arrow-key navigation and scrollable output
• ⚡ Quick CLI — run any tool directly with arguments
• 📡 Graceful offline handling for tools that need the internet
• 🪶 Zero dependencies — pure Python 3 standard library

📥 Installation

git clone https://github.com/wetair1/iptui
cd iptui
pip install .

Or just run it directly:

python3 iptui.py

Requires Python 3.8+, no third-party packages.

🚀 Usage

iptui                 # launch the interactive TUI
iptui --list          # list every tool
iptui <tool> [args]   # run a tool directly

Examples:

iptui myip
iptui subnet 192.168.1.0/24
iptui geo 8.8.8.8
iptui scan example.com 1-1024
iptui dnsq example.com MX
iptui summarize 10.0.0.0 10.0.0.255

In the TUI: Up/Dn to move, Enter to run a tool, q to quit. Output scrolls with Up/Dn / PgUp/PgDn, ESC to go back.

🧭 Tools

	Tool	What it does
1	myip	show your public IP
2	localip	show local / private addresses
3	geo	geolocate an IP (city, ISP, ASN)
4	rdns	reverse DNS (IP -> hostname)
5	dns	DNS lookup (hostname -> A / AAAA)
6	whois	IANA WHOIS lookup
7	ping	ping a host
8	trace	traceroute to a host
9	scan	port scanner
10	port	check a single port
11	subnet	subnet calculator
12	hosts	list hosts in a CIDR
13	insubnet	is an IP inside a CIDR?
14	validate	validate + classify an IP
15	toint	IP -> integer
16	fromint	integer -> IP
17	tobin	IPv4 -> binary octets
18	tohex	IPv4 -> hex
19	class	IPv4 class A/B/C/D/E
20	random	random public IPv4
21	headers	fetch HTTP response headers
22	ssl	inspect a TLS certificate
23	mac	MAC -> vendor lookup
24	distance	geo distance between two IPs
25	ipv6	compress / explode IPv6
26	collapse	merge CIDR networks
27	myip6	show your public IPv6
28	dnsq	DNS query (A/MX/TXT/NS/SOA/...)
29	dnsbl	check an IP on DNS blocklists
30	tcpping	measure TCP connect latency
31	banner	grab a service banner
32	status	fetch HTTP status code
33	urlparse	split a URL into parts
34	arpa	IP -> reverse .arpa pointer name
35	cidr2mask	prefix length -> netmask
36	mask2cidr	netmask -> prefix length
37	wildcard	invert a netmask (wildcard mask)
38	cidrcount	addresses in a prefix
39	nextip	increment an IP
40	previp	decrement an IP
41	split	split a CIDR into subnets
42	supernet	parent (supernet) of a CIDR
43	summarize	IP range -> CIDR blocks
44	iprange	count + summarize a range
45	overlaps	do two CIDRs overlap?
46	subnetof	is one CIDR inside another?
47	compare	compare two IPs
48	bin2ip	binary octets -> IPv4
49	hex2ip	hex -> IPv4
50	macinfo	parse + classify a MAC
51	randmac	generate random MACs
52	eui64	MAC -> IPv6 EUI-64 interface id

Tools that need the internet (myip, myip6, geo, whois, mac, distance, headers, ssl, dnsq, dnsbl, tcpping, banner, status) fail gracefully when offline.

📋 Requirements

• Python 3.8+
• No third-party packages

📄 License

MIT — see LICENSE.

---

🇷🇺 Русский

iptui — терминальный IP-инструментарий с 52 инструментами и ASCII-артом. Чистая стандартная библиотека Python, без зависимостей. Работает как интерактивный TUI или как быстрый CLI.

Установка

git clone https://github.com/wetair1/iptui
cd iptui
pip install .

Или просто запусти напрямую:

python3 iptui.py

Использование

iptui                 # запустить интерактивный TUI
iptui --list          # список всех инструментов
iptui <tool> [args]   # запустить инструмент напрямую

В TUI: Up/Dn — выбор, Enter — запуск, q — выход. Вывод листается Up/Dn / PgUp/PgDn, ESC — назад.

Что умеет

Свой публичный IPv4/IPv6 и локальный IP, геолокация, обратный/прямой DNS, собственный DNS-клиент (A/MX/TXT/NS/SOA/PTR), проверка по DNSBL-блоклистам, WHOIS, ping и TCP-ping, traceroute, сканер портов, захват баннеров, HTTP-заголовки и статус-коды, разбор URL, калькулятор подсетей, маски/префиксы/wildcard, разбиение и объединение сетей, диапазоны и суммаризация, конвертеры IP в int/bin/hex, классы сетей, валидатор, TLS-сертификаты, инструменты для MAC (вендор, разбор, случайные, EUI-64) и многое другое — всего 52 инструмента.

Инструменты, которым нужен интернет, аккуратно сообщают об ошибке в офлайне.