Documentation - PullaPod

Search Command

Search for podcasts using the Podcast Index API. Find feeds by keyword, title, or author.

Syntax

pullapod search <query> [options]

Options

Option	Description
`--max <number>`	Maximum number of results (1-100, default: 10)
`--title-only`	Search titles only (more precise)
`--similar`	Include similar matches (fuzzy matching)
`--language <code>`	Filter by language code (e.g., "en", "es")

Examples

Basic search

pullapod search javascript

Search with result limit

pullapod search "web development" --max 20

Title-only search (more precise)

pullapod search "The Daily" --title-only

Filter by language

pullapod search technology --language en

Include similar matches (fuzzy search)

pullapod search "javascrpt" --similar

Note: Requires Podcast Index API credentials. The search results will show you the feed URL which you can use with the episodes and download commands.

Info Command

View detailed information about a podcast feed before downloading.

Syntax

pullapod info <feed>

The <feed> can be either a feed URL or a Podcast Index feed ID.

Examples

Get info using feed URL

pullapod info https://feeds.fireside.fm/javascriptjabber/rss

Get info using Podcast Index feed ID

pullapod info 920666

Output Includes

Basic metadata: title, author, language, episode count
Feed ID, iTunes ID, feed URL, website, artwork URL
Full description (HTML stripped)
Categories
Content type and explicit flag
Last update time with relative date
Feed health status (Active, Inactive, or Dead)

Episodes Command

Preview episode details before downloading. View titles, dates, durations, and descriptions.

Syntax

pullapod episodes <feed> [options]

The <feed> can be either a feed URL or a Podcast Index feed ID.

Options

Option	Description
`--max <number>`	Maximum episodes to show (1-100, default: 20)
`--since <date>`	Only episodes after date (YYYY-MM-DD format)
`--full`	Show full descriptions instead of truncated

Examples

Preview recent episodes using feed URL

pullapod episodes https://example.com/podcast.rss

Preview episodes using Podcast Index feed ID

pullapod episodes 920666

Show more episodes

pullapod episodes https://example.com/podcast.rss --max 50

Show only episodes since a specific date

pullapod episodes https://example.com/podcast.rss --since 2024-01-01

Show full episode descriptions

pullapod episodes https://example.com/podcast.rss --full

Favorite Command

Save your favorite podcast feeds for quick access and use with the recent command.

Syntax

pullapod favorite <subcommand> [options]

Subcommands

Subcommand	Description
`add <feed-url>`	Add a podcast to favorites
`list`	Show all saved favorites
`remove <name\|url>`	Remove a podcast from favorites
`clear`	Remove all favorites

Options

Option	Description
`--name <name>`	Custom name for the feed (optional, auto-fetches from API)
`--force`	Skip confirmation prompt (for clear subcommand)

Examples

Add a podcast (auto-fetches name from API)

pullapod favorite add https://feeds.fireside.fm/javascriptjabber/rss

Add with a custom name

pullapod favorite add https://feeds.example.com/feed.xml --name "My Podcast"

List all favorites

pullapod favorite list

Remove by name (case-insensitive, supports partial match)

pullapod favorite remove "JavaScript Jabber"

Remove by URL

pullapod favorite remove https://feeds.fireside.fm/javascriptjabber/rss

Clear all favorites (with confirmation)

pullapod favorite clear

Clear all favorites (skip confirmation)

pullapod favorite clear --force

Storage: Favorites are stored in ~/.config/pullapod/favorites.json (or $XDG_CONFIG_HOME/pullapod/favorites.json if set).

Recent Command

Check for new episodes across all your saved favorite podcasts with a single command.

Syntax

pullapod recent [options]

Options

Option	Description
`--max <number>`	Max episodes per feed (1-20, default: 5)
`--days <number>`	Only episodes from last N days (1-90, default: 7)
`--feed <name>`	Show recent episodes from specific saved feed only

Examples

Show recent episodes from all saved feeds (last 7 days)

pullapod recent

Show up to 10 episodes per feed

pullapod recent --max 10

Show episodes from last 14 days

pullapod recent --days 14

Show recent episodes from specific saved feed

pullapod recent --feed "JavaScript Jabber"

Combine options

pullapod recent --feed "Syntax" --max 3 --days 3

Note: The output groups episodes by podcast, showing episode titles and publish dates. Use this to quickly check for new content before downloading.

Download Command

Download podcast episodes from any RSS feed with filtering by date, date range, or episode name.

Syntax

# Using default command (backward compatible)
pullapod --feed <RSS_URL> [options]

# Or using explicit download subcommand
pullapod download --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
`-h, --help`	Display help
`-V, --version`	Display version

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

Download without embedding metadata

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

File Organization

Downloads are automatically organized into podcast-specific folders:

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