meeting-noter 0.3.0__tar.gz → 0.3.1__tar.gz

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.

Files changed (43) hide show
  1. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/PKG-INFO +32 -77
  2. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/README.md +30 -75
  3. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/pyproject.toml +2 -2
  4. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter.egg-info/PKG-INFO +32 -77
  5. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/setup.cfg +0 -0
  6. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/__init__.py +0 -0
  7. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/__main__.py +0 -0
  8. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/audio/__init__.py +0 -0
  9. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/audio/capture.py +0 -0
  10. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/audio/encoder.py +0 -0
  11. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/audio/system_audio.py +0 -0
  12. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/cli.py +0 -0
  13. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/config.py +0 -0
  14. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/daemon.py +0 -0
  15. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/gui/__init__.py +0 -0
  16. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/gui/__main__.py +0 -0
  17. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/gui/app.py +0 -0
  18. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/gui/main_window.py +0 -0
  19. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/gui/meetings_tab.py +0 -0
  20. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/gui/recording_tab.py +0 -0
  21. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/gui/settings_tab.py +0 -0
  22. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/install/__init__.py +0 -0
  23. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/install/macos.py +0 -0
  24. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/meeting_detector.py +0 -0
  25. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/menubar.py +0 -0
  26. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/output/__init__.py +0 -0
  27. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/output/writer.py +0 -0
  28. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/resources/__init__.py +0 -0
  29. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/resources/icon.icns +0 -0
  30. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/resources/icon.png +0 -0
  31. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/resources/icon_128.png +0 -0
  32. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/resources/icon_16.png +0 -0
  33. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/resources/icon_256.png +0 -0
  34. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/resources/icon_32.png +0 -0
  35. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/resources/icon_512.png +0 -0
  36. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/resources/icon_64.png +0 -0
  37. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/transcription/__init__.py +0 -0
  38. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter/transcription/engine.py +0 -0
  39. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter.egg-info/SOURCES.txt +0 -0
  40. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter.egg-info/dependency_links.txt +0 -0
  41. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter.egg-info/entry_points.txt +0 -0
  42. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter.egg-info/requires.txt +0 -0
  43. {meeting_noter-0.3.0 → meeting_noter-0.3.1}/src/meeting_noter.egg-info/top_level.txt +0 -0
@@ -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
 
@@ -4,7 +4,7 @@ Offline meeting transcription tool for macOS. Captures both your voice and meeti
4
4
 
5
5
  ## Features
6
6
 
7
- - **No virtual audio devices needed** - Uses ScreenCaptureKit (like Notion, Discord)
7
+ - **No setup required** - Just install and run
8
8
  - **Captures both sides** - Your mic + system audio (meeting participants)
9
9
  - **Offline transcription** - Uses Whisper locally, no API calls
10
10
  - **Auto-detection** - Detects active meetings (Zoom, Teams, Meet, Slack)
@@ -13,46 +13,23 @@ Offline meeting transcription tool for macOS. Captures both your voice and meeti
13
13
 
14
14
  ## Installation
15
15
 
16
- ### Option 1: Using pipx (Recommended)
17
-
16
+ First, install the LAME audio encoder (required for MP3 encoding):
18
17
  ```bash
19
- # Install pipx if you don't have it
20
- brew install pipx
21
- pipx ensurepath
22
-
23
- # Install meeting-noter
24
- cd /path/to/meeting-noter
25
- pipx install -e .
18
+ brew install lame
26
19
  ```
27
20
 
28
- ### Option 2: Using a virtual environment
29
-
21
+ Then install meeting-noter:
30
22
  ```bash
31
- cd /path/to/meeting-noter
32
- python3 -m venv .venv
33
- .venv/bin/pip install --upgrade pip
34
- .venv/bin/pip install -e .
23
+ pip install meeting-noter
35
24
  ```
36
25
 
37
- Then add an alias in your `~/.zshrc`:
38
-
26
+ Or with pipx (recommended):
39
27
  ```bash
40
- echo 'alias meeting-noter="/path/to/meeting-noter/.venv/bin/meeting-noter"' >> ~/.zshrc
41
- source ~/.zshrc
28
+ pipx install meeting-noter
42
29
  ```
43
30
 
44
31
  ## Quick Start
45
32
 
46
- ### 1. One-time Setup
47
-
48
- ```bash
49
- meeting-noter setup
50
- ```
51
-
52
- This will request Screen Recording permission, which is needed to capture meeting participants' audio.
53
-
54
- ### 2. Launch the App
55
-
56
33
  **Menu Bar App** (recommended):
57
34
  ```bash
58
35
  meeting-noter menubar
@@ -68,14 +45,16 @@ meeting-noter gui
68
45
  meeting-noter start "Weekly Standup"
69
46
  ```
70
47
 
71
- ### 3. Record a Meeting
48
+ The app will request microphone and Screen Recording permissions on first use.
72
49
 
50
+ ## Usage
51
+
52
+ ### Recording
73
53
  - The menu bar app auto-detects meetings and prompts to record
74
54
  - Or manually start recording via the GUI/CLI
