Resonance 🎙️

Local AI-powered transcription for creators and professionals.

Resonance is a desktop application that provides high-quality audio and video transcription completely offline, using OpenAI's Whisper models. No data ever leaves your computer, ensuring total privacy and security for your sensitive recordings.

✨ Features

• 🔒 100% Private: All processing happens locally on your machine. No cloud uploads.
• ⚡ High Performance: Optimized using Apple Silicon acceleration for instant results.
• 📁 Native Integration: Native file browsers and folder pickers with full macOS permissions.
• 📝 Multiple Formats: Export transcripts as .srt (subtitles), .md (Markdown), or .txt (Plain Text).
• 🌍 Multi-language Support: Auto-detects and transcribes over 90 languages.
• 🔥 No Subscriptions: Free and open-source. Buy the hardware, own the AI.

🚀 Getting Started

Prerequisites

• macOS (Intel or Apple Silicon)
• Python 3.9+
• ffmpeg installed (brew install ffmpeg)
• macOS Users: If you see "App can't be opened because it's from an unidentified developer", run this command in Terminal:

  # For App in Applications folder (Default)
  xattr -dr com.apple.quarantine /Applications/Resonance.app
  
  # For any other path
  xattr -dr com.apple.quarantine /path/to/Resonance.app

Installation

1. Clone this repository:

   git clone https://github.com/cozats/Resonance.git
   cd resonance

2. Fix npm permissions (if needed):

   sudo chown -R $(whoami) ~/.npm

3. Install dependencies:

   npm install

4. Start the app:

   npm start

📦 Building the App

To create a standalone .dmg for distribution (macOS):

npm run build

🛠️ Technology Stack

• Frontend: HTML5, CSS3 (Vanilla), JavaScript
• Backend: Electron.js
• ML Engine: OpenAI Whisper (Python Subprocess)
• Styling: Google Fonts (Space Grotesk), Material Design Icons

---

Made with ❤️ by [Your Name]