feat: first version of the script

.github/README.md

@@ -0,0 +1,66 @@
+# ivuorinen/f2b
+
+A fail2ban wrapper for easier management and listing of banned IP's in your jails.
+
+Requires fail2ban to be installed and running. Should work on most Linux distributions.
+Developed against `fail2ban` version 0.11.2 on Ubuntu 22.04.4 LTS using nvim.
+
+[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/) ![GitHub file size in bytes](https://img.shields.io/github/size/ivuorinen/f2b/f2b)
+
+## Installation
+
+```bash
+curl https://raw.githubusercontent.com/ivuorinen/f2b/main/f2b > f2b
+chmod +x f2b
+./f2b version
+```
+
+Requiements: `fail2ban` (duh), and few other default tools.
+`awk`, `cat`, `date`, `grep`, `ls`, `sed`, `sort`, `tail`, `tr`, `wc`, and `zcat` should be installed.
+Those are usually installed by default on most Linux distributions. The script will tell you if something is missing.
+
+If running commands straight from the internet scares you (as it should) you can
+open the f2b script in your favourite editor (or here in GitHub) and view the source.
+
+I promise I'm not doing anything weird in the script.
+
+## Usage
+
+It uses several fail2ban commands to get the information it needs, so it needs to be run as root.
+
+```bash
+Usage: f2b [command] [options]
+ list-jails             List all jails
+ status all             Show status of all jails
+ status [jail]          Show status of a specific jail
+ banned                 Show all banned IP addresses with ban time left
+ banned [jail]          Show all banned IP addresses with ban time left in a jail
+ ban [ip]               Ban IP address in all jails
+ ban [ip] [jail]        Ban IP address in a specific jail
+ unban [ip]             Unban IP address in all jails
+ unban [ip] [jail]      Unban IP address in a specific jail
+ test [ip]              Test if IP address is banned
+ logs                   Show fail2ban logs
+ logs all [ip]          Show logs for a specific IP address in all jails
+ logs [jail]            Show logs for a specific jail
+ logs [jail] [ip]       Show logs for a specific jail and IP address
+ logs-watch             Watch fail2ban logs
+ logs-watch all [ip]    Watch logs for a specific IP address
+ logs-watch [jail]      Watch logs for a specific jail
+ logs-watch [jail] [ip] Watch logs for a specific jail and IP address
+ test-filter [filter]   Test a fail2ban filter
+ service start          Start fail2ban
+ service stop           Stop fail2ban
+ service restart        Restart fail2ban
+ help                   Show help
+ version                Show version
+```
+
+## Authors
+
+- [@ivuorinen](https://github.com/ivuorinen)
+
+## License
+
+[MIT](https://choosealicense.com/licenses/mit/)
+