# Bjorn — Raspberry Pi Network Scanner and Offensive Security Tool

> A network scanning and offensive security tool designed for Raspberry Pi with an e-Paper display. Discovers targets, identifies open ports, and tests for vulnerabilities.

## Install

Save as a script file and run:

# Bjorn — Raspberry Pi Network Scanner and Offensive Security Tool

## Quick Use
```bash
git clone https://github.com/infinition/Bjorn.git
cd Bjorn
sudo ./install.sh
# Bjorn starts automatically and displays status on the e-Paper HAT
```

## 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

---
Source: https://tokrepo.com/en/workflows/asset-43f74adc
Author: Script Depot