From 566bbd9d0e02d5d031cec2fe1f74cac57fb3dd7b Mon Sep 17 00:00:00 2001
From: rene <mail@motocamp.de>
Date: Sun, 29 Mar 2026 10:06:33 +0200
Subject: [PATCH] README: Installation, Parameter, Tiere, Unterschiede zum
 Perl-Original

---
 README.md | 65 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 65 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cb96a4f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,65 @@
+# asciiquarium-ng
+
+Python-Port von [asciiquarium](https://robobunny.com/projects/asciiquarium/html/) mit echten RGB-Farben (Truecolor ANSI statt Curses), neuen Tieren und CLI-Parametern.
+
+## Installation
+
+```bash
+curl -fsSL https://git.motocamp.de/rene/asciiquarium/raw/branch/main/asciiquarium_ng.py \
+    -o /usr/local/bin/asciiquarium
+chmod +x /usr/local/bin/asciiquarium
+```
+
+**Voraussetzung:** Python 3.7+, nur stdlib (keine externen Pakete).
+Läuft auf Linux, macOS, WSL2. Kein Perl, kein Curses, keine CPAN-Module.
+
+## Verwendung
+
+```bash
+asciiquarium                  # normal starten
+asciiquarium --bloody         # Haie fressen Fische (Splat-Animation)
+asciiquarium --vegan          # keine Räuber (kein Hai, kein Angelhaken, kein großer Fisch)
+asciiquarium --no-shark       # kein Hai
+asciiquarium --no-ship        # kein Schiff
+asciiquarium --speed 2        # doppelte Geschwindigkeit
+asciiquarium --any-key        # beliebige Taste beendet (gut für Screensaver)
+```
+
+### Tasten
+
+| Taste | Funktion |
+|-------|----------|
+| `q` / `Q` / `Esc` / `Ctrl-C` | Beenden |
+| `p` | Pause/Weiter |
+| `r` / `R` | Neu aufbauen (nach manueller Terminalgrößenänderung) |
+
+## Tiere
+
+- Fische (8 Typen, zufällige Farben)
+- Wal mit Fontänen-Animation
+- Hai
+- Großer Fisch
+- Seemonster
+- Delfine (3er-Gruppe, Sprung-Animation)
+- Schwan
+- Enten (3er-Gruppe)
+- Schiff
+- Angelhaken
+- **Seepferdchen** *(neu)*
+- **Tintenfisch** *(neu)*
+- **Krabbe** *(neu)* — kommt periodisch aus dem Schlosstor (Falltor öffnet/schließt sich)
+
+## Unterschiede zum Perl-Original
+
+- Truecolor ANSI (`\033[38;2;R;G;Bm`) statt Curses-Farbpaare → Farben immer korrekt, unabhängig vom Terminal-Profil
+- CLI-Parameter (`--bloody`, `--vegan`, `--speed`, etc.)
+- Seepferdchen, Tintenfisch, Krabbe mit Falltor-Animation
+- Eine einzige Python-Datei, keine Abhängigkeiten
+
+## Screensaver (zsh)
+
+```zsh
+# in ~/.zshrc:
+TMOUT=300
+TRAPALRM() { asciiquarium --any-key }
+```