Changelog

Version history and release notes for Intervu.

---

v1.0.1

Bug fix release for macOS packaged app.

Bug Fixes

FFmpeg Not Found in Packaged App

• Packaged .app bundles don't inherit the shell's PATH, so spawn('ffmpeg') failed with ENOENT even when FFmpeg was installed via Homebrew
• Added automatic probing of well-known macOS paths (/opt/homebrew/bin/ffmpeg for Apple Silicon, /usr/local/bin/ffmpeg for Intel)

Silent Audio in Packaged App

• The packaged app was ad-hoc signed with hardened runtime but lacked the com.apple.security.device.audio-input entitlement
• macOS silently provides a zero-byte audio stream when this entitlement is missing — FFmpeg appeared to capture audio but it was all silence
• Added custom entitlements plists with audio input access for both the parent app and child processes (FFmpeg)

Invisible Window After Launch

• The inherited entitlements for child processes were missing com.apple.security.cs.allow-jit, which Electron's renderer process requires for V8/Chromium
• Without JIT, the renderer couldn't execute JavaScript, resulting in a blank/invisible window despite the app running (dock icon visible)
• Added JIT entitlement to the inherited entitlements plist

Improvements

• Improved microphone permission logging on macOS — now logs whether access was granted or denied
• Added .DS_Store to .gitignore

---

v1.0.0

Initial release with core functionality.

Features

Real-Time Audio Capture

• Capture system audio and microphone simultaneously
• Speaker attribution (interviewer vs. you)
• Audio level meters in title bar
• Silent audio filtering (RMS threshold)

Speech-to-Text Integration

• OpenAI-compatible STT endpoint support
• Real-time transcription with speaker labels
• Hallucination phrase filtering
• Configurable audio chunk duration

AI-Powered Answers

• Real-time answer generation
• Streaming response display
• Resume-based personalization
• System prompt customization

Answer Quality Feedback

• Thumbs up/down rating system
• In-context learning from ratings
• Local rating storage
• Clear ratings option

Advanced Mode

• Dual-LLM question extraction
• Intelligent answer queue
• Custom extractor prompts
• Queue mode for multiple answers

Contextual Answer Tips

• Key points bullet extraction
• Confidence score (0-100)
• Structured answer format
• Toggle in advanced settings

Audio Configuration

• Device selection for system audio and microphone
• VB-Cable integration for system capture (Windows)
• BlackHole integration for system capture (macOS)
• Audio routing with SteelSeries GG and Voicemeeter (Windows)
• Multi-output device setup (macOS)
• Device refresh and validation
• Level meter display

Cross-Platform Support

• Windows: DirectShow audio capture, bundled FFmpeg, installer and portable builds
• macOS: AVFoundation audio capture, manual FFmpeg install, DMG and ZIP builds
• Platform-aware device enumeration and error messages
• Microphone permission handling on macOS

Application

• App icon and logo for all platforms
• Floating overlay window
• Always-on-top mode
• Compact dark theme

Settings Management

• Persistent settings storage
• STT/LLM endpoint configuration
• Resume and system prompt editor
• Test connections for STT and LLM

Technical

• FFmpeg bundled download (Windows)
• FFmpeg manual install (macOS via Homebrew)
• IPC communication for CORS bypass
• File-based logging
• Error notifications
• macOS quarantine workaround support

---

Development History

2026-04-09 — Updates

macOS Support

• AVFoundation-based audio device enumeration
• Platform-aware FFmpeg arguments (-f avfoundation on Mac, -f dshow on Windows)
• Microphone permission request on macOS startup
• Mac build targets (DMG/ZIP for x64 and arm64)
• Dock icon and app name for macOS dev mode
• Help text adapted per platform in settings dialog

Application Branding

• Added app icon and logo for all platforms
• Logo displayed in title bar
• Icons bundled for Windows, macOS, and Linux builds

Windows Build Improvements

• Configured NSIS installer build
• Added portable executable build
• Build outputs now go to dist/ directory

2026-04-08 — v1.0.0 Release

• Initial public release
• Core features implemented
• Windows support
• Documentation released

Pre-Release Development

Audio System

• Implemented FFmpeg-based audio capture
• Added DirectShow device enumeration (Windows)
• Added AVFoundation device enumeration (macOS)
• Created audio preview with level metering
• Integrated silence gate filtering

STT Pipeline

• Built audio chunk queue system
• Implemented Whisper transcription
• Added hallucination filtering
• Created speaker attribution

LLM Integration

• Developed streaming response handler
• Implemented answer queue system
• Created rating feedback loop
• Added contextual tips parsing

State Management

• Zustand store implementation
• Settings persistence
• Transcript history
• Q&A history

---

Known Issues

Current Limitations

Issue	Status	Workaround
macOS requires manual FFmpeg install	By design	brew install ffmpeg
macOS app not code-signed	Planned	xattr -d com.apple.quarantine /Applications/Intervu.app
VB-Cable alone blocks system audio on Windows	Documented	Use SteelSeries GG or Voicemeeter for audio routing
Linux support not tested	Planned	Windows or macOS only for now
No offline mode	Planned	Requires STT and LLM running
Cannot record sessions	Planned	Use screen recording

---

Upcoming Features

For planned features, see Roadmap.

Next Release Focus

• Code signing for macOS and Windows
• Keyboard shortcuts
• Session export
• Answer length control

---

Version Format

Intervu uses Semantic Versioning:

• Major (X.0.0): Breaking changes
• Minor (1.X.0): New features
• Patch (1.0.X): Bug fixes

---

Download

Get the latest version from GitHub Releases.

Windows

• Intervu-Setup-x.x.x.exe — Installer
• Intervu-x.x.x-portable.exe — Portable (no installation required)

macOS

• Intervu-x.x.x-arm64.dmg — Apple Silicon (M1/M2/M3/M4)
• Intervu-x.x.x.dmg — Intel Macs
• Intervu-x.x.x-arm64-mac.zip — Apple Silicon (portable)
• Intervu-x.x.x-mac.zip — Intel Macs (portable)

macOS Users

The macOS app is not code-signed. On first launch, remove the quarantine attribute:

xattr -d com.apple.quarantine /Applications/Intervu.app

Code signing will be added in a future release.

Verify Installation

After installing, check your version:

1. Open Intervu
2. Click Settings (gear icon)
3. Scroll to bottom
4. Version number displayed

---

Migration Guide

From Pre-Release

If you used a pre-release version:

1. Settings may not transfer — Reconfigure endpoints
2. Old logs may have issues — Clear logs folder
3. Ratings are preserved — No action needed

Full Reset

Windows:

# Close Intervu
# Delete settings
rmdir /s /q %APPDATA%\intervu
# Restart Intervu
# Reconfigure from scratch

macOS:

# Close Intervu
# Delete settings
rm -rf ~/Library/Application\ Support/intervu
# Restart Intervu
# Reconfigure from scratch

---

Feedback

Found a bug? Have a suggestion?

1. Check existing issues on GitHub
2. Open a new issue with details
3. Include logs from Settings → Open Logs Folder

---

For the complete changelog, see GitHub Releases.