Skip to content

tl;dl: too long; didn't listen. A YouTube Music Podcast summarizer repo.

License

Notifications You must be signed in to change notification settings

makermotion/tldl

Repository files navigation

tl;dl - Too Long; Didn't Listen

License: MIT Python 3.10

tl;dl is an AI-powered podcast summarization tool that converts Google Podcasts episodes into concise summaries. It downloads podcast episodes, transcribes them, generates summaries, and can even create audio versions of the summaries.

Features

  • 🎙️ Download podcasts from YouTube Music Podcasts
  • 📝 Transcribe audio to text using OpenAI's Whisper
  • 🤖 Generate summaries using local LLM through Ollama
  • 🗣️ Convert summaries back to speech using TTS
  • 🌐 User-friendly web interface with Streamlit

Architecture

The project uses the following key technologies:

  • Streamlit - Web interface
  • Whisper - Speech-to-text transcription
  • Ollama - Local LLM for summarization
  • TTS - Text-to-speech synthesis

Prerequisites

  1. Python 3.10.12 or higher
  2. Ollama installed and running locally
  3. At least 8GB RAM recommended
  4. GPU recommended but not required

Installation

  1. Clone the repository:
git clone https://github.com/makermotion/tldl.git
cd tldl
  1. Create and activate virtual environment:
python3.10 -m venv env
source env/bin/activate  # On Windows: .\env\Scripts\activate
  1. Install the package:
pip install .
  1. Start Ollama server with the required model:
ollama run <model> 

Usage

  1. Start the web interface:
streamlit run src/app.py
  1. Open your browser and navigate to http://localhost:8501
  2. Search a podcast by its name like you do in YouTube music.

Known Limitations

  • Processing time depends on episode length and system capabilities.

Contributing

Contributions are welcome! Here are some ways you can help:

  • Submit bug fixes or improvements via pull requests
  • Help with documentation
  • Suggest new features

Current development priorities:

  • Command-line interface implementation
  • Docker containerization
  • Improved podcast source compatibility
  • Performance optimizations

If you encounter any issues or have questions:

  • Create an issue
  • Check existing issues for solutions

License

Released under the MIT License. See LICENSE for details.

About

tl;dl: too long; didn't listen. A YouTube Music Podcast summarizer repo.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages