How parhamash96/lecturelens works
LectureLens is a command-line lecture-to-Notion note-taking app. The user supplies course and lecture titles, records audio, and the main workflow uploads it, transcribes it, saves the transcript, generates and saves enhanced notes, publishes them to Notion, then removes local artifacts. The graph distinguishes orchestration from file persistence and external services. The README documents the stages; source excerpts show the calls and storage behavior. The GUI and CLI app files are empty or minimal in the supplied excerpts, so they are not treated as runtime entry points.
Main entry points: main.py Workflow runner · cleaner.py Artifact cleaner · voice_saver.py Audio uploader · google_stt.py Speech transcription
Components 17
Workflow orchestration
- Workflow runner
main.py - Artifact cleaner
src/notetaker/core/cleaner/cleaner.py
Audio and transcription
- Audio recorder
src/notetaker/core/audio_recorder/recorder.py - Audio uploader
src/notetaker/core/google_storage/voice_saver.py - Speech transcription
src/notetaker/core/speech_to_text/google_stt.py
Notes and publishing
- Transcript saver
src/notetaker/core/transcript_saver/transcript_saver.py - Note summariser
src/notetaker/core/summariser/openai_o3.py - Summary saver
src/notetaker/core/summary_saver/summary_saver.py - Notion publisher
src/notetaker/core/publisher/notion_publisher.py
Local data
- Recorded WAV
src/notetaker/core/data - Transcript JSON
src/notetaker/core/data - Notes JSON
src/notetaker/core/data
Other components
- Student
- Google Cloud Storage
- Google Speech-to-Text
- OpenAI API
- Notion
Connections 23
- Student → Workflow runner: starts workflow
README.md - Workflow runner → Audio recorder: invokes
main.py - Workflow runner → Audio uploader: invokes
main.py - Workflow runner → Speech transcription: invokes
main.py - Workflow runner → Transcript saver: invokes
main.py - Workflow runner → Note summariser: invokes
main.py - Workflow runner → Summary saver: invokes
main.py - Workflow runner → Notion publisher: invokes
main.py - Workflow runner → Artifact cleaner: invokes
main.py - Audio recorder → Recorded WAV: writes WAV
src/notetaker/core/audio_recorder/recorder.py - Audio uploader → Recorded WAV: uploads audio
src/notetaker/core/google_storage/voice_saver.py - Audio uploader → Google Cloud Storage: stores audio
src/notetaker/core/google_storage/voice_saver.py - Speech transcription → Google Cloud Storage: reads audio URI
src/notetaker/core/speech_to_text/google_stt.py - Speech transcription → Google Speech-to-Text: requests transcription
src/notetaker/core/speech_to_text/google_stt.py - Transcript saver → Transcript JSON: writes transcript
src/notetaker/core/transcript_saver/transcript_saver.py - Note summariser → Transcript JSON: reads transcript
src/notetaker/core/summariser/openai_o3.py - Note summariser → OpenAI API: requests notes
src/notetaker/core/summariser/openai_o3.py - Summary saver → Notes JSON: writes notes
src/notetaker/core/summary_saver/summary_saver.py - Notion publisher → Notes JSON: reads notes
src/notetaker/core/publisher/notion_publisher.py - Notion publisher → Notion: creates page
src/notetaker/core/publisher/notion_publisher.py - Artifact cleaner → Recorded WAV: removes file
src/notetaker/core/cleaner/cleaner.py - Artifact cleaner → Transcript JSON: removes file
src/notetaker/core/cleaner/cleaner.py - Artifact cleaner → Notes JSON: removes file
src/notetaker/core/cleaner/cleaner.py