From 827af0b239b6ed899ef4418aacd68c2ad51e0d4a Mon Sep 17 00:00:00 2001
From: Marco Wende <marco.wende@wende.it>
Date: Wed, 1 Jul 2026 22:54:56 +0200
Subject: [PATCH] Add README with documentation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 README.md | 121 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 121 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2c45b37
--- /dev/null
+++ b/README.md
@@ -0,0 +1,121 @@
+# SnipMC
+
+**macOS Menu Bar Screenshot Tool mit integriertem Bildeditor**
+
+![macOS](https://img.shields.io/badge/macOS-14.0+-blue)
+![Swift](https://img.shields.io/badge/Swift-5-orange)
+![License](https://img.shields.io/badge/Lizenz-Freeware-green)
+
+SnipMC ist ein schlankes Screenshot-Tool für macOS, das in der Menüleiste lebt. Es bietet drei Aufnahme-Modi, einen integrierten Bildeditor für Annotationen und ein URL-Schema zur Steuerung über externe Tools wie Logitech Options+, Kurzbefehle oder Stream Deck.
+
+## Features
+
+- **Screenshot-Modi**: Ganzer Bildschirm, Fenster oder frei wählbarer Bereich
+- **Bildeditor**: Pfeile, Rechtecke, Ellipsen und Text-Annotationen
+- **Flexibler Zugriff**: Letzte Aufnahme bearbeiten, Bild aus Zwischenablage, Datei öffnen
+- **URL-Schema** (`snipmc://`): Externe Steuerung per Tastenkürzel, Stream Deck etc.
+- **Einstellungen**: Speicherort, Bildformat (PNG/JPG), konfigurierbare Tastenkürzel
+- **Menüleisten-App**: Kein Dock-Icon, läuft dezent im Hintergrund
+
+## Installation
+
+1. `SnipMC.dmg` aus dem [aktuellen Release](https://github.com/mwende/SnipMC/releases/latest) herunterladen
+2. DMG öffnen und `SnipMC.app` nach `/Programme` ziehen
+3. App starten — das Kamera-Icon erscheint in der Menüleiste
+4. Beim ersten Start die Berechtigung **Bildschirmaufnahme** erteilen:
+   *Systemeinstellungen → Datenschutz & Sicherheit → Bildschirmaufnahme*
+
+## Screenshot-Modi
+
+| Modus | Beschreibung |
+|---|---|
+| Ganzer Bildschirm | Nimmt den gesamten Bildschirm auf |
+| Fenster | Klicke auf ein Fenster, um es aufzunehmen |
+| Bereich auswählen | Ziehe einen Rahmen um den gewünschten Bereich |
+
+## Bildeditor
+
+Der integrierte Editor öffnet sich nicht automatisch nach jeder Aufnahme, sondern nur auf expliziten Wunsch — über das Menü, per URL-Schema oder über die Tastenkombination.
+
+### Werkzeuge
+
+| Werkzeug | Beschreibung |
+|---|---|
+| Pfeil | Linie mit Pfeilspitze zeichnen |
+| Rechteck | Rahmen um einen Bereich zeichnen |
+| Ellipse | Kreis oder Oval zeichnen |
+| Text | Klicke auf eine Stelle und tippe Text ein |
+
+### Tastenkürzel im Editor
+
+| Kürzel | Aktion |
+|---|---|
+| ⌘Z | Rückgängig |
+| ⌘⇧Z | Wiederholen |
+| ⌫ / Entf | Ausgewählte Annotation löschen |
+| ⌘S | Speichern |
+
+## URL-Schema
+
+SnipMC registriert das URL-Schema `snipmc://` und kann so von externen Tools gesteuert werden.
+
+| URL | Aktion |
+|---|---|
+| `snipmc://fullscreen` | Vollbild-Screenshot |
+| `snipmc://window` | Fenster-Screenshot |
+| `snipmc://region` | Bereich-Screenshot |
+| `snipmc://region?edit=true` | Bereich aufnehmen + Editor öffnen |
+| `snipmc://fullscreen?edit=true` | Vollbild aufnehmen + Editor öffnen |
+| `snipmc://edit` | Bild aus Datei im Editor öffnen |
+| `snipmc://editlast` | Letzten Screenshot im Editor bearbeiten |
+| `snipmc://clipboard` | Bild aus Zwischenablage bearbeiten |
+
+### Einrichtung in Logitech Options+
+
+1. Logi Options+ öffnen und Gerät wählen
+2. Taste zuweisen: Aktion = **URL öffnen**
+3. URL eintragen, z. B.: `snipmc://region?edit=true`
+
+### Einrichtung per macOS Kurzbefehle
+
+1. Kurzbefehle-App öffnen
+2. Neuer Kurzbefehl → Aktion **URL öffnen**
+3. URL eintragen, z. B.: `snipmc://region`
+4. Optional: Tastaturkurzbefehl zuweisen
+
+### Einrichtung per Terminal
+
+```bash
+open snipmc://region
+open "snipmc://region?edit=true"
+open snipmc://editlast
+```
+
+## Einstellungen
+
+- **Ausgabe**: Nur speichern, nur Zwischenablage, oder beides
+- **Bildformat**: PNG oder JPG
+- **Speicherort**: Standard `~/Bilder/Screenshots`, frei wählbar
+- **Tastenkürzel**: Für jeden Aufnahme-Modus individuell konfigurierbar
+
+## Systemvoraussetzungen
+
+- macOS 14.0 (Sonoma) oder neuer
+- Berechtigung **Bildschirmaufnahme** erforderlich
+
+## Entwicklung
+
+```bash
+# Voraussetzung: Xcode + XcodeGen
+brew install xcodegen
+
+# Projekt generieren und bauen
+xcodegen generate
+xcodebuild -project SnipMC.xcodeproj -scheme SnipMC -configuration Release build
+```
+
+## Autor
+
+**Marco Wende — [Wende.IT](https://wende.it)**
+
+Freeware — kostenlos nutzbar.