How confignomad/study-scribe works
StudyScribe is a desktop tool for turning YouTube video or playlist captions into study materials. The intended workflow is to validate or enumerate videos, download caption tracks, format transcripts, and write Markdown or other outputs. The README describes some capabilities as roadmap work, while the indexed service modules and sampled excerpts show additional implementations; the graph represents those modules without assuming every stage is wired into the GUI. Some GUI and service source is unsampled, so unsupported call relationships are omitted.
Main entry points: main.py Application entry · main_window.py Main window · markdown_export.py Markdown generation · exporter.py Document export
Components 15
Desktop application
- Application entry
main.py - Main window
app/gui/main_window.py - App settings
app/config/settings.py - Logging
app/utils/logger.py
Video discovery
- URL validation
app/services/youtube.py - Playlist enumeration
app/services/playlist.py
Caption and transcript processing
- Caption download
app/services/captions.py - Raw caption files
- Transcript formatting
app/services/transcript_format.py
Study outputs
- Markdown generation
app/services/markdown_export.py - Document export
app/services/exporter.py - Study-guide prompts
app/services/study_guide.py - Generated study files
Other components
- User
- YouTube
Connections 20
- User → Application entry: launches
README.md - Application entry → Main window: launches
main.py - Main window → URL validation: validates URL
README.md - Main window → Playlist enumeration: enumerates playlist
app/gui/main_window.py - Main window → Caption download: downloads captions
app/gui/main_window.py - URL validation → YouTube: checks availability
app/services/youtube.py - Playlist enumeration → YouTube: fetches metadata
app/services/playlist.py - Caption download → YouTube: fetches tracks
app/services/captions.py - Caption download → Raw caption files: writes captions
app/services/captions.py - Markdown generation → Raw caption files: reads captions
app/services/markdown_export.py - Document export → Raw caption files: reads captions
app/services/exporter.py - Study-guide prompts → Raw caption files: reads captions
app/services/study_guide.py - Markdown generation → Transcript formatting: formats transcript
app/services/markdown_export.py - Document export → Transcript formatting: formats transcript
app/services/exporter.py - Study-guide prompts → Transcript formatting: formats transcript
app/services/study_guide.py - Markdown generation → Generated study files: writes Markdown
app/services/markdown_export.py - Document export → Generated study files: writes formats
app/services/exporter.py - Study-guide prompts → Generated study files: writes prompts
app/services/study_guide.py - Application entry → App settings: loads settings
main.py - Application entry → Logging: configures logging
main.py