Real-time meeting transcription and AI summaries for macOS, Windows, and Linux.
Record meetings with real-time transcription and AI summaries
Voice-to-text dictation with custom prompts
- Dual audio capture - Records microphone and system audio simultaneously
- Real-time transcription - Live speech-to-text via AssemblyAI
- AI summaries - Automatic meeting summaries with customizable prompts
- Recording history - Browse and search past meetings
- Voice-to-text - Quick dictation with keyboard shortcut
- Custom prompts - Transform dictation with AI (e.g., "make professional", "fix grammar")
- Clipboard integration - Results copied automatically
- Local storage - Transcripts stored as Markdown files on your machine
- Encrypted credentials - API keys secured with OS-level encryption
- Sandboxed - Runs in Electron's sandbox mode for security
| Platform | Download |
|---|---|
| macOS (Apple Silicon) | DMG |
| macOS (Intel) | DMG |
| Windows | Installer |
| Ubuntu/Debian (x64) | DEB |
| Ubuntu/Debian (ARM64) | DEB |
Other Linux distributions: Use AppImage
- Download and install for your platform
- Add your AssemblyAI API key in Settings
- Click Start Recording or use keyboard shortcuts
| Action | macOS | Windows/Linux |
|---|---|---|
| Start/Stop Recording | Cmd+Shift+R |
Ctrl+Shift+R |
| Toggle Dictation | Cmd+Shift+D |
Ctrl+Shift+D |
- Sign up at assemblyai.com (free tier available)
- Copy your API key from the dashboard
- Paste in Assembly Notes Settings
Requirements: Node.js 24+, npm 10+
git clone https://github.com/alexkroman/assembly-notes.git
cd assembly-notes
npm install
npm start# Development
npm start # Build and start app
npm run dev # Watch mode with hot reload
npm run start:fresh # Start with fresh state
# Testing
npm test # Run all tests
npm run test:watch # Watch mode
npm run test:coverage # With coverage report
# Code Quality
npm run lint # ESLint check
npm run format # Prettier format
npm run typecheck # TypeScript check
npm run fix # Auto-fix lint + format
# Building
npm run build:mac # macOS DMG
npm run build:win # Windows installer
npm run build:linux # Linux AppImage/DEB- Electron - Cross-platform desktop framework
- TypeScript - Type-safe JavaScript
- React - UI components
- Redux Toolkit - State management
- AssemblyAI SDK - Real-time transcription
- Vite - Fast build tooling
- tsyringe - Dependency injection
Transcripts are stored as Markdown files with YAML frontmatter:
{userData}/
├── config.json # Settings (electron-store)
├── transcripts/
│ ├── 2024-01-15_team-standup.md
│ ├── 2024-01-16_client-call.md
│ └── ...
└── recordings/
└── {id}.wav # Audio files
- Fork the repository
- Create a feature branch:
git checkout -b feature/my-feature - Make changes and add tests
- Ensure tests pass:
npm test - Commit with a clear message
- Push and open a Pull Request
MIT - see LICENSE