From 414019d62ebb643741cff828a124f9f470e2c64d Mon Sep 17 00:00:00 2001
From: ralph <ralph@noreply.forgejo.mayer.rocks>
Date: Tue, 15 Apr 2025 17:58:37 +0200
Subject: [PATCH] Update README.md

---
 README.md | 89 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 88 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 674bc2d..2a062bd 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,89 @@
-# contacts-to-remind
+# Apple Contacts Geburtstage zu Remind Exporter
 
+Dieses Tool exportiert Geburtstagsinformationen aus Apple Contacts und erstellt eine Remind-Datei für Geburtstagserinnerungen.
+
+## Voraussetzungen
+
+- macOS (da Apple Contacts verwendet wird)
+- Python 3.6+
+- uv (Python-Projektverwaltungstool)
+
+## Installation
+
+1. Erstellen Sie ein Verzeichnis für das Projekt und wechseln Sie hinein:
+
+```bash
+mkdir contacts-to-remind
+cd contacts-to-remind
+```
+
+2. Erstellen Sie eine Umgebung mit uv:
+
+```bash
+uv venv
+```
+
+3. Aktivieren Sie die Umgebung:
+
+```bash
+source .venv/bin/activate
+```
+
+4. Installieren Sie die erforderliche Abhängigkeit:
+
+```bash
+uv pip install contacts
+```
+
+5. Speichern Sie das Script in einer Datei namens `contacts_to_remind.py`
+
+6. Machen Sie das Script ausführbar:
+
+```bash
+chmod +x contacts_to_remind.py
+```
+
+## Verwendung
+
+### Grundlegende Verwendung
+
+Führen Sie das Script aus, um eine `geburtstage.rem`-Datei im aktuellen Verzeichnis zu erstellen:
+
+```bash
+./contacts_to_remind.py
+```
+
+### Optionen
+
+- `-o DATEI`, `--output DATEI`: Gibt einen benutzerdefinierten Pfad/Namen für die Ausgabedatei an
+- `-v`, `--verbose`: Zeigt ausführliche Informationen während der Ausführung
+
+Beispiel mit Optionen:
+
+```bash
+./contacts_to_remind.py -o ~/remind/meine_geburtstage.rem -v
+```
+
+## Remind-Format
+
+Das Script erstellt eine Remind-Datei im folgenden Format:
+
+```
+# Geburtstage aus Apple Contacts
+# Erstellt am: 2025-04-14 12:34:56
+# Enthält Erinnerungen am Geburtstag und 7 Tage vorher
+
+REM 15 JAN MSG Max Mustermann: Geburtstag (35 Jahre alt) %b
+REM 15 JAN +7 MSG Vorwarnung: Max Mustermann hat in 7 Tagen Geburtstag (35 Jahre alt) %b
+REM 28 FEB MSG Erika Beispiel: Geburtstag %b
+REM 28 FEB +7 MSG Vorwarnung: Erika Beispiel hat in 7 Tagen Geburtstag %b
+```
+
+Die Rem-Einträge sind nach Monat und Tag sortiert und enthalten das Alter, wenn das Geburtsjahr bekannt ist. Für jeden Geburtstag gibt es zwei Einträge:
+1. Eine Erinnerung am eigentlichen Geburtstag
+2. Eine Vorwarnung 7 Tage vor dem Geburtstag mit der Syntax `+7`
+
+## Hinweise
+
+- Wenn bei einem Kontakt kein Geburtsjahr hinterlegt ist, wird kein Alter angezeigt
+- Das Script kann als regelmäßiger Cron-Job eingerichtet werden, um die Geburtstagsdatei zu aktualisieren
\ No newline at end of file