Skip to content

snflkd/lecture-notes-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎬 lecture-notes

영상 링크 하나를 → 슬라이드별 요약 노트(단독 HTML · PDF · Markdown)로 바꿔주는 Claude Code 플러그인.

license: MIT Claude Code plugin local & free

강의·설명회·대담·밈 영상 링크를 주면, 다운로드 → 전사(Whisper) → 슬라이드/챕터 검출 → 발언 정렬 → 요약까지 알아서 처리해서, 검색되고 원본 영상의 그 시점으로 바로 점프되는 노트를 만들어 줍니다. 전부 내 컴퓨터에서(로컬·무료), 한국어에 맞춰서.


결과물 모습

슬라이드별 요약 + 핵심정리(TL;DR) + 챕터 네비 + 인페이지 검색 슬라이드 노트 예시

대담/토론이면 — 끝에 "두 사람의 시각: 쟁점·이견"까지 정리 쟁점 정리 예시


✨ 무엇이 들어있나

  • 🗂 이미지가 모두 내장된 단독 HTML — 파일 하나만 보내면 상대도 그대로 봄
  • 타임코드 딥링크 — 요약의 각 항목에서 원본 영상의 그 순간으로 점프(YouTube)
  • 🔍 인페이지 검색 — 요약·발언 원문·슬라이드 속 글자까지 한 번에 찾고 하이라이트
  • 🧭 챕터 네비 + 🔑 TL;DR — 긴 영상도 큰 줄기부터
  • 🃏 복습 플래시카드(Anki TSV) — 바로 암기용으로
  • 📄 PDF · Markdown 동시 산출
  • 🇰🇷 한국어 최적화 — 한국어 전사·OCR·요약 품질에 맞춤

🎯 이런 영상에 강합니다

유형 자동 대응
학원 설명회·세미나 (슬라이드 + 발표자) 발표자·로고·배너를 가리고 슬라이드만, 표 수치까지 요약
촬영형 강의 (벽 투사·칠판/보드) 슬라이드 영역만 오려내 검출
흰 배경 대학 강의 (KOCW 등) 글자 변화로 장면 검출 (그림이 비슷해도)
2인+ 대담 / 토론 누가 말했는지(화자) 구분 + 끝에 합의·이견 종합
무음 자막 밈 / Shorts 가짜 자막(환각) 감지 + 빠르게 바뀌는 자막 추적

지원 소스: YouTube · Daum 라이브 · KOCW (+ 제작자 자막·챕터가 있으면 자동 활용). 새로운 형식을 만나면 마스크/크롭/화자판별 등으로 알아서 적응합니다.

📦 설치

Claude Code에서:

/plugin marketplace add snflkd/lecture-notes-plugin
/plugin install lecture-notes@ljh-plugins

재시작 후 사용. 첫 실행 때 전사 엔진(torch + faster-whisper + whisperX + OCR, 약 3GB·1회)을 전용 환경에 자동 설치할지 물어봅니다. (상세·환경별 주의는 INSTALL.md.)

▶ 사용법

/lecture-notes:lecture-notes https://youtu.be/...

또는 그냥 자연어로: "이 영상 슬라이드별로 정리해줘 <링크>". 결과물은 현재 폴더의 &lt;영상제목&gt;_notes/&lt;영상제목&gt;.html 에 생깁니다 — 그 파일 하나만 열거나 공유하면 됩니다. (긴 영상은 백그라운드로 처리.)

🗣️ 이렇게 요청하면 더 잘 나옵니다

링크만 줘도 되지만, 원하는 형태를 한 줄 덧붙이면 결과가 확 좋아집니다.

  • 형태 지정: "두 사람 의견 갈리는 지점을 마지막에 정리해줘" · "표 수치 위주로" · "누가 무슨 말 했는지 화자별로"
  • 복잡하면 계획부터: "막 하지 말고 어떻게 만들지 먼저 보여줘"
  • 의심되면 검증: "이거 다 잡힌 거 맞아? 프레임 직접 확인해봐" → OCR/출력만 믿지 않고 이미지로 다시 확인
  • 취향 학습: 끝나면 개선점을 물어봅니다. "앞으로 항상/비슷한 영상엔 ~해"라고 답하면 규칙으로 쌓여 다음부터 자동 적용
  • 부분·회차 지정: KOCW 다회차 강의는 "3강으로 해줘", 특정 구간만 등
  • 끝나면 용량 큰 원본 영상을 지울지 물어봅니다(노트는 보존).

💡 용례

  • 의대 입시 2인 대담(32분) → 제작자 챕터 20개를 섹션으로, 발언을 화자별로 태그, 끝에 두 사람의 합의·이견 종합
  • KOCW 면역학 강의(70분) → 60개 슬라이드 챕터 노트 + 플래시카드 18장
  • 학원 설명회 → 슬라이드 표의 인원·비율·등급컷 수치까지 정확히 요약
  • 무음 코딩 밈 Short(34초) → 빠르게 스치는 자막 농담을 순서대로 복원

🧩 요구사항 · 환경

  • Python 3.10–3.12, ffmpeg(필수), Node(선택 — PDF/일부 사이트), GPU 권장(없으면 CPU 전사라 느림)
  • Windows · macOS · Linux (브라우저는 Chrome→Edge→번들 순으로 자동, 터미널 종류 무관)
  • 100% 로컬·무료·프라이버시 — API 키 없음, 사용료 없음, 오디오가 외부로 나가지 않음
  • 권장 모델: Sonnet/Opus 급 — 레이아웃 판단·요약 품질이 모델 능력에 의존(무거운 처리는 스크립트가 담당)

🧭 만듦새

없는 쟁점·없는 자막을 지어내지 않습니다(정직). 완성됐다 말하기 전에 이미지로 직접 확인합니다. 그리고 쓸수록 사용자 취향을 학습합니다 — 이 원칙들은 실제 사용 피드백으로 다듬어졌습니다.

📚 더 보기

  • 상세 설치·환경별 주의·문제해결: INSTALL.md
  • 동작 원리: how-it-works.html
  • 이식성 단위테스트: python skills/lecture-notes/tests/test_platform.py · node skills/lecture-notes/tests/test_browser.js

라이선스: MIT.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors