How nthclrd/unicast-transcript works
Unicast Transcriber is a local web application and CLI for selecting course podcasts, downloading audio, and optionally producing Deepgram transcripts. The main web flow runs from the browser UI through the API server, Unicast course/podcast discovery, a background download job, and transcription to local files; users can view transcripts and open the output folder. The CLI offers a parallel interactive entry point. Edges are limited to relationships shown in excerpts or documented in the README; unsampled server routes and frontend API details are represented conservatively.
Main entry points: server.py Local API server · App.tsx Web workflow · transcribe.py Transcription engine · auth.py Unicast login
Components 19
Local interface
- Web workflow
frontend/src/App.tsx - Course picker
frontend/src/components/CoursePicker.tsx - Podcast selection
frontend/src/components/PodcastPicker.tsx - Credentials settings
frontend/src/components/SettingsDialog.tsx - Job progress
frontend/src/components/JobProgress.tsx - API client
frontend/src/api.ts
API and jobs
- Local API server
server.py - Local credentials
.env.example - Audio and transcripts
- Interactive CLI
run.py
Unicast access
- Unicast login
auth.py - Session cookies
auth.py - Course and podcast catalog
unicast.py
Audio processing
- Podcast downloader
unicast.py - Transcription engine
transcribe.py
Other components
- Student
- Unicast platform
- Deepgram
- ffmpeg
Connections 33
- Student → Web workflow: uses
README.md - Web workflow → Course picker: renders
frontend/src/App.tsx - Web workflow → Podcast selection: renders
frontend/src/App.tsx - Web workflow → Credentials settings: opens
frontend/src/App.tsx - Web workflow → Job progress: renders
frontend/src/App.tsx - Web workflow → API client: requests
frontend/src/App.tsx - Job progress → API client: reads and cancels
frontend/src/components/JobProgress.tsx - Credentials settings → API client: saves settings
frontend/src/components/SettingsDialog.tsx - API client → Local API server: calls API
README.md - Local API server → Local credentials: reads and writes
server.py - Local API server → Unicast login: logs in
server.py - Local API server → Course and podcast catalog: lists courses
server.py - Local API server → Course and podcast catalog: lists podcasts
server.py - Local API server → Podcast downloader: starts job
server.py - Local API server → Transcription engine: transcribes audio
server.py - Local API server → Audio and transcripts: tracks produced files
server.py - Interactive CLI → Unicast login: checks session
run.py - Interactive CLI → Course and podcast catalog: lists podcasts
run.py - Interactive CLI → Podcast downloader: downloads selections
run.py - Interactive CLI → Transcription engine: transcribes downloads
run.py - Unicast login → Local credentials: loads credentials
auth.py - Unicast login → Session cookies: saves cookies
auth.py - Unicast login → Unicast platform: authenticates
auth.py - Course and podcast catalog → Unicast login: loads session; reconnects
unicast.py - Course and podcast catalog → Unicast platform: fetches course data
unicast.py - Podcast downloader → Unicast platform: fetches media links
unicast.py - Podcast downloader → Session cookies: uses cookies
unicast.py - Podcast downloader → Audio and transcripts: writes MP3
README.md - Transcription engine → Local credentials: loads API key
transcribe.py - Transcription engine → Deepgram: sends audio
transcribe.py - Transcription engine → ffmpeg: converts MP4
transcribe.py - Transcription engine → Audio and transcripts: writes transcript
transcribe.py - Job progress → Audio and transcripts: opens output folder
README.md