meeting-noter 0.3.0__py3-none-any.whl → 0.3.2__py3-none-any.whl

meeting_noter/audio/encoder.py

@@ -3,12 +3,36 @@
 from __future__ import annotations
 
 import re
+import sys
 import numpy as np
-import lameenc
 from pathlib import Path
 from datetime import datetime
 from typing import Optional, Tuple
 
+# Try to import lameenc, provide helpful error if not available
+try:
+    import lameenc
+    LAMEENC_AVAILABLE = True
+except ImportError:
+    LAMEENC_AVAILABLE = False
+    lameenc = None
+
+
+def _check_lameenc():
+    """Check if lameenc is available, raise helpful error if not."""
+    if not LAMEENC_AVAILABLE:
+        print("\n" + "=" * 60, file=sys.stderr)
+        print("ERROR: MP3 encoding requires the 'lame' library", file=sys.stderr)
+        print("=" * 60, file=sys.stderr)
+        print("\nTo fix this, run:", file=sys.stderr)
+        print("\n    brew install lame", file=sys.stderr)
+        print("\nThen reinstall meeting-noter:", file=sys.stderr)
+        print("\n    pip install --force-reinstall meeting-noter", file=sys.stderr)
+        print("\n" + "=" * 60 + "\n", file=sys.stderr)
+        raise ImportError(
+            "lameenc not available. Install LAME first: brew install lame"
+        )
+
 
 def _sanitize_filename(name: str, max_length: int = 50) -> str:
     """Sanitize a string for use as a filename.
@@ -47,6 +71,7 @@ class MP3Encoder:
         bitrate: int = 128,
         quality: int = 2,
     ):
+        _check_lameenc()
         self.sample_rate = sample_rate
         self.channels = channels
         self.encoder = lameenc.Encoder()

{meeting_noter-0.3.0.dist-info → meeting_noter-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meeting-noter
-Version: 0.3.0
+Version: 0.3.2
 Summary: Offline meeting transcription for macOS with automatic meeting detection
 Author: Victor
 License: MIT
@@ -19,13 +19,12 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
-Requires-Python: >=3.9
+Requires-Python: <3.13,>=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: click>=8.0
 Requires-Dist: sounddevice>=0.4.6
 Requires-Dist: numpy>=1.21
 Requires-Dist: faster-whisper>=1.0.0
-Requires-Dist: lameenc>=1.5.0
 Requires-Dist: rumps>=0.4.0
 Requires-Dist: PyQt6>=6.5.0
 Requires-Dist: pyobjc-framework-Cocoa>=9.0; sys_platform == "darwin"
@@ -34,6 +33,8 @@ Requires-Dist: pyobjc-framework-ScreenCaptureKit>=9.0; sys_platform == "darwin"
 Requires-Dist: pyobjc-framework-AVFoundation>=9.0; sys_platform == "darwin"
 Requires-Dist: pyobjc-framework-CoreMedia>=9.0; sys_platform == "darwin"
 Requires-Dist: pyobjc-framework-libdispatch>=9.0; sys_platform == "darwin"
+Provides-Extra: mp3
+Requires-Dist: lameenc>=1.5.0; extra == "mp3"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -47,7 +48,7 @@ Offline meeting transcription tool for macOS. Captures both your voice and meeti
 
 ## Features
 
-- **No virtual audio devices needed** - Uses ScreenCaptureKit (like Notion, Discord)
+- **No setup required** - Just install and run
 - **Captures both sides** - Your mic + system audio (meeting participants)
 - **Offline transcription** - Uses Whisper locally, no API calls
 - **Auto-detection** - Detects active meetings (Zoom, Teams, Meet, Slack)
@@ -56,45 +57,24 @@ Offline meeting transcription tool for macOS. Captures both your voice and meeti
 
 ## Installation
 
-### Option 1: Using pipx (Recommended)
-
 ```bash
-# Install pipx if you don't have it
-brew install pipx
-pipx ensurepath
-
-# Install meeting-noter
-cd /path/to/meeting-noter
-pipx install -e .
+pip install meeting-noter
 ```
 
-### Option 2: Using a virtual environment
-
+Or with pipx (recommended):
 ```bash
-cd /path/to/meeting-noter
-python3 -m venv .venv
-.venv/bin/pip install --upgrade pip
-.venv/bin/pip install -e .
+pipx install meeting-noter
 ```
 
-Then add an alias in your `~/.zshrc`:
-
+**For MP3 support** (smaller files), install LAME first:
 ```bash
-echo 'alias meeting-noter="/path/to/meeting-noter/.venv/bin/meeting-noter"' >> ~/.zshrc
-source ~/.zshrc
+brew install lame
+pip install meeting-noter[mp3]
 ```
 
-## Quick Start
-
-### 1. One-time Setup
+Without LAME, the app will prompt you to install it when you try to record.
 
-```bash
-meeting-noter setup
-```
-
-This will request Screen Recording permission, which is needed to capture meeting participants' audio.
-
-### 2. Launch the App
+## Quick Start
 
 **Menu Bar App** (recommended):
 ```bash
@@ -111,14 +91,16 @@ meeting-noter gui
 meeting-noter start "Weekly Standup"
 ```
 
-### 3. Record a Meeting
+The app will request microphone and Screen Recording permissions on first use.
+
+## Usage
 
+### Recording
 - The menu bar app auto-detects meetings and prompts to record
 - Or manually start recording via the GUI/CLI
 - Press Ctrl+C (CLI) or click Stop to end recording
 
-### 4. Transcribe
-
+### Transcription
 Recordings are auto-transcribed by default. Or manually:
 
 ```bash
@@ -136,30 +118,22 @@ meeting-noter list
 
 | Command | Description |
 |---------|-------------|
-| `meeting-noter setup` | One-time setup (Screen Recording permission) |
+| `meeting-noter` | Launch desktop GUI |
 | `meeting-noter menubar` | Launch menu bar app |
 | `meeting-noter gui` | Launch desktop GUI |
 | `meeting-noter start [name]` | Interactive CLI recording |
-| `meeting-noter daemon` | Start background audio capture |
-| `meeting-noter status` | Check daemon status |
-| `meeting-noter stop` | Stop the daemon |
 | `meeting-noter list` | List recent recordings |
 | `meeting-noter transcribe` | Transcribe a recording |
 | `meeting-noter devices` | List audio devices |
+| `meeting-noter status` | Check daemon status |
 
 ## Options
 
 ### `start`
 - First argument: Meeting name (optional, auto-generates timestamp if omitted)
 
-### `daemon`
-- `-o, --output-dir`: Where to save recordings (default: `~/meetings`)
-- `-f, --foreground`: Run in foreground instead of background
-- `-n, --name`: Meeting name for the recording
-
 ### `transcribe`
 - `-m, --model`: Whisper model size (tiny.en, base.en, small.en, medium.en, large-v3)
-- `-l, --live`: Real-time transcription (experimental)
 - `-o, --output-dir`: Directory with recordings
 
 ### `list`
@@ -200,41 +174,14 @@ meeting-noter list
     ~/meetings/2024-01-15_Weekly_Standup.txt
 ```
 
-## Permissions Required
+## Permissions
+
+On first use, macOS will ask for:
 
 1. **Microphone** - For capturing your voice
 2. **Screen Recording** - For capturing system audio (meeting participants)
-   - Grant in: System Settings > Privacy & Security > Screen Recording
-   - This uses ScreenCaptureKit, the same API used by Notion, Discord, etc.
-
-## Troubleshooting
-
-### No system audio captured (only my voice)
-
-Screen Recording permission not granted. Go to:
-System Settings > Privacy & Security > Screen Recording
-
-Enable the toggle for Terminal (or your IDE/app).
-
-### Meeting not auto-detected
-
-Meeting detection works for: Zoom, Microsoft Teams, Google Meet, Slack.
-The meeting window must be open (not minimized).
 
-### Transcription is slow
-
-Use a smaller model:
-
-```bash
-meeting-noter transcribe --model tiny.en
-```
-
-Model sizes:
-- `tiny.en` (~75MB) - Fastest, good for most cases
-- `base.en` (~150MB) - Better accuracy
-- `small.en` (~500MB) - High accuracy
-- `medium.en` (~1.5GB) - Very high accuracy
-- `large-v3` (~3GB) - Best accuracy
+Grant these in System Settings > Privacy & Security.
 
 ## Configuration
 
@@ -251,10 +198,21 @@ Config file: `~/.config/meeting-noter/config.json`
 }
 ```
 
+## Whisper Models
+
+| Model | Size | Speed | Accuracy |
+|-------|------|-------|----------|
+| `tiny.en` | ~75MB | Fastest | Good |
+| `base.en` | ~150MB | Fast | Better |
+| `small.en` | ~500MB | Medium | High |
+| `medium.en` | ~1.5GB | Slow | Very High |
+| `large-v3` | ~3GB | Slowest | Best |
+
 ## Requirements
 
 - macOS 12.3+ (for ScreenCaptureKit)
-- Python 3.9+
+- Python 3.9 - 3.12
+- LAME audio encoder (`brew install lame`) - optional but recommended for MP3
 
 ## License
 

{meeting_noter-0.3.0.dist-info → meeting_noter-0.3.2.dist-info}/RECORD

@@ -7,7 +7,7 @@ meeting_noter/meeting_detector.py,sha256=I8zzSdSSmbfd3yyCOyzPL8AS-xSHttFCagrDE35
 meeting_noter/menubar.py,sha256=Wmwaw-_f2Zky6-0DLC5Ql2o6_VBG1-sWacL85dNeGwU,15366
 meeting_noter/audio/__init__.py,sha256=O7PU8CxHSHxMeHbc9Jdwt9kePLQzsPh81GQU7VHCtBY,44
 meeting_noter/audio/capture.py,sha256=fDrT5oXfva8vdFlht9cv60NviKbksw2QeJ8eOtI19uE,6469
-meeting_noter/audio/encoder.py,sha256=UT9yLbURsRfVafRbT-DRianSCx1fOEwWPLP-LULYqVo,5443
+meeting_noter/audio/encoder.py,sha256=C-lGn6S-1KmvfeXMaP032XhifDNMe6sa0RKDZHoZlio,6374
 meeting_noter/audio/system_audio.py,sha256=jbHGjNCerI19weXap0a90Ik17lVTCT1hCEgRKYke-p8,13016
 meeting_noter/gui/__init__.py,sha256=z5GxxaeXyjqyEa9ox0dQxuL5u_BART0bi7cI6rfntEI,103
 meeting_noter/gui/__main__.py,sha256=A2HWdYod0bTgjQQIi21O7XpmgxLH36e_X0aygEUZLls,146
@@ -31,8 +31,8 @@ meeting_noter/resources/icon_512.png,sha256=o7X3ngYcppcIAAk9AcfPx94MUmrsPRp0qBTp
 meeting_noter/resources/icon_64.png,sha256=TqG7Awx3kK8YdiX1e_z1odZonosZyQI2trlkNZCzUoI,607
 meeting_noter/transcription/__init__.py,sha256=7GY9diP06DzFyoli41wddbrPv5bVDzH35bmnWlIJev4,29
 meeting_noter/transcription/engine.py,sha256=HK2J2QOBNIDm1MXW-gkagXP8C8cqUfK_WylHQD_LqOI,6320
-meeting_noter-0.3.0.dist-info/METADATA,sha256=FhIlKw7Wg1tRRLsFBmrXkKLa8zf3L2csAtO1bQADbcQ,7952
-meeting_noter-0.3.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-meeting_noter-0.3.0.dist-info/entry_points.txt,sha256=rKNhzjSF5-e3bLRr8LVe22FeiwcacXabCvNpoEXfu4I,56
-meeting_noter-0.3.0.dist-info/top_level.txt,sha256=9Tuq04_0SXM0OXOHVbOHkHkB5tG3fqkrMrfzCMpbLpY,14
-meeting_noter-0.3.0.dist-info/RECORD,,
+meeting_noter-0.3.2.dist-info/METADATA,sha256=z8Wsm2_khrlm6V56L5TG1RSTyE_RxVrLG1Pq4YdhltA,6865
+meeting_noter-0.3.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+meeting_noter-0.3.2.dist-info/entry_points.txt,sha256=rKNhzjSF5-e3bLRr8LVe22FeiwcacXabCvNpoEXfu4I,56
+meeting_noter-0.3.2.dist-info/top_level.txt,sha256=9Tuq04_0SXM0OXOHVbOHkHkB5tG3fqkrMrfzCMpbLpY,14
+meeting_noter-0.3.2.dist-info/RECORD,,