Home/Article
Esadax JournalApps

Podgrab

What is Podgrab? Podgrab is a lightweight, open-source, self-hosted podcast manager designed to automatically download, organize, archive, and play podcast episodes. It provides a web-based interface where users can

Podgrab logo

What is Podgrab?

Podgrab is a lightweight, open-source, self-hosted podcast manager designed to automatically download, organize, archive, and play podcast episodes.

It provides a web-based interface where users can discover podcasts, subscribe to RSS feeds, manage episodes, and maintain a local collection of audio content.

Podgrab periodically checks subscribed podcast feeds for new episodes and downloads them automatically. Users can also download individual episodes or archive entire podcast collections for offline listening.

The application includes an integrated audio player that supports playback of downloaded episodes and streaming directly from original podcast sources.

Podgrab is particularly useful for podcast enthusiasts, travelers, developers, and self-hosting enthusiasts who want to maintain an offline podcast library without relying entirely on third-party podcast streaming applications.

History of Podgrab

Podgrab is an open-source project developed by Akhil Gupta.

The project originated from a personal requirement to download podcast episodes directly for offline playback on portable devices.

It was designed to solve the limitations of conventional podcast applications that do not always provide convenient access to downloadable audio files.

Podgrab evolved into a standalone podcast management application with automatic downloads, podcast discovery, episode organization, and an integrated media player.

The application is primarily written in Go and uses SQLite for database storage.

Podgrab is distributed under the GNU General Public License version 3 (GPL-3.0).

Key Features of Podgrab

Podgrab provides a collection of tools for managing podcast subscriptions and maintaining an offline audio library.

  • Automatic Episode Downloads: Periodically check subscribed feeds and download newly published episodes.
  • Podcast Discovery: Search for podcasts using the integrated iTunes directory.
  • RSS Subscriptions: Add podcasts using their direct RSS feed URLs.
  • OPML Import: Import existing podcast subscriptions from compatible podcast applications.
  • OPML Export: Export subscriptions for migration and backup purposes.
  • Complete Podcast Archiving: Download entire podcast collections for offline storage.
  • On-Demand Downloads: Download individual episodes whenever required.
  • Integrated Audio Player: Listen to downloaded episodes directly through the web interface.
  • Online Streaming: Stream episodes directly from their original sources.
  • Podcast Organization: Group podcasts using customizable tags.
  • Episode Management: Browse, organize, and manage downloaded episodes.
  • Playback Tracking: Mark episodes as played or unplayed.
  • Bookmarks: Save episodes for convenient access later.
  • Duplicate Detection: Detect existing episode files and avoid unnecessary downloads.
  • Custom File Naming: Customize downloaded episode filenames.
  • Podcast Images: Display podcast artwork and episode thumbnails.
  • RSS Generation: Access generated RSS feeds for supported podcast collections and groups.
  • Authentication: Protect application access using optional basic authentication.
  • Dark Mode: Use a dark interface for improved viewing comfort.
  • Lightweight Architecture: Operate with relatively modest server resources.

Use Cases

Podgrab is suitable for individuals and organizations that want to manage podcast subscriptions and maintain locally stored audio archives.

Common use cases include:

  • Personal Podcast Libraries: Maintain a centralized collection of subscribed podcasts.
  • Offline Listening: Download episodes for listening without an internet connection.
  • Travel and Commuting: Prepare podcast episodes before traveling or commuting.
  • Media Archiving: Preserve complete podcast histories locally.
  • Smartwatch Playback: Download audio files for transfer to compatible smartwatches and portable devices.
  • Podcast Research: Organize subscriptions and archive episodes for later reference.
  • Self-Hosted Media Management: Maintain podcast collections independently of commercial streaming services.
  • Developer Workflows: Automatically retrieve podcast episodes for other audio-processing workflows.
  • Limited Connectivity Environments: Maintain access to previously downloaded episodes when internet access is unavailable.

Benefits of Podgrab

  • Self-hosted podcast management
  • Automatic downloads of newly published episodes
  • Local storage of podcast archives
  • Built-in podcast discovery
  • Direct RSS feed subscriptions
  • OPML import and export
  • Integrated browser-based audio player
  • Download and streaming support
  • Podcast grouping through tags
  • Episode bookmarking and playback tracking
  • Duplicate download prevention
  • Customizable episode filenames
  • Lightweight Go-based application
  • SQLite-backed data storage
  • No dependence on a centralized podcast hosting service

How to Install Podgrab

To install Podgrab through Esadax, follow these steps:

  1. Purchase the application through Esadax.
  2. After purchasing, you will be prompted to provide the required configuration parameters, if applicable.
  3. Configure the application access settings.
  4. Configure persistent storage for downloaded episodes and application data.
  5. Set up authentication if the application will be accessed remotely.
  6. Click Deploy to launch Podgrab.
  7. Access the Podgrab interface through its assigned application URL.
  8. Open the settings page and review the available preferences.
  9. Search for a podcast or enter its RSS feed URL.
  10. Add the podcast to your subscription library.
  11. Configure the desired download behavior.
  12. Allow Podgrab to retrieve available episodes.
  13. Start listening through the integrated player.

