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.
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.
- 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)
- Run the downloaded file and follow the installer instructions.
- After installation, launch OSINT NET Auditor from the Start Menu or desktop shortcut.
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 | iexPass -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))) -InteractiveGet it from the Microsoft Store
(ms-windows-store://pdp/?productid=XP9MCW35D1W4PW)
winget install michalstankiewicz.OSINTNETAuditor(Package submitted to the community winget-pkgs repo, PR pending review -
not installable via winget yet.)
scoop bucket add osintnetauditor https://github.com/michalstankiewicz4-cell/scoop-bucket
scoop install osintnetauditorRequirements:
- 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:buildThe built EXE and installers will appear in:
src-tauri/target/release/bundle/
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
See docs/ROADMAP.md for what's done, in progress, and planned next.
| 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. |
Have a question or an idea? Use GitHub Discussions instead of opening an issue.
