MaybeScanner

MaybeScanner is an Android network scanner focused on target-first IP checks. It scans user-supplied IPs, domains, CIDR blocks, ranges, or imported files, with an optional Go sidecar for higher-throughput scans and export/observability workflows.

What It Does

• Runs TCP/TLS/HTTP probing across explicit user targets, with managed corpora kept as advanced diagnostics.
• Provides live scan progress, result ranking, and export views.
• Includes diagnostics tooling (logs, network checks, optional Shizuku-assisted radio diagnostics).
• Supports an optional local Go sidecar (go-sidecar) for desktop/server-driven scan sessions.

Project Scope

• This repo is the target-first scanner product.
• Literal IP scans do not receive a default SNI.
• If you need explicit SNI/IP route pairing behavior, use the sibling project: MaybeEdgeScanner.

Repository Layout

MaybeScanner/
├── app/                 # Android app
├── go-sidecar/          # Optional Go sidecar
├── .github/workflows/   # CI and release workflows
└── docs/                # User, verification, and architecture docs

Build & Verify (Local)

From repository root:

.\gradlew.bat --no-daemon :app:lintUniversalDebug :app:assembleUniversalDebug

From go-sidecar/:

go test ./...
go vet ./...

From workspace root (if shared-contracts/ is available):

py shared-contracts\validate_contracts.py

CI & Release

The workflow in .github/workflows/build.yml runs:

• secret scanning
• Go sidecar tests/vet/race (race on Linux)
• Android lint/build gates
• artifact publication
• dependency image publication with SBOM/provenance enabled

Documentation

• User Guide
• Verification Guide
• Architectural Guide

License

AGPL-3.0. See LICENSE.