PorteusRecon

A simple port scanner built in Go with both CLI and Fyne GUI entrypoints.

Technologies Used

• Go
• Fyne GUI toolkit

Run From Source

Clone the repository:

git clone https://github.com/Adhvay0505/PorteusRecon.git
cd PorteusRecon

Run the CLI:

go run PorteusReconCLI.go -host 127.0.0.1 -start 1 -end 1024

Run the GUI:

go run PorteusReconGUI.go

Build Binaries

Create the external build directory:

mkdir -p "$HOME/PorteusRecon-dist"

Build the CLI outside the repository:

go build -o "$HOME/PorteusRecon-dist/PorteusReconCLI" PorteusReconCLI.go

Build the GUI outside the repository:

go build -o "$HOME/PorteusRecon-dist/PorteusReconGUI" PorteusReconGUI.go

Run the built binaries:

"$HOME/PorteusRecon-dist/PorteusReconCLI" -host 127.0.0.1 -start 1 -end 1024
"$HOME/PorteusRecon-dist/PorteusReconGUI"

The repository no longer uses an in-repo dist/ directory for build artifacts.

GUI Scan Profiles

The GUI now includes:

• Built-in TCP scan mode
• Nmap-style scan profiles with command previews
• RustScan profile selection with descriptions

When the required external scanner is available, the GUI can use it automatically. Release artifacts should still be built to a directory under the user home directory, such as $HOME/PorteusRecon-dist.

Linux GUI Dependencies

On Arch Linux, the Fyne desktop build needs system graphics libraries:

sudo pacman -Sy --needed base-devel pkgconf mesa libx11 libxcursor libxinerama libxrandr libxi

Packaged GUI Artifact

Build release artifacts outside the repository:

mkdir -p "$HOME/PorteusRecon-dist"
go build -o "$HOME/PorteusRecon-dist/PorteusReconGUI" PorteusReconGUI.go
tar -czf "$HOME/PorteusRecon-dist/PorteusReconGUI_linux_amd64.tar.gz" -C "$HOME/PorteusRecon-dist" PorteusReconGUI

By default this writes to:

$HOME/PorteusRecon-dist/PorteusReconGUI
$HOME/PorteusRecon-dist/PorteusReconGUI_linux_amd64.tar.gz

Dark Mode

New

Light Mode

New