Add README with documentation
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Claude Opus 4.6
@@ -0,0 +1,121 @@
|
|||||||
|
# SnipMC
|
||||||
|
|
||||||
|
**macOS Menu Bar Screenshot Tool mit integriertem Bildeditor**
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
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.
|
||||||
Reference in New Issue
Block a user