Skip to content

feat: add optional Bluetooth pairing display workflow #177

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
JeremyWhittaker wants to merge 1 commit into
base: main
Choose a base branch
from
Open

feat: add optional Bluetooth pairing display workflow #177

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 48 additions & 1 deletion INSTALL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -311,7 +311,54 @@ chmod +x /home/bjorn/Bjorn/kill_port_8000.sh
```


##### 7.3: USB Gadget Configuration
##### 7.3: Bluetooth Pairing Access

Create the Bluetooth pairing service:

```bash
sudo vi /etc/systemd/system/bjorn-bluetooth.service
```

Add:

```ini
[Unit]
Description=Bjorn Bluetooth Pairing Service
After=bluetooth.service local-fs.target
Requires=bluetooth.service

[Service]
ExecStart=/usr/bin/python3 /home/bjorn/Bjorn/bluetooth_manager.py
WorkingDirectory=/home/bjorn/Bjorn
StandardOutput=inherit
StandardError=inherit
Restart=always
User=root

[Install]
WantedBy=multi-user.target
```

Enable pairing mode in `config/shared_config.json`:

```json
{
"bluetooth_pairing_enabled": true,
"bluetooth_ssh_user": "bjorn"
}
```

Reload and start the services:

```bash
sudo systemctl daemon-reload
sudo systemctl enable bjorn.service bjorn-bluetooth.service
sudo systemctl restart bjorn.service bjorn-bluetooth.service
```

When pairing mode is enabled, Bjorn shows the pairing prompt or code on the e-paper display and also shows the SSH user and best available host/IP.

##### 7.4: USB Gadget Configuration

Modify `/boot/firmware/cmdline.txt`:

Expand Down
3 changes: 3 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,7 @@ The e-Paper HAT display and web interface make it easy to monitor and interact w
- **System Attacks**: Conducts brute-force attacks on various services (FTP, SSH, SMB, RDP, Telnet, SQL).
- **File Stealing**: Extracts data from vulnerable services.
- **User Interface**: Real-time display on the e-Paper HAT and web interface for monitoring and interaction.
- **Headless Bluetooth Pairing**: Optional Bluetooth pairing mode shows the pairing code and SSH target directly on the e-Paper display.

![Bjorn Display](https://github.com/infinition/Bjorn/assets/37984399/bcad830d-77d6-4f3e-833d-473eadd33921)

Expand Down Expand Up @@ -91,6 +92,8 @@ sudo chmod +x install_bjorn.sh && sudo ./install_bjorn.sh

For **detailed information** about **installation** process go to [Install Guide](INSTALL.md)

To enable the optional Bluetooth pairing screen after installation, set `"bluetooth_pairing_enabled": true` in `config/shared_config.json`, adjust `"bluetooth_ssh_user"` if needed, then restart `bjorn.service` and `bjorn-bluetooth.service`.

## ⚡ Quick Start

**Need help ? You struggle to find Bjorn's IP after the installation ?**
Expand Down
2 changes: 2 additions & 0 deletions TROUBLESHOOTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,9 +30,11 @@ journalctl -fu bjorn.service

# Check service status
sudo systemctl status bjorn.service
sudo systemctl status bjorn-bluetooth.service

# View detailed logs
sudo journalctl -u bjorn.service -f
sudo journalctl -u bjorn-bluetooth.service -f

or

Expand Down
Loading