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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of meeting-noter might be problematic. Click here for more details.

@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: meeting-noter
3
- Version: 0.3.0
3
+ Version: 0.3.1
4
4
  Summary: Offline meeting transcription for macOS with automatic meeting detection
5
5
  Author: Victor
6
6
  License: MIT
@@ -19,7 +19,7 @@ Classifier: Programming Language :: Python :: 3.10
19
19
  Classifier: Programming Language :: Python :: 3.11
20
20
  Classifier: Programming Language :: Python :: 3.12
21
21
  Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
22
- Requires-Python: >=3.9
22
+ Requires-Python: <3.13,>=3.9
23
23
  Description-Content-Type: text/markdown
24
24
  Requires-Dist: click>=8.0
25
25
  Requires-Dist: sounddevice>=0.4.6
@@ -47,7 +47,7 @@ Offline meeting transcription tool for macOS. Captures both your voice and meeti
47
47
 
48
48
  ## Features
49
49
 
50
- - **No virtual audio devices needed** - Uses ScreenCaptureKit (like Notion, Discord)
50
+ - **No setup required** - Just install and run
51
51
  - **Captures both sides** - Your mic + system audio (meeting participants)
52
52
  - **Offline transcription** - Uses Whisper locally, no API calls
53
53
  - **Auto-detection** - Detects active meetings (Zoom, Teams, Meet, Slack)
@@ -56,46 +56,23 @@ Offline meeting transcription tool for macOS. Captures both your voice and meeti
56
56
 
57
57
  ## Installation
58
58
 
59
- ### Option 1: Using pipx (Recommended)
60
-
59
+ First, install the LAME audio encoder (required for MP3 encoding):
61
60
  ```bash
62
- # Install pipx if you don't have it
63
- brew install pipx
64
- pipx ensurepath
65
-
66
- # Install meeting-noter
67
- cd /path/to/meeting-noter
68
- pipx install -e .
61
+ brew install lame
69
62
  ```
70
63
 
71
- ### Option 2: Using a virtual environment
72
-
64
+ Then install meeting-noter:
73
65
  ```bash
74
- cd /path/to/meeting-noter
75
- python3 -m venv .venv
76
- .venv/bin/pip install --upgrade pip
77
- .venv/bin/pip install -e .
66
+ pip install meeting-noter
78
67
  ```
79
68
 
80
- Then add an alias in your `~/.zshrc`:
81
-
69
+ Or with pipx (recommended):
82
70
  ```bash
83
- echo 'alias meeting-noter="/path/to/meeting-noter/.venv/bin/meeting-noter"' >> ~/.zshrc
84
- source ~/.zshrc
71
+ pipx install meeting-noter
85
72
  ```
86
73
 
87
74
  ## Quick Start
88
75
 
89
- ### 1. One-time Setup
90
-
91
- ```bash
92
- meeting-noter setup
93
- ```
94
-
95
- This will request Screen Recording permission, which is needed to capture meeting participants' audio.
96
-
97
- ### 2. Launch the App
98
-
99
76
  **Menu Bar App** (recommended):
100
77
  ```bash
101
78
  meeting-noter menubar
@@ -111,14 +88,16 @@ meeting-noter gui
111
88
  meeting-noter start "Weekly Standup"
112
89
  ```
113
90
 
114
- ### 3. Record a Meeting
91
+ The app will request microphone and Screen Recording permissions on first use.
115
92
 
93
+ ## Usage
94
+
95
+ ### Recording
116
96
  - The menu bar app auto-detects meetings and prompts to record
117
97
  - Or manually start recording via the GUI/CLI
118
98
  - Press Ctrl+C (CLI) or click Stop to end recording
119
99
 
120
- ### 4. Transcribe
121
-
100
+ ### Transcription
122
101
  Recordings are auto-transcribed by default. Or manually:
123
102
 
124
103
  ```bash
@@ -136,30 +115,22 @@ meeting-noter list
136
115
 
137
116
  | Command | Description |
138
117
  |---------|-------------|
139
- | `meeting-noter setup` | One-time setup (Screen Recording permission) |
118
+ | `meeting-noter` | Launch desktop GUI |
140
119
  | `meeting-noter menubar` | Launch menu bar app |
141
120
  | `meeting-noter gui` | Launch desktop GUI |
142
121
  | `meeting-noter start [name]` | Interactive CLI recording |
143
- | `meeting-noter daemon` | Start background audio capture |
144
- | `meeting-noter status` | Check daemon status |
145
- | `meeting-noter stop` | Stop the daemon |
146
122
  | `meeting-noter list` | List recent recordings |
147
123
  | `meeting-noter transcribe` | Transcribe a recording |
148
124
  | `meeting-noter devices` | List audio devices |
125
+ | `meeting-noter status` | Check daemon status |
149
126
 
150
127
  ## Options
151
128
 
152
129
  ### `start`
153
130
  - First argument: Meeting name (optional, auto-generates timestamp if omitted)
154
131
 
155
- ### `daemon`
156
- - `-o, --output-dir`: Where to save recordings (default: `~/meetings`)
157
- - `-f, --foreground`: Run in foreground instead of background
158
- - `-n, --name`: Meeting name for the recording
159
-
160
132
  ### `transcribe`
161
133
  - `-m, --model`: Whisper model size (tiny.en, base.en, small.en, medium.en, large-v3)
162
- - `-l, --live`: Real-time transcription (experimental)
163
134
  - `-o, --output-dir`: Directory with recordings
164
135
 
165
136
  ### `list`
@@ -200,41 +171,14 @@ meeting-noter list
200
171
  ~/meetings/2024-01-15_Weekly_Standup.txt
201
172
  ```