75
55
  - Press Ctrl+C (CLI) or click Stop to end recording
76
56
 
77
- ### 4. Transcribe
78
-
57
+ ### Transcription
79
58
  Recordings are auto-transcribed by default. Or manually:
80
59
 
81
60
  ```bash
@@ -93,30 +72,22 @@ meeting-noter list
93
72
 
94
73
  | Command | Description |
95
74
  |---------|-------------|
96
- | `meeting-noter setup` | One-time setup (Screen Recording permission) |
75
+ | `meeting-noter` | Launch desktop GUI |
97
76
  | `meeting-noter menubar` | Launch menu bar app |
98
77
  | `meeting-noter gui` | Launch desktop GUI |
99
78
  | `meeting-noter start [name]` | Interactive CLI recording |
100
- | `meeting-noter daemon` | Start background audio capture |
101
- | `meeting-noter status` | Check daemon status |
102
- | `meeting-noter stop` | Stop the daemon |
103
79
  | `meeting-noter list` | List recent recordings |
104
80
  | `meeting-noter transcribe` | Transcribe a recording |
105
81
  | `meeting-noter devices` | List audio devices |
82
+ | `meeting-noter status` | Check daemon status |
106
83
 
107
84
  ## Options
108
85
 
109
86
  ### `start`
110
87
  - First argument: Meeting name (optional, auto-generates timestamp if omitted)
111
88
 
112
- ### `daemon`
113
- - `-o, --output-dir`: Where to save recordings (default: `~/meetings`)
114
- - `-f, --foreground`: Run in foreground instead of background
115
- - `-n, --name`: Meeting name for the recording
116
-
117
89
  ### `transcribe`
118
90
  - `-m, --model`: Whisper model size (tiny.en, base.en, small.en, medium.en, large-v3)
119
- - `-l, --live`: Real-time transcription (experimental)
120
91
  - `-o, --output-dir`: Directory with recordings
121
92
 
122
93
  ### `list`
@@ -157,41 +128,14 @@ meeting-noter list
157
128
  ~/meetings/2024-01-15_Weekly_Standup.txt
158
129
  ```
159
130
 
160
- ## Permissions Required
131
+ ## Permissions
132
+
133
+ On first use, macOS will ask for:
161
134
 
162
135
  1. **Microphone** - For capturing your voice
163
136
  2. **Screen Recording** - For capturing system audio (meeting participants)
164
- - Grant in: System Settings > Privacy & Security > Screen Recording
165
- - This uses ScreenCaptureKit, the same API used by Notion, Discord, etc.
166
-
167
- ## Troubleshooting
168
-
169
- ### No system audio captured (only my voice)
170
-
171
- Screen Recording permission not granted. Go to:
172
- System Settings > Privacy & Security > Screen Recording
173
-
174
- Enable the toggle for Terminal (or your IDE/app).
175
-
176
- ### Meeting not auto-detected
177
-
178
- Meeting detection works for: Zoom, Microsoft Teams, Google Meet, Slack.
179
- The meeting window must be open (not minimized).
180
137
 
181
- ### Transcription is slow
182
-
183
- Use a smaller model:
184
-
185
- ```bash
186
- meeting-noter transcribe --model tiny.en
187
- ```
188
-
189
- Model sizes:
190
- - `tiny.en` (~75MB) - Fastest, good for most cases
191
- - `base.en` (~150MB) - Better accuracy
192
- - `small.en` (~500MB) - High accuracy
193
- - `medium.en` (~1.5GB) - Very high accuracy
194
- - `large-v3` (~3GB) - Best accuracy
138
+ Grant these in System Settings > Privacy & Security.
195
139
 
196
140
  ## Configuration
197
141
 
@@ -208,10 +152,21 @@ Config file: `~/.config/meeting-noter/config.json`
208
152
  }
209
153
  ```
210
154
 
155
+ ## Whisper Models
156
+
157
+ | Model | Size | Speed | Accuracy |
158
+ |-------|------|-------|----------|
159
+ | `tiny.en` | ~75MB | Fastest | Good |
160
+ | `base.en` | ~150MB | Fast | Better |
161
+ | `small.en` | ~500MB | Medium | High |
162
+ | `medium.en` | ~1.5GB | Slow | Very High |
163
+ | `large-v3` | ~3GB | Slowest | Best |
164
+
211
165
  ## Requirements
212
166
 
213
167
  - macOS 12.3+ (for ScreenCaptureKit)
214
- - Python 3.9+
168
+ - Python 3.9 - 3.12
169
+ - LAME audio encoder (`brew install lame`)
215
170
 
216
171
  ## License
217
172
 
@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "meeting-noter"
7
- version = "0.3.0"
7
+ version = "0.3.1"
8
8
  description = "Offline meeting transcription for macOS with automatic meeting detection"
9
9
  readme = "README.md"
10
10
  license = {text = "MIT"}
11
- requires-python = ">=3.9"
11
+ requires-python = ">=3.9,<3.13"
12
12
  authors = [
13
13
  {name = "Victor"}
14
14
  ]
@@ -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
 
File without changes