meeting-noter 0.3.0__tar.gz

meeting_noter-0.3.0/PKG-INFO

@@ -0,0 +1,261 @@
+Metadata-Version: 2.4
+Name: meeting-noter
+Version: 0.3.0
+Summary: Offline meeting transcription for macOS with automatic meeting detection
+Author: Victor
+License: MIT
+Project-URL: Homepage, https://github.com/tech4vision/meeting-noter
+Project-URL: Repository, https://github.com/tech4vision/meeting-noter
+Project-URL: Issues, https://github.com/tech4vision/meeting-noter/issues
+Keywords: meeting,transcription,whisper,offline,speech-to-text,audio
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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
+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"
+Requires-Dist: pyobjc-framework-Quartz>=9.0; sys_platform == "darwin"
+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: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+
+# Meeting Noter
+
+Offline meeting transcription tool for macOS. Captures both your voice and meeting participants' audio, saves to MP3, and transcribes locally using Whisper.
+
+## Features
+
+- **No virtual audio devices needed** - Uses ScreenCaptureKit (like Notion, Discord)
+- **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)
+- **Multiple interfaces** - Menu bar app, desktop GUI, or CLI
+- **Auto-segmentation** - One file per meeting (detects silence)
+
+## 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 .
+```
+
+### Option 2: Using a virtual environment
+
+```bash
+cd /path/to/meeting-noter
+python3 -m venv .venv
+.venv/bin/pip install --upgrade pip
+.venv/bin/pip install -e .
+```
+
+Then add an alias in your `~/.zshrc`:
+
+```bash
+echo 'alias meeting-noter="/path/to/meeting-noter/.venv/bin/meeting-noter"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+## Quick Start
+
+### 1. One-time Setup
+
+```bash
+meeting-noter setup
+```
+
+This will request Screen Recording permission, which is needed to capture meeting participants' audio.
+
+### 2. Launch the App
+
+**Menu Bar App** (recommended):
+```bash
+meeting-noter menubar
+```
+
+**Desktop GUI**:
+```bash
+meeting-noter gui
+```
+
+**CLI Recording**:
+```bash
+meeting-noter start "Weekly Standup"
+```
+
+### 3. Record a Meeting
+
+- 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
+
+Recordings are auto-transcribed by default. Or manually:
+
+```bash
+# Transcribe the most recent recording
+meeting-noter transcribe
+
+# Transcribe a specific file
+meeting-noter transcribe recording.mp3
+
+# List all recordings
+meeting-noter list
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `meeting-noter setup` | One-time setup (Screen Recording permission) |
+| `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 |
+
+## 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`
+- `-n, --limit`: Number of recordings to show
+- `-o, --output-dir`: Directory with recordings
+
+## How It Works
+
+```
+┌─────────────────────────────────────┐
+│         Your Meeting App            │
+│      (Zoom/Teams/Meet/Slack)        │
+└──────────────────┬──────────────────┘
+                   │
+     ┌─────────────┴─────────────┐
+     ▼                           ▼
+┌─────────┐               ┌─────────────┐
+│   Mic   │               │ System Audio│
+│(default)│               │(ScreenCaptureKit)
+└────┬────┘               └──────┬──────┘
+     │                           │
+     └───────────┬───────────────┘
+                 ▼
+         ┌─────────────┐
+         │Meeting Noter│
+         │  (capture)  │
+         └──────┬──────┘
+                │
+                ▼
+    ~/meetings/2024-01-15_Weekly_Standup.mp3
+                │
+                ▼ (auto or on-demand)
+         ┌─────────────┐
+         │   Whisper   │ (local)
+         └──────┬──────┘
+                │
+                ▼
+    ~/meetings/2024-01-15_Weekly_Standup.txt
+```
+
+## Permissions Required
+
+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
+
+## Configuration
+
+Config file: `~/.config/meeting-noter/config.json`
+
+```json
+{
+    "recordings_dir": "~/meetings",
+    "transcripts_dir": "~/meetings",
+    "whisper_model": "tiny.en",
+    "auto_transcribe": true,
+    "silence_timeout": 5,
+    "capture_system_audio": true
+}
+```
+
+## Requirements
+
+- macOS 12.3+ (for ScreenCaptureKit)
+- Python 3.9+
+
+## License
+
+MIT

meeting_noter-0.3.0/README.md