202
173
 
203
- ## Permissions Required
174
+ ## Permissions
175
+
176
+ On first use, macOS will ask for:
204
177
 
205
178
  1. **Microphone** - For capturing your voice
206
179
  2. **Screen Recording** - For capturing system audio (meeting participants)
207
- - Grant in: System Settings > Privacy & Security > Screen Recording
208
- - This uses ScreenCaptureKit, the same API used by Notion, Discord, etc.
209
-
210
- ## Troubleshooting
211
-
212
- ### No system audio captured (only my voice)
213
-
214
- Screen Recording permission not granted. Go to:
215
- System Settings > Privacy & Security > Screen Recording
216
-
217
- Enable the toggle for Terminal (or your IDE/app).
218
-
219
- ### Meeting not auto-detected
220
-
221
- Meeting detection works for: Zoom, Microsoft Teams, Google Meet, Slack.
222
- The meeting window must be open (not minimized).
223
180
 
224
- ### Transcription is slow
225
-
226
- Use a smaller model:
227
-
228
- ```bash
229
- meeting-noter transcribe --model tiny.en
230
- ```
231
-
232
- Model sizes:
233
- - `tiny.en` (~75MB) - Fastest, good for most cases
234
- - `base.en` (~150MB) - Better accuracy
235
- - `small.en` (~500MB) - High accuracy
236
- - `medium.en` (~1.5GB) - Very high accuracy
237
- - `large-v3` (~3GB) - Best accuracy
181
+ Grant these in System Settings > Privacy & Security.
238
182
 
239
183
  ## Configuration
240
184
 
@@ -251,10 +195,21 @@ Config file: `~/.config/meeting-noter/config.json`
251
195
  }
252
196
  ```
253
197
 
198
+ ## Whisper Models
199
+
200
+ | Model | Size | Speed | Accuracy |
201
+ |-------|------|-------|----------|
202
+ | `tiny.en` | ~75MB | Fastest | Good |
203
+ | `base.en` | ~150MB | Fast | Better |
204
+ | `small.en` | ~500MB | Medium | High |
205
+ | `medium.en` | ~1.5GB | Slow | Very High |
206
+ | `large-v3` | ~3GB | Slowest | Best |
207
+
254
208
  ## Requirements
255
209
 
256
210
  - macOS 12.3+ (for ScreenCaptureKit)
257
- - Python 3.9+
211
+ - Python 3.9 - 3.12
212
+ - LAME audio encoder (`brew install lame`)
258
213
 
259
214
  ## License
260
215
 
@@ -31,8 +31,8 @@ meeting_noter/resources/icon_512.png,sha256=o7X3ngYcppcIAAk9AcfPx94MUmrsPRp0qBTp
31
31
  meeting_noter/resources/icon_64.png,sha256=TqG7Awx3kK8YdiX1e_z1odZonosZyQI2trlkNZCzUoI,607
32
32
  meeting_noter/transcription/__init__.py,sha256=7GY9diP06DzFyoli41wddbrPv5bVDzH35bmnWlIJev4,29
33
33
  meeting_noter/transcription/engine.py,sha256=HK2J2QOBNIDm1MXW-gkagXP8C8cqUfK_WylHQD_LqOI,6320
34
- meeting_noter-0.3.0.dist-info/METADATA,sha256=FhIlKw7Wg1tRRLsFBmrXkKLa8zf3L2csAtO1bQADbcQ,7952
35
- meeting_noter-0.3.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
36
- meeting_noter-0.3.0.dist-info/entry_points.txt,sha256=rKNhzjSF5-e3bLRr8LVe22FeiwcacXabCvNpoEXfu4I,56
37
- meeting_noter-0.3.0.dist-info/top_level.txt,sha256=9Tuq04_0SXM0OXOHVbOHkHkB5tG3fqkrMrfzCMpbLpY,14
38
- meeting_noter-0.3.0.dist-info/RECORD,,
34
+ meeting_noter-0.3.1.dist-info/METADATA,sha256=GELR_0dUr3kas2fshyQCSC6KkrwfnTCoKRYVsIiUdpU,6724
35
+ meeting_noter-0.3.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
36
+ meeting_noter-0.3.1.dist-info/entry_points.txt,sha256=rKNhzjSF5-e3bLRr8LVe22FeiwcacXabCvNpoEXfu4I,56
37
+ meeting_noter-0.3.1.dist-info/top_level.txt,sha256=9Tuq04_0SXM0OXOHVbOHkHkB5tG3fqkrMrfzCMpbLpY,14
38
+ meeting_noter-0.3.1.dist-info/RECORD,,