Bjorn — Raspberry Pi Network Scanner and Offensive Security Tool

Introduction

Bjorn is an open-source network scanning and offensive security tool built for the Raspberry Pi with a 2.13-inch e-Paper HAT. It automates network reconnaissance, port scanning, service identification, and basic penetration testing in a compact, portable form factor.

What Bjorn Does

• Discovers network targets via ARP and passive scanning
• Identifies open ports and running services on discovered hosts
• Performs automated brute-force testing against common services
• Displays real-time scan status on the e-Paper display
• Supports custom attack scripts for extensibility

Architecture Overview

Bjorn runs as a Python service on Raspberry Pi OS. The core engine orchestrates scanning modules (Nmap integration, custom probes) and cycles through discovered targets. Results are stored in a local SQLite database and rendered on the e-Paper HAT via the display driver. A web dashboard provides remote access to findings.

Self-Hosting & Configuration

• Requires Raspberry Pi (3B+ or later) with a Waveshare 2.13-inch e-Paper HAT
• Run the install script which sets up dependencies and systemd service
• Configure scan ranges, timing, and modules in config.toml
• Enable or disable specific attack modules as needed
• Access the web dashboard on port 8080 for remote monitoring

Key Features

• Portable network scanner with e-Paper display
• Automated service enumeration and vulnerability detection
• Brute-force testing for SSH, FTP, SMB, and other services
• Extensible with custom Python attack scripts
• Web dashboard for remote access to scan results

Comparison with Similar Tools

• Nmap — Industry-standard scanner; Bjorn adds automation and the portable display
• Pwnagotchi — Wi-Fi audit tool with display; Bjorn targets network services instead
• Flipper Zero — Hardware hacking tool; Bjorn focuses on network-layer scanning
• Kali Linux — Full pentest OS; Bjorn is a focused, always-on scanner

FAQ

Q: Is this legal to use? A: Only use Bjorn on networks you own or have written authorization to test. Unauthorized scanning is illegal in most jurisdictions.

Q: Does it work without the e-Paper display? A: Yes, Bjorn can run headless with output via the web dashboard or log files.

Q: What Raspberry Pi models are supported? A: Pi 3B+, Pi 4, and Pi 5. A Pi Zero 2 W works but with reduced scan speed.

Q: Can I add custom scan modules? A: Yes, drop Python scripts into the modules directory following the plugin template.

Sources

• https://github.com/infinition/Bjorn