Files
firewalld-tui/README.md
T
2026-09-19 16:00:02 +02:00

33 lines
1.4 KiB
Markdown

# Firewalld TUI Manager
A lightweight, user-friendly Terminal User Interface (TUI) for fast and safe management of `firewalld` directly from the console. Built specifically for system administrators working over SSH who want an intuitive workflow without wrestling with cryptic `firewall-cmd` syntax.
The tool provides full control over zones, ports, predefined system services, and source IP addresses right inside your terminal.
---
## ✨ Features
* 🚀 **Centralized 3-Column Layout:** Ports, services, and source IP rules at a single glance.
* 🛡️ **Zone Management:** Dynamically switch between available firewall zones via dropdown or create new zones on the fly (hotkey `Z`).
* 💾 **Dual Persistence by Default:** All modifications (add/delete) are applied immediately to the active **runtime** and saved **permanently** (`--permanent`).
* 🎨 **Modern Terminal UI:** Seamless mouse and keyboard navigation powered by the [Textual](https://github.com/Textualize/textual) Python framework.
---
## 📋 Prerequisites
* Linux system running systemd with active `firewalld`
* Python 3.8+
* Root or `sudo` privileges (required by `firewalld` to inspect and update rules)
---
## 🚀 Installation
### 1. Install Dependencies
The interface requires the `textual` package. Install it using `pip` or your distribution's virtual environment workflow:
```bash
pip install textual