How maddylaneeee/shengji works
LocalScribe is a native, local-first macOS speech-to-text and transcript-editing app. The main workflow is to choose a recognition source and engine, transcribe audio into editable segments, optionally translate or enhance the transcript, then export it; long tasks can be paused and recovered. The graph also includes the distinct live-caption path and transcript import. The tree and README establish product capabilities, while the sampled excerpts directly support only some internal call relationships, so uncertain wiring is omitted.
Main entry points: TranscriptionSessionModel.swift Transcription session · TranscriptionView.swift Transcription view · RootView.swift Root view · LiveCaptionController.swift Live captions
Components 26
App interface
- Root view
LocalScribe/Views/RootView.swift - Start view
LocalScribe/Views/StartView.swift - Transcription view
LocalScribe/Views/TranscriptionView.swift - Caption panel
LocalScribe/Views/LiveCaptionPanelView.swift - Settings
LocalScribe/Views/SettingsView.swift
Audio recognition
- Transcription session
LocalScribe/Services/TranscriptionSessionModel.swift - Audio pipeline
LocalScribe/Services/AudioPipeline.swift - Realtime capture
LocalScribe/Services/RealtimeAudioCapture.swift - Whisper engine
LocalScribe/Services/WhisperEngine.swift - Sherpa ONNX engine
LocalScribe/Services/SherpaOnnxEngine.swift - Speech model store
LocalScribe/Services/SpeechModelStore.swift - Live captions
LocalScribe/Services/LiveCaptionController.swift
Transcript workflow
- Transcript editor
LocalScribe/Views/TranscriptEditingView.swift - Transcript import
LocalScribe/Services/TranscriptImport.swift - Transcript export
LocalScribe/Services/ExportService.swift
Translation and AI
- Translation
LocalScribe/Services/AppleTranslation.swift - NLLB translation
LocalScribe/Services/NLLBTranslation.swift - Gemma enhancement
LocalScribe/Services/GemmaOptimization.swift - Gemma model manager
LocalScribe/Services/GemmaModelManager.swift
State and storage
- Long-task journal
LocalScribe/Services/LongTaskStorage.swift - Recovery store
LocalScribe/Services/RecoveryStore.swift
Other components
- User
- Microphone
- Audio/video files
- Mac audio
- Apple Speech
Connections 27
- User → Root view: uses
- Root view → Start view: shows
- Root view → Transcription view: shows
- Root view → Settings: shows
- Start view → Transcription session: configures
- Transcription view → Transcription session: controls
- Microphone → Realtime capture: supplies audio
- Audio/video files → Audio pipeline: supplies media
- Mac audio → Live captions: supplies audio
- Transcription session → Audio pipeline: prepares media
- Transcription session → Whisper engine: transcribes
- Transcription session → Sherpa ONNX engine: transcribes
- Transcription session → Apple Speech: transcribes
- Realtime capture → Transcription session: streams audio
- Speech model store → Whisper engine: provides models
- Speech model store → Sherpa ONNX engine: provides models
- Caption panel → Live captions: controls captions
- Live captions → Apple Speech: recognizes audio
- Transcription session → Long-task journal: journals progress
- Transcription session → Recovery store: recovers tasks
- Transcription view → Transcript import: imports transcript
- Transcription view → Transcript editor: edits transcript
- Transcription view → Translation: requests translation
- Transcription view → NLLB translation: requests translation
- Transcription view → Gemma enhancement: enhances transcript
- Gemma enhancement → Gemma model manager: loads model
- Transcription view → Transcript export: exports transcript