Skip to main content

A Python command line podcast player.

Project description

PyPI version

A command line podcast player, written in Python.

Getting Started


  • Python

  • mpv or mplayer or any other media player that can be launched from the command line


Podcast Player is on PyPI so it can be installed with pip.

$ pip install podcast-player

To upgrade use the -U flag.

$ pip install -U podcast-player


To begin we need to add some podcast rss feeds. This is done one by one with the following command.

$ podcast add URL

If you have an OPML file with podcast subscriptions that you would like to import then you can do so with the -i flag.

$ podcast -i OPML-FILE

The default audio player is mpv in no-video mode. If desired you can change that.

$ podcast set-player mplayer


Once you have added all the podcasts you want to subscribe to, then simply run the ‘podcast’ command to select the podcast and the episode you want to listen to.

$ podcast

For more details run with the help option.

$ podcast --help


  podcast add <url>
  podcast delete
  podcast set-player <player>
  podcast -i <opml-file>
  podcast -h | --help
  podcast --version

  -h --help                         Show this screen.
  --version                         Show version.

  podcast set-player mpv
  podcast set-player mplayer
  podcast add

  For help using this tool, please open an issue on the Github repository:

Built With



This project is licensed under the MIT License

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

podcast-player-1.6.1.tar.gz (7.8 kB view hashes)

Uploaded source

Built Distribution

podcast_player-1.6.1-py2.py3-none-any.whl (8.9 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page