explaingit

mrspideynihal/lecture-video-maker

Analysis updated 2026-05-18

10PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

A Python tool that turns any topic into a lecture video with AI-written narration, free text-to-speech voiceover, stock footage, and subtitles. Runs entirely on local AI models with no paid API required.

Mindmap

mindmap
  root((Lecture Video Maker))
    What it does
      Topic to lecture video
      AI script generation
      Text to speech voiceover
      Stock footage integration
    Tech Stack
      Python
      Ollama local AI
      Edge-TTS
      Pexels API
      FFmpeg
    Interface
      Web UI at localhost
      CLI mode
      Live progress tracking
    Output
      MP4 lecture video
      Script text file
      Per-segment audio
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Turn a study topic into a narrated video lecture for personal learning

USE CASE 2

Create educational video content without recording audio or sourcing footage manually

USE CASE 3

Build course preview videos using a local AI model and free stock footage

USE CASE 4

Generate narrated slide-style videos from written notes or outlines

What is it built with?

PythonOllamaFFmpegEdge-TTSPexels APIPillow

How does it compare?

mrspideynihal/lecture-video-makeralsgur9865-sketch/second-brain-enginecompumaxx/gba-video-studio
Stars101010
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity3/53/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires FFmpeg in PATH, Ollama running locally with a pulled model, and a free Pexels API key before the tool will produce video.

MIT license: use, modify, and distribute freely for any purpose, including commercial use.

In plain English

Lecture Video Maker is a Python tool that turns any text topic into a complete lecture video, including narration, subtitles, and stock footage. You type in a subject, and the tool generates a script using a local AI model, reads it aloud using a Microsoft speech engine, pairs it with relevant video clips or images from Pexels, and combines everything into a single MP4 file. The tool works without paying for AI services. The script writing uses Ollama, which runs AI models locally on your own machine. The voiceover comes from Microsoft Edge-TTS, which is also free. The only account required is a free Pexels API key to pull in stock video and image footage. Video assembly is handled by FFmpeg. You can control the tool two ways: through a web browser interface that opens at localhost:8080, or from the command line. The browser interface lets you set your Pexels key, pick an AI model, choose a voice accent, enter your topic, and watch the video being built in real time. Before the final render, you can review and edit the script segment by segment. The CLI option offers the same process through text prompts instead. Setup requires Python 3.8 or newer, FFmpeg installed on your system and available in your terminal, Ollama running with at least one language model pulled, and a free Pexels account. Once those are in place, install four Python packages and launch the script. The tool saves your settings between runs so you do not need to re-enter the Pexels key every time. Output lands in a folder called lecture_output, organized by topic and timestamp. Each run saves the script, individual audio clips, downloaded footage, subtitle frames, and the finished video. If Pexels returns no results for a topic, the tool falls back to a plain colored background rather than failing.

Copy-paste prompts

Prompt 1
I cloned lecture-video-maker and have Ollama running with llama3. How do I generate a 5-minute lecture on neural networks?
Prompt 2
How do I add a custom voice to lecture-video-maker's Edge-TTS configuration?
Prompt 3
The Pexels API is returning no results for my topic. What fallback does lecture-video-maker use and how do I override it?
Prompt 4
How do I edit individual script segments in the lecture-video-maker web UI before rendering the final video?

Frequently asked questions

What is lecture-video-maker?

A Python tool that turns any topic into a lecture video with AI-written narration, free text-to-speech voiceover, stock footage, and subtitles. Runs entirely on local AI models with no paid API required.

What language is lecture-video-maker written in?

Mainly Python. The stack also includes Python, Ollama, FFmpeg.

What license does lecture-video-maker use?

MIT license: use, modify, and distribute freely for any purpose, including commercial use.

How hard is lecture-video-maker to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is lecture-video-maker for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub mrspideynihal on gitmyhub

Verify against the repo before relying on details.