PullaPod

Pull it, play it, preserve it.

Download podcast episodes from RSS feeds with proper naming and artwork embedding

Install Now!

What is PullaPod?

PullaPod is a command line utility (CLI) that downloads podcast episodes and associated artwork.

You provide a RSS feed URL. PullaPod finds, downloads, and organizes the episodes.

Features

Flexible Filtering

Download episodes by specific date, date range, or name matching. Get exactly the episodes you need.

Artwork & Metadata

Automatically downloads episode artwork and embeds it into MP3 files with proper metadata.

Clean Organization

Creates podcast-specific folders with sanitized filenames. No more GUIDs in your file names!

RSS Feed Support

Works with any podcast RSS feed. Download from any podcast that publishes an RSS feed.

Progress Indicators

Track your downloads with clear progress indicators for each episode.

Simple CLI

Straightforward command-line interface with intuitive options and helpful error messages.

Installation

Install PullaPod globally via npm to use it anywhere on your system.

Install from NPM

npm install -g pullapod-cli

Requirements: Node.js 18.0.0 or higher

Usage

Basic Command

pullapod --feed <RSS_URL> [options]

Options

Option	Description
`-f, --feed <url>`	RSS feed URL (required)
`-o, --output <directory>`	Output directory (defaults to current directory)
`-d, --date <date>`	Download episode from specific date (YYYY-MM-DD)
`-s, --start <date>`	Start date for range download (YYYY-MM-DD)
`-e, --end <date>`	End date for range download (YYYY-MM-DD)
`-n, --name <name>`	Download episode by name (partial match)
`--no-metadata`	Skip embedding artwork and metadata

Examples

Download an episode from a specific date

pullapod --feed https://example.com/podcast.rss --date 2024-01-15

Download episodes from a date range

pullapod --feed https://example.com/podcast.rss --start 2024-01-01 --end 2024-01-31

Download episodes by name

pullapod --feed https://example.com/podcast.rss --name "interview"

Download to a specific directory

pullapod --feed https://example.com/podcast.rss --date 2024-01-15 --output ~/Podcasts

File Organization

Downloads are automatically organized into podcast-specific folders:

~/Podcasts/
  My Favorite Podcast/
    Episode 42 - The Answer.mp3
    Episode 42 - The Answer.jpg

Frequently Asked Questions

Why would someone need this? What problem does it solve?

Like all web content, your favorite podcast could vaporize tomorrow for a variety of reasons ranging from mistakes, to apathy, cost, or censorship. Pullapod lets you download podcast episodes and store them somewhere that you control.

Where can I report a bug or request a feature?

Via GitHub issues https://github.com/lwndev/pullapod-cli/issues

I want to use PullaPod, but I don't know where to find RSS Feed URLs

Check out https://podcastindex.org/

Can Pullapod download podcasts from YouTube, or Spotify?

PullaPod only works on non-authenticated RSS feeds.

Can I use PullaPod to access password-protected podcasts?

No. Unauthenticated only.

Can I control the quality of the podcasts that are downloaded?

No. PullaPod downloads at the default file format and bitrate indicated in the RSS feed.

Is there a GUI?

No. Desktop soon. Mobile someday. Maybe...

Does pullapod work with video podcasts?

No. Wait, maybe. Either way, not intentionally.