Turns YouTube Playlists into well organized Audiobooks
T

Turns YouTube Playlists into well organized Audiobooks

Turns YouTube Playlists into well organized Audiobooks

1,123 stars
N/A forks
N/A contributors

README

Project documentation from GitHub

Turn YouTube Playlists into Audiobooks with Pigeon Pod

Ever find a great YouTube playlist—a lecture series, a collection of talks, or a narrated story—and wish you could listen to it like a podcast on your commute or walk? Manually downloading and stitching those videos together is a hassle. What if you could just point a tool at a playlist and get back a clean, well-organized audio file?

That's exactly what Pigeon Pod does. It’s a neat little open-source tool that automates the process of converting YouTube playlists into single, continuous audio files, structured like chapters in an audiobook. No more tab-hopping or dealing with ads mid-flow.

What It Does

Pigeon Pod is a Python-based tool that takes a YouTube playlist URL, fetches all the video audio tracks, downloads and merges them into one MP3 file, and then embeds chapter markers for each original video. The result is a single audio file you can load onto your phone or music player, where you can easily skip between sections just like a professional audiobook or podcast.

Why It’s Cool

The clever part isn't just the downloading—it's the organization. Pigeon Pod doesn't just dump a bunch of MP3s into a folder. It uses the ffmpeg and yt-dlp power duo to handle the fetching and processing, but then it goes a step further by creating proper metadata chapters. Each video in the playlist becomes a named chapter in the final file, so you know exactly where you are.

It’s also built with a simple, configurable Python script. You can tweak the output quality, specify download directories, and it even handles error logging gracefully if a video is unavailable. This makes it perfect for archiving educational content, curating long-form listening material from conference talks, or even creating personal podcast feeds from favorite creators.

How to Try It

Getting started is straightforward. You’ll need Python and ffmpeg installed on your system.

  1. Clone the repository:

    git clone https://github.com/aizhimou/pigeon-pod.git
    cd pigeon-pod
    
  2. Install the required Python packages:

    pip install -r requirements.txt
    
  3. Ensure ffmpeg is installed and accessible in your system's PATH.

  4. Run the script with a YouTube playlist URL:

    python main.py --url "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID"
    

The script will churn for a bit (depending on playlist length), and your finished audiobook MP3 will appear in the project folder, complete with chapters.

Final Thoughts

Did you like this issue?

Join our weekly newsletter

Love discovering amazing projects?

Help us continue bringing you the best open-source discoveries every week.

Back to Projects
Last updated: Jan 20, 2026