Once configured, Podgrab automatically monitors subscribed podcasts and downloads new episodes according to its checking schedule.

Podcast Discovery and Subscription Management

Podgrab provides multiple ways to discover and subscribe to podcasts.

Users can search for podcasts through the integrated iTunes podcast directory or add subscriptions manually using RSS feed URLs.

Subscription management includes:

  • Searching for podcasts by name.
  • Adding podcasts using their RSS feed URLs.
  • Importing subscriptions through OPML files.
  • Exporting existing subscriptions.
  • Viewing podcast descriptions and artwork.
  • Managing existing subscriptions.
  • Removing podcasts from the library.
  • Organizing subscriptions with tags.

The integrated search functionality is particularly useful when users do not already know the direct RSS address of a podcast.

For podcasts that are not available through the discovery service, direct RSS subscription provides an alternative.

Automatic Episode Downloads

Automatic downloading is one of Podgrab's primary features.

The application periodically checks subscribed RSS feeds and identifies episodes that have not yet been downloaded.

The download process works as follows:

  1. Podgrab retrieves the RSS feed for each subscribed podcast.
  2. It checks the feed for newly published episodes.
  3. Available episodes are compared against existing records and downloaded files.
  4. New episodes are added to the download queue.
  5. Audio files are downloaded to the local media library.
  6. Episode information and download status are updated.
  7. The episodes become available through the integrated player.

The default feed-checking interval is 30 minutes and can be adjusted through the application deployment settings.

Existing episode files are detected to reduce unnecessary downloads, even when the application database is initialized again.

This functionality makes Podgrab suitable for maintaining an up-to-date local archive of frequently published podcasts.

Podcast Archiving

Podgrab allows users to download and archive complete podcast collections.

Instead of downloading only newly published episodes, users can request the available historical episodes of a podcast.

Archiving capabilities include:

  • Downloading complete podcast histories.
  • Retrieving individual episodes.
  • Monitoring downloaded content.
  • Detecting existing episode files.
  • Maintaining local audio archives.
  • Organizing downloaded episodes by podcast.

This is particularly useful for preserving podcasts that may eventually become unavailable through their original hosting platforms.

The amount of available historical content depends on the RSS feed and the number of episodes exposed by the publisher.

Episode Management and Organization

Podgrab provides tools for organizing downloaded episodes and managing podcast collections.

Users can organize podcasts using tags, allowing related subscriptions to be grouped together.

For example, a personal podcast library could use categories such as:

  • Technology
  • Development
  • Science
  • Business
  • News
  • Education
  • Entertainment
  • Personal Interests

Episode management includes:

  • Browsing downloaded episodes.
  • Viewing episode descriptions.
  • Accessing episode artwork.
  • Marking episodes as played or unplayed.
  • Bookmarking episodes.
  • Downloading individual files.
  • Removing downloaded episodes.
  • Managing podcast subscriptions.

These features make it easier to maintain large podcast libraries and identify episodes that still need to be listened to.

Integrated Podcast Player

Podgrab includes a browser-based audio player for listening to podcast episodes.

Users can play locally downloaded files or stream episodes directly from their original sources.

The player provides a convenient way to access audio content without installing a separate desktop podcast application.

Playback functionality includes:

  • Playing downloaded episodes.
  • Streaming episodes from their original sources.
  • Playing individual episodes.
  • Playing episodes from entire podcasts.
  • Playing grouped podcasts using tags.
  • Managing playback queues.
  • Adding episodes to playlists.
  • Accessing episode information while listening.

The application also supports playlist functionality through a WebSocket connection.

When accessing Podgrab behind a reverse proxy, ensure that WebSocket connections are forwarded correctly for playlist functionality to work.

OPML Import and Export

Podgrab supports OPML, an XML-based format commonly used to exchange podcast subscriptions between applications.

This makes migrating existing subscriptions straightforward.

Importing subscriptions:

  1. Export your subscriptions from your existing podcast application.
  2. Obtain the OPML file.
  3. Open the OPML import functionality in Podgrab.
  4. Upload the exported file.
  5. Review the imported podcast subscriptions.
  6. Allow Podgrab to retrieve the corresponding RSS feeds.

Exporting subscriptions:

  1. Open the podcast management interface.
  2. Select the OPML export functionality.
  3. Download the generated subscription file.
  4. Import the file into another compatible podcast application.

OPML support makes it easier to migrate between podcast management applications without manually adding every subscription again.

RSS Feeds and Content Access

Podgrab works primarily with RSS feeds to retrieve podcast information and episode metadata.

In addition to consuming external feeds, the application can generate RSS feeds for supported podcast collections and tagged groups.

Generated feeds can be useful for connecting Podgrab with compatible podcast applications and other RSS readers.

This provides an additional way to access and organize podcast content outside the main web interface.

File Storage and Media Access

Podgrab stores downloaded audio episodes in a local media directory.

The application maintains episode information in its SQLite database while keeping downloaded media as individual audio files.

This separation allows users to access their audio library independently of the web interface.

