Skip to content

docs: German quickstart + SPM build path without full Xcode#7

Open
chris2k20 wants to merge 4 commits into
cmagnussen:mainfrom
immodigit:pr/quickstart-spm
Open

docs: German quickstart + SPM build path without full Xcode#7
chris2k20 wants to merge 4 commits into
cmagnussen:mainfrom
immodigit:pr/quickstart-spm

Conversation

@chris2k20

@chris2k20 chris2k20 commented Jun 12, 2026

Copy link
Copy Markdown

Was dieser PR macht

Macht die lokale Installation für unerfahrene Mac-User deutlich einfacher — ohne das große Xcode.

  • README: Deutsche Quickstart-Section (Installation in 3 Copy-Paste-Schritten) inkl. Ersteinrichtung (Mikrofon, Bedienungshilfen, OpenAI-Key).
  • build-spm.sh: Build über Swift Package Manager, der nur die Command Line Tools braucht — kein volles Xcode (~12 GB), kein XcodeGen. Baut die native Architektur und setzt das .app-Bundle inkl. Info.plist, Resources und Ad-hoc-Signierung zusammen.
  • Package.swift / Package.resolved: SPM-Definition mit gepinnter WhisperKit-Dependency.
  • Rebuild-Hinweis: Da der lokale Build ad-hoc signiert ist, verwirft macOS nach jedem Rebuild die Bedienungshilfen-Freigabe (der alte Eintrag sieht aktiv aus, wirkt aber nicht). Dokumentiert inkl. tccutil reset Accessibility app.blitztext.mac.
  • Build-Fix: Bei --install wird die Zwischenkopie im Repo-Ordner entfernt — sonst sieht macOS zwei Kopien und warnt vor doppelten Login-Items.
  • .gitignore: .build/ ergänzt.

Warum

./build.sh setzt ein vollständiges Xcode voraus — hohe Hürde für reines Ausprobieren. Der SPM-Weg ist auf macOS 26 (Apple Silicon, nur CLT) getestet: Build, Install und App-Start funktionieren.

Hinweise

  • build.sh bleibt unverändert der Weg für Universal Binaries.
  • Quickstart ist bewusst auf Deutsch (Zielgruppe der App); Feedback dazu willkommen.

🤖 Generated with Claude Code

chris2k20 and others added 2 commits June 12, 2026 21:41
- README: Quickstart section for inexperienced Mac users (5-minute install)
- build-spm.sh: builds the app with Command Line Tools only (no Xcode needed)
- Package.swift/Package.resolved: SPM definition with pinned WhisperKit dependency

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@chris2k20 chris2k20 requested a review from cmagnussen as a code owner June 12, 2026 19:46
chris2k20 and others added 2 commits June 15, 2026 11:48
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Leaving both the repo copy and the /Applications copy made macOS warn
about duplicate login items and sometimes launch the wrong instance.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant