Skip to content

Latest commit

 

History

History
181 lines (123 loc) · 5.02 KB

File metadata and controls

181 lines (123 loc) · 5.02 KB

IP Scanner CLI

ipscanner is the command behind IP Scanner CLI: a small LAN scanner for people who want useful answers quickly, such as who is on the network, what each device probably is, and which manufacturer is behind the MAC address.

It keeps the fast, practical side of arp-scan and avahi-browse, but adds a local vendor database built from the official IEEE registries. That makes manufacturer names much more consistent than relying on whatever happens to come back from a single scan.

Current release: v0.9.1

Source for vendor data:

Português

O que ele faz

O ipscanner foi feito para ser simples de usar e agradável de ler no terminal. Ele mostra os dispositivos da sua LAN com IP, MAC, fabricante, nome mDNS/DNS quando existir e alguns serviços descobertos via Bonjour.

Em vez de depender apenas do texto devolvido pelo arp-scan, ele consulta uma base local da IEEE. Na prática, isso melhora bastante a qualidade do campo de fabricante. Para MACs privados e aleatórios, que são comuns em aparelhos modernos, ele tenta ser honesto: se não der para ter certeza, ele marca como "provável" em vez de fingir precisão.

Requisitos

  • Python 3
  • arp-scan
  • avahi-browse
  • permissão para executar sudo arp-scan

No Debian ou Ubuntu:

sudo apt update
sudo apt install -y python3 arp-scan avahi-utils

Uso rápido

chmod +x ipscanner ipscanner-update-db
./ipscanner-update-db
./ipscanner

Ver a versão:

./ipscanner --version

Ver informações da base local:

./ipscanner --db-info

Atualizar a base de fabricantes:

./ipscanner-update-db

O que mudou no v0.9.1

  • lookup local de fabricantes com base oficial da IEEE
  • suporte a MA-L, MA-M e MA-S
  • deduplicação de entradas repetidas do arp-scan
  • heurística cautelosa para MAC privado aleatório
  • comando separado para atualizar a base local

English

What it does

ipscanner is meant to feel practical, not academic. You run it, and it gives you a readable picture of your LAN: IP addresses, MAC addresses, likely manufacturers, Bonjour/mDNS names, and a short list of visible services.

The main improvement in v0.9.1 is vendor detection. Instead of trusting only the raw arp-scan output, the tool now uses a local database compiled from the official IEEE registries. That makes manufacturer names more reliable and easier to maintain. For randomized private MAC addresses, it stays conservative and labels guesses as probable rather than pretending certainty.

Requirements

  • Python 3
  • arp-scan
  • avahi-browse
  • permission to run sudo arp-scan

On Debian or Ubuntu:

sudo apt update
sudo apt install -y python3 arp-scan avahi-utils

Quick start

chmod +x ipscanner ipscanner-update-db
./ipscanner-update-db
./ipscanner

Check the version:

./ipscanner --version

Inspect the local vendor database:

./ipscanner --db-info

Refresh vendor data:

./ipscanner-update-db

Highlights in v0.9.1

  • local vendor lookup based on the official IEEE registries
  • support for MA-L, MA-M, and MA-S allocations
  • duplicate entry cleanup for noisy arp-scan results
  • cautious heuristics for randomized private MAC addresses
  • dedicated updater for the local vendor database

Français

Ce que fait le projet

ipscanner a été pensé pour le terminal du quotidien. L'idée n'est pas de produire un rapport compliqué, mais de montrer rapidement quels appareils sont présents sur le réseau local, avec une sortie lisible et utile.

La vraie différence de la version v0.9.1, c'est la détection des fabricants. Au lieu de faire confiance uniquement au texte renvoyé par arp-scan, le projet utilise maintenant une base locale construite à partir des registres officiels de l'IEEE. Le résultat est plus propre, plus stable et plus crédible. Quand une adresse MAC privée et aléatoire empêche une identification certaine, l'outil reste prudent et affiche une estimation probable.

Prérequis

  • Python 3
  • arp-scan
  • avahi-browse
  • autorisation d'exécuter sudo arp-scan

Sur Debian ou Ubuntu :

sudo apt update
sudo apt install -y python3 arp-scan avahi-utils

Démarrage rapide

chmod +x ipscanner ipscanner-update-db
./ipscanner-update-db
./ipscanner

Afficher la version :

./ipscanner --version

Afficher les informations de la base locale :

./ipscanner --db-info

Mettre à jour la base des fabricants :

./ipscanner-update-db

Points importants de la v0.9.1

  • résolution locale des fabricants à partir des registres officiels IEEE
  • prise en charge de MA-L, MA-M et MA-S
  • suppression des doublons issus de arp-scan
  • heuristiques prudentes pour les MAC privées aléatoires
  • script dédié pour mettre à jour la base locale