🧱 SafeWall – Smart Windows Firewall Controller - v1.5

SafeWall is a high-performance Windows Firewall utility designed for streamlined network security. Built with a modular Python/CustomTkinter architecture, it provides an intuitive, one-click interface to manage application-level internet access.

---

📦 Features

• ✅ One-click Block/Unblock for EXE files or folders.
• 🔍 Real-time Detection of currently active rules.
• 🎨 Modern Dark UI built with CustomTkinter and custom "Clash" typography.
• ⚙️ Automated Logic: Intelligent handling of both Inbound and Outbound rules.
• 🚀 Standalone EXE: No Python installation required for end-users.
• 🟢 Integrated search and filtering for installed apps

---

📁 Folder Structure

SafeWall_GUI_Internet_Blocker/
│
├── assets/                # Icons, images, fonts, screenshots
│   ├── screenshots/
│   ├── default_icon.png   #Icon for Selected Installed Apps
│   └── icon.ico  #App icon
│
├── data/
│   └── blocked_software.json       # Additional resource or configuration files
│
├── dist/          # Compiled .exe file appears here
│
│
├── docs/          # Documentation and usage screenshots
│   ├── usage_screenshots.md   # Detailed visual guide
    └── setup_instructions.md  # Setup guide for developers
│
│
├── fonts/          #custom font folder
│   └── clash.otf   # font file here
│
├── src/                   # All source code
│   ├── __pycache__        #Cache folder,faster loading
│   ├── __init__.py
│   ├── constants.py
│   ├── firewall_logic.py
│   ├── firewall.py        # Main entry point
│   ├── gui_components.py
│   ├── logger.py
│   └── utils.py
│
├── tests/                   # test folder
│   ├── test_firewall.py     #testing modules and features
│
│
├── .gitignore               
├── clean.ps1              # Automate Build clean
├── create.ps1             # Automate Build create
├── LICENSE                # LICENSE info
├── README.md              # Main project documentation
├── requirements.txt       # Libraries info
├── SafeWall_GUI_Internet_Blocker.spec  #Executable Specs
└── version.txt            # Version Update Info

---

💾 EXE Version (For Regular Users)

If you prefer a ready-to-use version without setting up Python:

1. Download: Get the latest SafeWall.zip from Releases.
2. Extract: Unzip the folder to your preferred location.
3. Launch: Double-click SafeWall.exe and click "Yes" when the Administrator prompt appears.

---

⚙️ Setup (For Developers)

Follow these steps to run or build SafeWall from the source:

1. Environment Setup

# Clone the repository
git clone https://github.com/shaswatacharya/SafeWall_GUI_Internet_Blocker.git

• Install dependencies

pip install -r requirements.txt

2. Developer Scripts

• Run Application: Launch directly from source.

python src/firewall.py

• Build Executable: Automatically generate a standalone .exe in the dist/ folder.

./create.ps1

• Clean Workspace: Instantly wipe build caches and temporary files.

./clean.ps1

💡 Tip: Use a virtual environment (venv) to isolate dependencies and prevent library conflicts with other projects.

---

🪄 Built With

• Python 3.12+
• CustomTkinter (GUI Framework)
• PowerShell (NetSecurity) High-level Windows Firewall API.
• ThreadPoolExecutor Parallel processing for rule management.

🧩 Requirements

• Windows 10 or later
• Python ≥ 3.10
• Administrator privileges (needed for firewall changes)

---

📖 Documentation & Guides

• Visuals: Usage Screenshots
• Setup_Guide: Setup Instructions

---

📜 Version History

🖥️ Click to open Developer Change Log

============================================================
[ v1.5 - REFACTOR & OPTIMIZATION ] - 2026-02-01
============================================================
+ STRUCTURE: Modularized /src (logic, gui, utils, constants)
+ ENGINE:    Added ThreadPoolExecutor for parallel rule processing
+ SETUP:     Created requirements.txt & venv setup instructions
+ BUILD:     Updated create.ps1 for modular architecture
+ STABILITY: Fixed "import times" typo and removed dull imports
+ GIFT:      Added a Easter egg

============================================================
[ v1.0 - INITIAL RELEASE ] - 2025-10-16
============================================================
+ CORE:      Baseline Windows Firewall (netsh) integration
+ UI:        CustomTkinter Dark Theme & "Clash" font
+ FEATURES:  Installed apps scanner & manual folder selection
+ BUILD:     Standalone EXE packaging via PyInstaller
============================================================

---

🧠 Author

Shaswat Acharya
🔗 shaswatacharya.com.np
📧 Contact: via GitHub profile

---

📜 License

This project is open-source under the MIT License.
You are free to modify and distribute with proper credit.

---

🧱 Enjoying SafeWall? Give it a ⭐ to show your support!