How nortonfire007/meettrace works
MeetTrace is a local-first Windows meeting recorder: a desktop user starts a session, microphone and system audio are captured, audio is transcribed locally, and the meeting is saved to a searchable Markdown/JSON archive. The desktop UI also supports browsing meetings and optional Gemini summaries; a Chrome companion shares Google Meet context through an authenticated localhost bridge. The graph reflects documented capabilities and source-index references, but several unsampled UI and bridge relationships are shown only where the README documents them.
Main entry points: controller.py Recording controller · app.py App lifecycle · capture/service.py Capture service · transcription/service.py Transcription service
Components 23
Desktop experience
- App lifecycle
src/meettrace/ui/app.py - Recording controller
src/meettrace/ui/controller.py - Floating toolbar
src/meettrace/ui/toolbar.py - Meeting views
src/meettrace/ui/views - Settings view
src/meettrace/ui/views/settings_view.py
Audio capture
- Capture service
src/meettrace/capture/service.py - Windows audio backend
src/meettrace/capture/backend.py - Capture workers
src/meettrace/capture/worker.py
Transcription
- Transcription service
src/meettrace/transcription/service.py - Audio window buffer
src/meettrace/transcription/buffer.py - Whisper adapter
src/meettrace/transcription/whisper_adapter.py
Meeting archive
- Artifact store
src/meettrace/storage/store.py - Markdown formatter
src/meettrace/storage/markdown.py - Meeting catalog
src/meettrace/storage/repository.py - Summary worker
src/meettrace/ui/summary_worker.py
Optional integrations
- Gemini provider
src/meettrace/summary/gemini.py - Local bridge server
src/meettrace/bridge/server.py - Bridge adapter
src/meettrace/bridge/adapter.py - Chrome extension
extension/src/background/service_worker.js
Other components
- Desktop user
- Windows audio devices
- Gemini API
- Google Meet tab
Connections 21
- Desktop user → App lifecycle: starts app
README.md - App lifecycle → Recording controller: initializes
src/meettrace/ui/app.py - App lifecycle → Floating toolbar: creates
src/meettrace/ui/app.py - App lifecycle → Local bridge server: starts
src/meettrace/ui/app.py - Recording controller → Capture service: starts capture
src/meettrace/ui/controller.py - Capture service → Windows audio backend: uses backend
src/meettrace/capture/service.py - Capture service → Capture workers: starts workers
src/meettrace/capture/service.py - Windows audio devices → Windows audio backend: provides audio
README.md - Recording controller → Transcription service: coordinates
src/meettrace/ui/controller.py - Transcription service → Audio window buffer: buffers chunks
src/meettrace/transcription/service.py - Transcription service → Whisper adapter: runs inference
src/meettrace/transcription/service.py - Recording controller → Artifact store: persists session
src/meettrace/ui/controller.py - Recording controller → Meeting catalog: updates archive
src/meettrace/ui/controller.py - Artifact store → Markdown formatter: formats notes
src/meettrace/storage/store.py - Meeting views → Meeting catalog: browses meetings
src/meettrace/ui/views/meeting_list_view.py - Meeting views → Summary worker: requests summaries
src/meettrace/ui/views/meeting_reader_view.py - Summary worker → Gemini provider: requests summary
src/meettrace/ui/summary_worker.py - Gemini provider → Gemini API: calls API
README.md - Google Meet tab → Chrome extension: supplies context
README.md - Chrome extension → Local bridge server: synchronizes context
README.md - Settings view → Chrome extension: pairs token
README.md