Skip to content

bassner/fireflies-recorder-macos

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Fireflies Recorder Fireflies Recorder Recording State

Fireflies Recorder for macOS

Record meetings with system audio + mic, auto-upload to Fireflies.ai for transcription

Release License macOS 14.2+ Swift 5.9


Why?

Meeting bots are annoying. They join your calls, interrupt the flow, and make participants uncomfortable. Fireflies Recorder captures everything locally on your Mac—system audio from any app (Zoom, Meet, Teams, etc.) plus your microphone—then uploads to Fireflies.ai for transcription. No bots required.

Works for in-person meetings too. Just open your laptop, hit record, and let it capture the room via your mic. Perfect for workshops, interviews, brainstorms, or any conversation you want transcribed.

Features

  • System Audio Capture — Records all audio playing on your Mac using ScreenCaptureKit
  • Microphone Recording — Captures your voice with selectable input device
  • Auto-Upload — Automatically uploads to Fireflies.ai when recording ends
  • Global Hotkeys — Start/stop recording from anywhere (default: ⌘⌥R)
  • Menu Bar App — Lives in your menu bar, always one click away
  • Privacy First — Everything stays on your Mac until you upload

Quick Start

# 1. Download latest release
curl -sL https://github.com/bassner/fireflies-recorder-macos/releases/latest/download/FirefliesRecorder.dmg -o ~/Downloads/FirefliesRecorder.dmg

# 2. Mount, copy to Applications, and remove quarantine
hdiutil attach ~/Downloads/FirefliesRecorder.dmg
cp -R "/Volumes/Fireflies Recorder/FirefliesRecorder.app" /Applications/
hdiutil detach "/Volumes/Fireflies Recorder"
xattr -cr /Applications/FirefliesRecorder.app

# 3. Launch
open /Applications/FirefliesRecorder.app

Or manually: Download DMG → Drag to Applications → Run xattr -cr /Applications/FirefliesRecorder.app

Setup

1. Grant Permissions

On first launch, grant these permissions when prompted:

Permission Why
Microphone Record your voice
Screen Recording Capture system audio (macOS requirement for ScreenCaptureKit)
Keychain Access Securely store your Fireflies API key

2. Add Your API Key

  1. Get your API key from Fireflies.ai
  2. Click the menu bar icon → SettingsAPI tab
  3. Paste your key and click Save

Usage

Action How
Start recording Click menu bar icon → Start Recording, or press ⌘⌥R
Stop recording Click menu bar icon → Stop Recording, or press ⌘⌥R
Mute mic Press ⌘⌥M
Open settings Click menu bar icon → gear icon

Recordings are saved to the app's container (~/Library/Containers/dev.bassner.ffrecorder/Data/Documents/Fireflies Recordings/) and auto-uploaded if enabled.

Settings

Setting Description
Audio Sources Record mic, system audio, or both
Auto-upload Upload to Fireflies.ai when recording ends
Minimum Duration Only upload recordings longer than X minutes
Launch at Login Start automatically when you log in
Keyboard Shortcuts Customize global hotkeys

Requirements

  • macOS 14.2 or later (ScreenCaptureKit requirement)
  • Fireflies.ai account

Building from Source

Requires XcodeGen:

brew install xcodegen
./build.sh

Output: build/FirefliesRecorder.dmg

Development setup
xcodegen generate
open FirefliesRecorder.xcodeproj
# Build: ⌘B | Run: ⌘R

For consistent code signing (preserves macOS permissions across rebuilds):

echo 'SIGNING_IDENTITY="Apple Development: [email protected] (TEAMID)"' > .build.local

License

GPL v3 — see LICENSE


Made with ❤️ in Munich

About

🎙️ macOS meeting recorder — capture system audio + mic, auto-upload to Fireflies.ai for transcription. No bots.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors