How joaquinruiz/miscoshorts-ai works
Miscoshorts is a command-line YouTube Shorts generator. The user supplies a video URL, then the main script downloads the video, transcribes it, asks Gemini to recommend a segment, and lets the user accept or edit its timestamps. It crops the selected footage to vertical format, adds subtitles, and renders an MP4. The README documents these capabilities, while the sampled source shows the main orchestration and subtitle implementation; dependency internals are not included.
Main entry points: maker.py Shorts workflow · cerebro_gemini.py Segment analysis client · subtitulos.py Subtitle composition
Components 14
Workflow
- Shorts workflow
maker.py - Video download
maker.py - Audio transcription
maker.py - Timestamped transcript
- Suggestion parsing
maker.py - Segment confirmation
maker.py
AI Analysis
- Segment analysis client
cerebro_gemini.py - Gemini
Video Editing
- Vertical crop
maker.py - Subtitle composition
subtitulos.py - MP4 rendering
maker.py - Short video
Other components
- User
- YouTube
Connections 15
- User → Shorts workflow: runs
- YouTube → Video download: provides video
- Shorts workflow → Video download: downloads
- Shorts workflow → Audio transcription: transcribes
- Audio transcription → Timestamped transcript: writes transcript
- Shorts workflow → Segment analysis client: requests analysis
- Segment analysis client → Gemini: sends prompt
- Gemini → Segment analysis client: returns suggestion
- Shorts workflow → Suggestion parsing: parses suggestion
- Shorts workflow → Segment confirmation: requests choice
- User → Segment confirmation: chooses timestamps
- Shorts workflow → Vertical crop: crops segment
- Shorts workflow → Subtitle composition: adds subtitles
- Shorts workflow → MP4 rendering: renders video
- MP4 rendering → Short video: writes MP4