OSINT NET Auditor

An amateur project made solely using vibe-coding for scientific purposes.

Desktop IP/port scanner application built with Tauri.

OSINT NET Auditor scans IP ranges and ports, and browses the results in a VS Code-style UI (menu bar, activity bar, panels, terminal/console). It includes a country IP library for geolocating scan results, session save/load (including a browser build with no server/backend), and a JSON-manifest addon/extension system for adding new tools and languages at runtime.

What this is (and isn't)

Beyond the IP/port scanner, this app is also an active security-testing toolkit — this is intentional, not scope creep hiding behind the "IP scanner" label:

• Mail XSS Tester crafts and sends deliberately malformed HTML/MIME emails to test an email client's own HTML sanitizer.
• Browser Inspect intercepts and shows a page's own network traffic via a local proxy.
• WiFi tools can reveal WiFi passwords already saved on the local machine.

Only use these against systems, mailboxes, and networks you own or have explicit authorization to test. Sending Mail XSS Tester payloads to a mailbox you don't control, or probing a network without permission, can be illegal depending on your jurisdiction. This project ships with no warranty (see LICENSE.md) and the author takes no responsibility for misuse.

Installation

Ready-to-use installer (recommended)

1. Download the latest installer from the Releases tab:
   • OSINT NET Auditor_x.x.x_x64_en-US.msi — MSI installer (Windows)
   • OSINT NET Auditor_x.x.x_x64-setup.exe — NSIS installer (Windows)
2. Run the downloaded file and follow the installer instructions.
3. After installation, launch OSINT NET Auditor from the Start Menu or desktop shortcut.

One-line install (PowerShell)

Fetches the latest NSIS installer (the same one the app's own auto-update uses) and installs it silently:

irm https://raw.githubusercontent.com/michalstankiewicz4-cell/IPscanner/main/install.ps1 | iex

Pass -Interactive to see the normal install wizard instead of a silent install (piping straight into iex can't take arguments, so use this form instead to pass any):

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/michalstankiewicz4-cell/IPscanner/main/install.ps1))) -Interactive

Microsoft Store

Get it from the Microsoft Store (ms-windows-store://pdp/?productid=XP9MCW35D1W4PW)

winget

winget install michalstankiewicz.OSINTNETAuditor

(Package submitted to the community winget-pkgs repo, PR pending review - not installable via winget yet.)

Scoop

scoop bucket add osintnetauditor https://github.com/michalstankiewicz4-cell/scoop-bucket
scoop install osintnetauditor

Build from source

Requirements:

• Node.js v18+
• Rust (stable)
• Visual Studio Build Tools (C++ components)

Steps:

git clone https://github.com/michalstankiewicz4-cell/IPscanner.git
cd IPscanner
npm install
npm run tauri:build

The built EXE and installers will appear in: src-tauri/target/release/bundle/

A note on antivirus false positives

Some antivirus engines flag the built executable:

VirusTotal scan of the release binary: https://www.virustotal.com/gui/file/7c0706ee5d06693271bb14280606c14b59562fb7b8974e708c2d3b3084f75c0a

The site was clean as of 2026-05-13: https://www.virustotal.com/gui/domain/ipscanner.pl

Roadmap

See docs/ROADMAP.md for what's done, in progress, and planned next.

Documentation

File	Description
docs/ROADMAP.md	What's done, in progress, and planned.
docs/CHANGELOG.md	Notable changes, newest first.
docs/PROJECT_STRUCTURE.md	Map of every folder and file in the repo, with an ASCII tree (written in Polish).
docs/TROUBLESHOOTING.md	Non-obvious problems hit in this repo and their causes (written in Polish).
CONTRIBUTING.md	Project direction and rules for contributing code (written in Polish).
docs/FUTURE_PLUGIN_SHELL.md	Design notes for the addon/plugin shell architecture (written in Polish).
docs/PROGRESS.md	Map of the shell layout (menu/panels/status bar) and where each tool opens (written in Polish).
docs/MEMORY_SESSION.md	Every localStorage key the app uses, split into app settings vs. session data (written in Polish).
docs/SESSION_DATABASE_SCHEMA.md	Structure of the session .sqlite3 file, table by table (written in Polish).

Questions & discussions

Have a question or an idea? Use GitHub Discussions instead of opening an issue.

NEW Screenshots

OLD Screenshots