f2bs

A focused, terminal UI for scanning Fail2Ban jails and unbanning IPs.

Features

• Two-panel TUI (jails on the left, banned IPs on the right)
• Remaining time shown next to banned IPs (when supported by fail2ban)
• Jail detail panel with bantime/findtime/maxretry
• Filter + sort for IP list
• Auto-refresh toggle
• Unban all with double confirmation
• Keyboard and mouse support
• Confirm prompt before unbanning
• Works directly with fail2ban-client

Run

sudo f2bs

Install (from GitHub release)

curl -fsSL https://raw.githubusercontent.com/hexajohnny/f2bs/main/install.sh | sudo sh

Controls

• q: quit
• r: refresh
• t: toggle auto-refresh
• /: filter IP list (type, then enter to apply, esc to cancel)
• x: clear filter
• s: toggle sort (IP or time left)
• b: ban an IP in the selected jail
• tab: switch panels
• enter: unban selected IP
• A: unban all in selected jail (double confirm)
• y/n: confirm/cancel unban
• mouse click: select jail or IP, click Confirm/Cancel in modal

Notes

• Requires fail2ban-client on PATH.
• Requires root privileges for unban operations. Run with sudo f2bs.

License

f2bs is dual-licensed under MIT or Apache-2.0, matching the duviz project. See LICENSE-MIT and LICENSE-APACHE in this folder.