Downloaded files can be used with:

  • Desktop audio players
  • Smartphone music applications
  • Compatible smartwatch devices
  • Portable media players
  • Network-accessible media libraries
  • Other applications that support standard audio formats

The application also provides access to stored files through its media-serving interface.

Persistent storage is important to ensure that downloaded episodes remain available after application restarts or upgrades.

Authentication and Security

Podgrab supports optional HTTP Basic Authentication to restrict access to the application.

When authentication is enabled, the standard account username is podgrab, with the password configured by the administrator.

For secure operation, consider the following practices:

  • Enable authentication when exposing the application remotely.
  • Use a strong password.
  • Enable HTTPS for external access.
  • Restrict access to trusted users and networks.
  • Protect the downloaded media directory.
  • Keep the SQLite database and application configuration backed up.
  • Restrict access to application management endpoints.
  • Use secure reverse proxy configuration.
  • Keep the application updated.
  • Avoid exposing the service publicly without appropriate access controls.

Because downloaded podcast episodes are stored locally, ensure that storage permissions are configured appropriately.

Best Practices for Podgrab

  • Subscribe using reliable podcast RSS feeds.
  • Organize subscriptions into meaningful tags.
  • Configure an appropriate feed-checking interval.
  • Monitor available storage capacity.
  • Archive important podcasts regularly.
  • Use episode bookmarks for content that requires later attention.
  • Review downloaded and missing episodes periodically.
  • Configure descriptive episode filenames.
  • Export OPML subscription lists regularly.
  • Protect remote access with authentication and HTTPS.
  • Ensure WebSocket support when using playlist functionality behind a reverse proxy.
  • Back up the application database and downloaded audio files.
  • Test restoration procedures before relying on long-term archives.

Configuration and Application Settings

Podgrab provides a settings page for reviewing and managing application preferences.

After purchasing this application on Esadax, you can configure the available deployment and application settings according to your requirements.

Important settings and operational preferences include:

Setting Description
Podcast Check Frequency Determines how frequently subscribed RSS feeds are checked for new episodes. The default interval is 30 minutes.
Authentication Enables password-protected access to the application.
Episode File Naming Controls how downloaded episode filenames are organized.
Download Preferences Determines how podcast episodes are retrieved and archived.
Media Storage Defines the location used for downloaded podcast episodes.
Configuration Storage Maintains application settings and podcast database information.
Podcast Organization Uses tags to group related subscriptions.

The upstream application uses the username podgrab when basic authentication is enabled.

The exact settings available depend on the deployed application version.

Database and Persistent Storage

Podgrab uses SQLite as its database engine.

The database maintains information such as:

  • Podcast subscriptions
  • Podcast metadata
  • Episode information
  • Download status
  • Podcast tags
  • Application settings
  • Episode playback information
  • Bookmarks

Downloaded audio files are stored separately from the database.

The application uses two important storage locations:

Directory Description
/config Stores application configuration, SQLite database information, and application backups.
/assets Stores downloaded podcast episodes and associated media files.

Both locations should use persistent storage.

For reliable operation:

  • Back up the SQLite database regularly.
  • Include downloaded audio files in backup procedures.
  • Preserve application configuration.
  • Monitor storage consumption.
  • Avoid deleting media files directly while the application is running.
  • Test database and media restoration procedures.

Backing up the database without the audio directory will preserve subscription information but will not preserve the actual downloaded episodes.

Similarly, retaining audio files without the database may require the application to rediscover and reconstruct its podcast information.

Performance and Resource Requirements

Podgrab is a lightweight Go application designed to run on relatively modest hardware.

Its primary resource requirements depend on:

  • Number of subscribed podcasts.
  • Frequency of feed synchronization.
  • Number of available historical episodes.
  • Size of downloaded audio files.
  • Number of simultaneous playback sessions.
  • Available storage capacity.

Most installations do not require substantial processing resources because the application primarily retrieves RSS feeds and downloads audio files.

Sufficient storage is more important for users archiving entire podcast histories.

A connection with adequate bandwidth is also useful when maintaining subscriptions with frequent episode releases.

Project Status and Compatibility

The upstream project identifies version 2022.07.07 as its documented current version.

The repository continues to receive community contributions and issue reports, but its published version information is relatively old.

Before relying on Podgrab for a production podcast archive, review the current repository activity, outstanding issues, and dependency security status.

This is particularly important for installations exposed to the public internet.

Conclusion

Podgrab is a lightweight, self-hosted podcast management application designed to automate podcast downloads and maintain locally accessible audio archives.

With RSS subscriptions, automatic episode downloads, podcast discovery, OPML import and export, customizable organization, duplicate detection, and an integrated audio player, it provides the essential tools for managing a personal podcast library.

Its Go-based architecture and SQLite storage make it a relatively simple application to operate, while its local media storage provides flexibility for listening through browsers, smartphones, and compatible portable devices.

Podgrab is a practical solution for podcast enthusiasts and homelab administrators who want to maintain control over their subscriptions and downloaded audio content without depending entirely on external streaming platforms.

Official Resources

Subscribe