first commit

README.md

@@ -0,0 +1,103 @@
+# LibreNet Scanner 0.1.0
+
+LibreNet Scanner est un scanner réseau graphique pour Linux, pensé comme une alternative libre et simple à Advanced IP Scanner.
+
+Cette première version cible **Debian 13 (Trixie) + KDE Plasma** et utilise uniquement des composants disponibles dans les dépôts Debian.
+
+## Fonctionnalités V0.1
+
+- détection automatique des interfaces IPv4 et du CIDR local ;
+- filtrage par défaut des interfaces Docker/Podman/virbr/veth ;
+- 3 profils de scan : Rapide, Standard et Approfondi ;
+- découverte ARP avec `arp-scan` sur le LAN local ;
+- découverte et scan TCP avec `nmap` ;
+- affichage IP, nom DNS, MAC, constructeur, ports/services, OS si disponible, latence ;
+- scan détaillé des 1000 ports principaux d'une machine par double-clic/clic droit ;
+- actions KDE : HTTP/HTTPS, SSH et ping dans Konsole, SMB dans Dolphin, RDP avec Remmina si installé ;
+- export CSV et JSON ;
+- historique SQLite des scans ;
+- interface non lancée en root ;
+- limite de sécurité à 4096 adresses par scan dans cette V0.1.
+
+## Installation sur Debian 13
+
+Le plus simple est d'utiliser le paquet `.deb` fourni :
+
+```bash
+sudo apt install ./librenet-scanner_0.1.0_all.deb
+```
+
+APT installera automatiquement les dépendances (`python3-pyside6.qtwidgets`, `nmap`, `arp-scan`, etc.).
+
+Puis lancer :
+
+```bash
+librenet-scanner
+```
+
+ou chercher **LibreNet Scanner** dans le menu KDE.
+
+## Dépendances
+
+Obligatoires :
+
+- Python 3
+- PySide6 / Qt 6
+- Nmap
+- arp-scan
+- iproute2
+- xdg-utils
+- iputils-ping
+
+Recommandées :
+
+- Konsole
+- Remmina
+
+## Profils
+
+### Rapide
+
+Sur le réseau directement connecté : `arp-scan`. Pour une cible distante : découverte `nmap -sn`.
+
+### Standard
+
+Découverte des hôtes puis scan d'une liste de ports d'administration courants : 22, 23, 53, 80, 139, 443, 445, 3389, 5900, 8006, 8080, 8443 et 9100.
+
+### Approfondi
+
+Scan TCP des 100 ports les plus courants avec détection légère de version (`nmap -sT -sV --version-light`).
+
+Le double-clic sur une machine lance un scan des 1000 ports les plus courants avec détection de services.
+
+## Sécurité
+
+LibreNet Scanner n'exécute pas son interface graphique en root et transmet les cibles à Nmap/arp-scan sous forme d'arguments, sans passer par un shell.
+
+Utilisez le programme uniquement sur des réseaux que vous êtes autorisé à scanner.
+
+## Données locales
+
+L'historique se trouve dans :
+
+```text
+~/.local/share/librenet-scanner/history.sqlite3
+```
+
+ou sous `$XDG_DATA_HOME/librenet-scanner/` si cette variable est définie.
+
+## Licence
+
+Le code de LibreNet Scanner est sous licence **GPL-3.0-or-later**.
+
+Nmap et arp-scan sont des programmes externes installés séparément par Debian et conservent leurs propres licences.
+
+### À propos de `arp-scan` sur Debian 13
+
+Debian compile `arp-scan` avec le support des capabilities, mais le paquet indique qu'un utilisateur non privilégié peut devoir activer explicitement `CAP_NET_RAW` pour utiliser toutes les fonctions :
+
+```bash
+sudo setcap cap_net_raw+p /usr/sbin/arp-scan
+```
+
+Cette commande n'est **pas exécutée automatiquement** par LibreNet Scanner. Si `arp-scan` n'est pas utilisable par l'utilisateur courant, le profil Rapide se replie automatiquement sur `nmap -sn` et l'interface graphique reste non-root.