Setup

This guide is for people who want to build and inspect the preview themselves.

1. Requirements

macOS 14 or newer
Full Xcode, with Command Line Tools installed
XcodeGen
Homebrew, if you want to install XcodeGen with brew install xcodegen
Optional for online workflows: an OpenAI API key
Optional for secure local transcription: a local WhisperKit/CoreML model

Install XcodeGen manually if needed:

brew install xcodegen

2. Clone And Build

git clone https://github.com/cmagnussen/blitztext-app.git
cd blitztext-app
./build.sh --debug

To launch after building:

./build.sh --run

3. Configure OpenAI For Online Workflows

Open the app settings and paste your own OpenAI API key if you want online transcription or rewriting workflows.

The preview currently uses:

whisper-1 for transcription
gpt-4o-mini for lightweight rewriting
gpt-4o for the calmer-message workflow

You are responsible for API access, billing, and data handling in your own OpenAI account.

Never commit your API key into this repository, issues, logs, or screenshots.

You can skip this step if you only want to test local transcription with a local WhisperKit model.

4. Optional Local Transcription

To use secure local transcription, choose a compatible WhisperKit CoreML model in the app and click Installieren. Blitztext stores models in:

~/Library/Application Support/Blitztext/models/whisperkit/

Recommended first model: openai_whisper-small_216MB.

See local-models.md for the exact command, model links, and expected folder layout.

5. macOS Permissions

The app needs Microphone permission to record audio.

For automatic paste into the previous app, grant Accessibility permission in macOS System Settings. Without it, you can still copy and paste manually.

Troubleshooting

If xcodebuild reports that the active developer directory is only Command Line Tools, run sudo xcode-select -s /Applications/Xcode.app/Contents/Developer.
If the build cannot find XcodeGen, install it explicitly with brew install xcodegen.
If online transcription fails immediately, check whether the API key is present and valid.
If secure local mode is disabled, check whether a WhisperKit model is installed in the expected folder.
If paste does not work, check Accessibility permission.
If audio is missing, check Microphone permission and macOS input settings.
If you see OpenAI errors, verify model access and account billing.

2.5 KiB Raw Blame History