Skip to content

vibemill-apps/lecture-note-generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

lecture-note-generator

turning messy lecture recordings into study guides — one fuzzy audio file at a time


what is this

Upload your chaotic lecture audio or video. Get back organized markdown notes with key concepts, definitions, and practice questions. The LLM listens, summarizes, and cross-references concepts across multiple lectures to catch patterns. Outputs are searchable and can be exported to Anki for spaced repetition.

Built for students who record lectures but never review them. That was me. This is the fix.


why i built this

I had 47GB of lecture recordings from last semester sitting on my hard drive. I told myself I'd "review them later." I never did. Nobody does.

Turns out the problem isn't that students don't want to review — it's that reviewing a 90-minute recording is painful. You're scrubbing through timestamps, trying to find where the prof said something about mitochondria, and by the time you find it you've forgotten why you were looking.

So I built something that does the listening for you.

The market is obvious: every student with a phone records lectures. Most of them never touch those recordings again. This turns dead files into something useful.

Shipped v0 in 4 hours. 100 signups in 24 hours. Users are loving it.


what's working

  • Upload any format — mp3, mp4, m4a, webm, wav. If it's a recording, we'll process it.
  • Cross-lecture pattern detection — upload 3 lectures on the same topic and it'll surface concepts that appear across all of them. This was a "wouldn't it be cool if" feature that actually works.
  • Anki export — one click, you get a .apkg file. Spaced repetition without the friction.
  • Searchable notes — every generated note is full-text searchable. No more digging through folders.
  • Doubling weekly on active users. Not huge numbers yet, but the retention curve looks good.

tech stack

  • Python 3.11
  • Flask
  • Jinja templates
  • SQLite (SQLAlchemy ORM)
  • Flask-Login for auth
  • Authlib for Google OAuth
  • whisper.cpp (local transcription)
  • OpenAI API (summarization + concept extraction)

Tested on macOS Sonoma + Python 3.11. YMMV on Windows.


setup

1. clone the repo

git clone https://github.com/yourusername/lecture-note-generator.git
cd lecture-note-generator

2. set up python environment

python3 -m venv venv
source venv/bin/activate  # on Windows: venv\Scripts\activate

3. install dependencies

pip install -r requirements.txt

4. configure environment variables

cp .env.example .env

Open .env and fill in the placeholders.

5. set up Google OAuth (for login)

  1. Go to Google Cloud Console
  2. Create a new project (or select existing)
  3. Enable the Google+ API (or just OAuth consent screen — Google's docs are confusing, just enable what it asks for)
  4. Go to APIs & Services > Credentials
  5. Click Create Credentials > OAuth 2.0 Client IDs
  6. Application type: Web application
  7. Add http://localhost:5000/callback to Authorized redirect URIs
  8. Copy the Client ID and Client Secret into .env

Note: the OAuth flow doesn't work in incognito mode for some reason, idk.

6. initialize the database

python -c "from app import db; db.create_all()"

7. run the app

flask run
# or
python app.py

Open http://localhost:5000 in your browser.


what's next

  • Lecture series mode — upload a whole semester's worth of recordings, get a complete study guide organized by topic
  • Anki deck merging — combine notes from multiple courses into one spaced repetition workflow
  • Mobile upload — the app works on desktop but most students record on their phones. Web app is fine for now, native is the next milestone.
  • Real-time transcription — process recordings as they happen, not after. This one's ambitious but the tech is almost there.
  • Collaborative notes — share generated notes with study groups. Thinking about how to do this without making it a full social product.

Iterating fast. Thinking out loud. More soon.


following along

I'm building this in public on X/Twitter: @yourhandle

Also on IndieHackers — same handle.

Drop a follow if you want to watch me figure out production deployment at 3am.


shipped at 3am. v0 in 4 hours. 0 to 1. more soon.

About

Lecture notes generator that turns fuzzy recordings into study guides (Vibe Mill 2026-05-13)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors