diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml index 1065bbb..3aa4afd 100644 --- a/.github/FUNDING.yml +++ b/.github/FUNDING.yml @@ -10,6 +10,6 @@ #issuehunt: # Replace with a single IssueHunt username #lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry #polar: # Replace with a single Polar username -#buy_me_a_coffee: # Replace with a single Buy Me a Coffee username +buy_me_a_coffee: infinition #thanks_dev: # Replace with a single thanks.dev username #custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2'] diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index 31510f3..e1339fc 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -23,7 +23,7 @@ We are committed to fostering an open and welcoming environment for all contribu ## πŸ“’ Reporting Misconduct -If you encounter any behavior that violates this code of conduct, please report it by contacting [bjorn-cyberviking@outlook.com](bjorn-cyberviking@outlook.com). All complaints will be reviewed and handled appropriately. +If you encounter any behavior that violates this code of conduct, please report it by contacting [bjorn-cyberviking@outlook.com](mailto:bjorn-cyberviking@outlook.com). All complaints will be reviewed and handled appropriately. ## βš–οΈ Enforcement diff --git a/INSTALL.md b/INSTALL.md index d9c3953..225552f 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -14,9 +14,8 @@ Use Raspberry Pi Imager to install your OS https://www.raspberrypi.com/software/ -### πŸ“Œ Prerequisites - -![image](https://github.com/user-attachments/assets/e775f454-1771-4d6c-bff5-b262b3d98452) +### πŸ“Œ Prerequisites for RPI zero W (32bits) +![image](https://github.com/user-attachments/assets/3980ec5f-a8fc-4848-ab25-4356e0529639) - Raspberry Pi OS installed. - Stable: @@ -26,7 +25,23 @@ https://www.raspberrypi.com/software/ - Username and hostname set to `bjorn`. - 2.13-inch e-Paper HAT connected to GPIO pins. -At the moment the paper screen v2 & v4 have been tested and implemented. +### πŸ“Œ Prerequisites for RPI zero W2 (64bits) + +![image](https://github.com/user-attachments/assets/e8d276be-4cb2-474d-a74d-b5b6704d22f5) + +I did not develop Bjorn for the raspberry pi zero w2 64bits, but several feedbacks have attested that the installation worked perfectly. + +- Raspberry Pi OS installed. + - Stable: + - System: 64-bit + - Kernel version: 6.6 + - Debian version: 12 (bookworm) '2024-10-22-raspios-bookworm-arm64-lite' +- Username and hostname set to `bjorn`. +- 2.13-inch e-Paper HAT connected to GPIO pins. + + + +At the moment the paper screen v2 v4 have been tested and implemented. I juste hope the V1 & V3 will work the same. ### ⚑ Quick Install diff --git a/README.md b/README.md index 5d8fcef..05b5fe6 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ Bjorn is a « Tamagotchi likeΒ Β» sophisticated, autonomous network scanning, - [Features](#-features) - [Getting Started](#-getting-started) - [Prerequisites](#-prerequisites) - - [Installation](#-Installation) + - [Installation](#-installation) - [Quick Start](#-quick-start) - [Usage Example](#-usage-example) - [Contributing](#-contributing) @@ -42,10 +42,9 @@ The e-Paper HAT display and web interface make it easy to monitor and interact w ![Bjorn Display](https://github.com/infinition/Bjorn/assets/37984399/bcad830d-77d6-4f3e-833d-473eadd33921) ## πŸš€ Getting Started - -### πŸ“Œ Prerequisites - -![image](https://github.com/user-attachments/assets/e775f454-1771-4d6c-bff5-b262b3d98452) +## πŸ“Œ Prerequisites +### πŸ“Œ Prerequisites for RPI zero W (32bits) +![image](https://github.com/user-attachments/assets/3980ec5f-a8fc-4848-ab25-4356e0529639) - Raspberry Pi OS installed. - Stable: @@ -55,7 +54,22 @@ The e-Paper HAT display and web interface make it easy to monitor and interact w - Username and hostname set to `bjorn`. - 2.13-inch e-Paper HAT connected to GPIO pins. -At the moment the paper screen v2 & v4 have been tested and implemented. +### πŸ“Œ Prerequisites for RPI zero W2 (64bits) + +![image](https://github.com/user-attachments/assets/e8d276be-4cb2-474d-a74d-b5b6704d22f5) + +I did not develop Bjorn for the raspberry pi zero w2 64bits, but several feedbacks have attested that the installation worked perfectly. + +- Raspberry Pi OS installed. + - Stable: + - System: 64-bit + - Kernel version: 6.6 + - Debian version: 12 (bookworm) '2024-10-22-raspios-bookworm-arm64-lite' +- Username and hostname set to `bjorn`. +- 2.13-inch e-Paper HAT connected to GPIO pins. + + +At the moment the paper screen v2 v4 have been tested and implemented. I juste hope the V1 & V3 will work the same. ### πŸ”¨ Installation @@ -85,9 +99,47 @@ For **detailed information** about **troubleshooting** go to [Troubleshooting](T **Quick Installation**: you can use the fastest way to install Bjorn [Getting Started](#-getting-started) -## πŸ’‘ Usage Example +## πŸ’‘ Usage Example + +Here's a demonstration of how Bjorn autonomously hunts through your network like a Viking raider (fake demo for illustration): + +```bash +# Reconnaissance Phase +[NetworkScanner] Discovering alive hosts... +[+] Host found: 192.168.1.100 + β”œβ”€β”€ Ports: 22,80,445,3306 + └── MAC: 00:11:22:33:44:55 + +# Attack Sequence +[NmapVulnScanner] Found vulnerabilities on 192.168.1.100 + β”œβ”€β”€ MySQL 5.5 < 5.7 - User Enumeration + └── SMB - EternalBlue Candidate + +[SSHBruteforce] Cracking credentials... +[+] Success! user:password123 +[StealFilesSSH] Extracting sensitive data... + +# Automated Data Exfiltration +[SQLBruteforce] Database accessed! +[StealDataSQL] Dumping tables... +[SMBBruteforce] Share accessible +[+] Found config files, credentials, backups... +``` + +This is just a demo output - actual results will vary based on your network and target configuration. + +All discovered data is automatically organized in the data/output/ directory, viewable through both the e-Paper display (as indicators) and web interface. +Bjorn works tirelessly, expanding its network knowledge base and growing stronger with each discovery. + +No constant monitoring needed - just deploy and let Bjorn do what it does best: hunt for vulnerabilities. + +πŸ”§ Expand Bjorn's Arsenal! +Bjorn is designed to be a community-driven weapon forge. Create and share your own attack modules! + +⚠️ For educational and authorized testing purposes only ⚠️ + + -... ## 🀝 Contributing diff --git a/SECURITY.md b/SECURITY.md index b1b77d5..a3dc6dd 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -27,7 +27,7 @@ If you discover a security vulnerability within this project, please follow thes 1. **Do not create a public issue.** Instead, contact us directly to responsibly disclose the vulnerability. -2. **Email** [bjorn-cyberviking@outlook.com](bjorn-cyberviking@outlook.com) with the following information: +2. **Email** [bjorn-cyberviking@outlook.com](mailto:bjorn-cyberviking@outlook.com) with the following information: - A description of the vulnerability. - Steps to reproduce the issue. diff --git a/TROUBLESHOOTING.md b/TROUBLESHOOTING.md index a8a3560..5fe0241 100644 --- a/TROUBLESHOOTING.md +++ b/TROUBLESHOOTING.md @@ -25,12 +25,20 @@ ### Service Issues ```bash +#See bjorn journalctl service +journalctl -fu bjorn.service + # Check service status sudo systemctl status bjorn.service # View detailed logs sudo journalctl -u bjorn.service -f +or + +sudo tail -f /home/bjorn/Bjorn/data/logs/* + + # Check port 8000 usage sudo lsof -i :8000 ``` diff --git a/install_bjorn.sh b/install_bjorn.sh index e5775eb..92d6675 100644 --- a/install_bjorn.sh +++ b/install_bjorn.sh @@ -112,9 +112,9 @@ check_system_compatibility() { # Check RAM (Raspberry Pi Zero has 512MB RAM) total_ram=$(free -m | awk '/^Mem:/{print $2}') - if [ "$total_ram" -lt 429 ]; then - log "WARNING" "Low RAM detected. Required: 512MB, Found: ${total_ram}MB" - echo -e "${YELLOW}Your system has less RAM than recommended. This might affect performance.${NC}" + if [ "$total_ram" -lt 410 ]; then + log "WARNING" "Low RAM detected. Required: 512MB (410 With OS Running), Found: ${total_ram}MB" + echo -e "${YELLOW}Your system has less RAM than recommended. This might affect performance, but you can continue.${NC}" should_ask_confirmation=true else log "SUCCESS" "RAM check passed: ${total_ram}MB available" @@ -122,7 +122,7 @@ check_system_compatibility() { # Check available disk space available_space=$(df -m /home | awk 'NR==2 {print $4}') - if [ "$available_space" -lt 1024 ]; then + if [ "$available_space" -lt 2048 ]; then log "WARNING" "Low disk space. Recommended: 1GB, Found: ${available_space}MB" echo -e "${YELLOW}Your system has less free space than recommended. This might affect installation.${NC}" should_ask_confirmation=true