@@ -0,0 +1,218 @@
+# Meeting Noter
+
+Offline meeting transcription tool for macOS. Captures both your voice and meeting participants' audio, saves to MP3, and transcribes locally using Whisper.
+
+## Features
+
+- **No virtual audio devices needed** - Uses ScreenCaptureKit (like Notion, Discord)
+- **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)
+- **Multiple interfaces** - Menu bar app, desktop GUI, or CLI
+- **Auto-segmentation** - One file per meeting (detects silence)
+
+## 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 .
+```
+
+### Option 2: Using a virtual environment
+
+```bash
+cd /path/to/meeting-noter
+python3 -m venv .venv
+.venv/bin/pip install --upgrade pip
+.venv/bin/pip install -e .
+```
+
+Then add an alias in your `~/.zshrc`:
+
+```bash
+echo 'alias meeting-noter="/path/to/meeting-noter/.venv/bin/meeting-noter"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+## Quick Start
+
+### 1. One-time Setup
+
+```bash
+meeting-noter setup
+```
+
+This will request Screen Recording permission, which is needed to capture meeting participants' audio.
+
+### 2. Launch the App
+
+**Menu Bar App** (recommended):
+```bash
+meeting-noter menubar
+```
+
+**Desktop GUI**:
+```bash
+meeting-noter gui
+```
+
+**CLI Recording**:
+```bash
+meeting-noter start "Weekly Standup"
+```
+
+### 3. Record a Meeting
+
+- 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
+
+Recordings are auto-transcribed by default. Or manually:
+
+```bash
+# Transcribe the most recent recording
+meeting-noter transcribe
+
+# Transcribe a specific file
+meeting-noter transcribe recording.mp3
+
+# List all recordings
+meeting-noter list
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `meeting-noter setup` | One-time setup (Screen Recording permission) |
+| `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 |
+
+## 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`
+- `-n, --limit`: Number of recordings to show
+- `-o, --output-dir`: Directory with recordings
+
+## How It Works
+
+```
+┌─────────────────────────────────────┐
+│         Your Meeting App            │
+│      (Zoom/Teams/Meet/Slack)        │
+└──────────────────┬──────────────────┘
+                   │
+     ┌─────────────┴─────────────┐
+     ▼                           ▼
+┌─────────┐               ┌─────────────┐
+│   Mic   │               │ System Audio│
+│(default)│               │(ScreenCaptureKit)
+└────┬────┘               └──────┬──────┘
+     │                           │
+     └───────────┬───────────────┘
+                 ▼
+         ┌─────────────┐
+         │Meeting Noter│
+         │  (capture)  │
+         └──────┬──────┘
+                │
+                ▼
+    ~/meetings/2024-01-15_Weekly_Standup.mp3
+                │
+                ▼ (auto or on-demand)
+         ┌─────────────┐
+         │   Whisper   │ (local)
+         └──────┬──────┘
+                │
+                ▼
+    ~/meetings/2024-01-15_Weekly_Standup.txt
+```
+
+## Permissions Required
+
+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
+
+## Configuration
+
+Config file: `~/.config/meeting-noter/config.json`
+
+```json
+{
+    "recordings_dir": "~/meetings",
+    "transcripts_dir": "~/meetings",
+    "whisper_model": "tiny.en",
+    "auto_transcribe": true,
+    "silence_timeout": 5,
+    "capture_system_audio": true
+}
+```
+
+## Requirements
+
+- macOS 12.3+ (for ScreenCaptureKit)
+- Python 3.9+
+
+## License
+
+MIT

meeting_noter-0.3.0/pyproject.toml

@@ -0,0 +1,75 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "meeting-noter"
+version = "0.3.0"
+description = "Offline meeting transcription for macOS with automatic meeting detection"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+authors = [
+    {name = "Victor"}
+]
+keywords = ["meeting", "transcription", "whisper", "offline", "speech-to-text", "audio"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Sound/Audio :: Speech",
+]
+
+dependencies = [
+    "click>=8.0",
+    "sounddevice>=0.4.6",
+    "numpy>=1.21",
+    "faster-whisper>=1.0.0",
+    "lameenc>=1.5.0",
+    "rumps>=0.4.0",
+    "PyQt6>=6.5.0",
+    "pyobjc-framework-Cocoa>=9.0; sys_platform == 'darwin'",
+    "pyobjc-framework-Quartz>=9.0; sys_platform == 'darwin'",
+    "pyobjc-framework-ScreenCaptureKit>=9.0; sys_platform == 'darwin'",
+    "pyobjc-framework-AVFoundation>=9.0; sys_platform == 'darwin'",
+    "pyobjc-framework-CoreMedia>=9.0; sys_platform == 'darwin'",
+    "pyobjc-framework-libdispatch>=9.0; sys_platform == 'darwin'",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov",
+    "black",
+    "ruff",
+    "mypy",
+]
+
+[project.scripts]
+meeting-noter = "meeting_noter.cli:cli"
+
+[project.urls]
+Homepage = "https://github.com/tech4vision/meeting-noter"
+Repository = "https://github.com/tech4vision/meeting-noter"
+Issues = "https://github.com/tech4vision/meeting-noter/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+meeting_noter = ["resources/*.png", "resources/*.icns"]
+
+[tool.black]
+line-length = 100
+target-version = ["py39", "py310", "py311", "py312"]
+
+[tool.ruff]
+line-length = 100
+select = ["E", "F", "I", "N", "W"]

meeting_noter-0.3.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

meeting_noter-0.3.0/src/meeting_noter/__init__.py

@@ -0,0 +1,3 @@
+"""Meeting Noter - Offline meeting transcription with virtual audio devices."""
+
+__version__ = "0.1.0"

meeting_noter-0.3.0/src/meeting_noter/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for python -m meeting_noter."""
+
+from meeting_noter.cli import cli
+
+if __name__ == "__main__":
+    cli()

meeting_noter-0.3.0/src/meeting_noter/audio/__init__.py

@@ -0,0 +1 @@
+"""Audio capture and processing modules."""