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.

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).
docs/RELEASING.md	Release process checklist: build, sign, publish, and every distribution channel (written in Polish).
docs/COMMUNITY_ADDON_GUIDELINES.md	Rules for having a GitHub repo listed in the in-app Community Catalog.
CODE_OF_CONDUCT.md	Community code of conduct.
SECURITY.md	How to report a security vulnerability.
LICENSE.md	MIT License.

Questions & discussions

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

NEW Screenshots

OLD Screenshots