podcasthandler 0.5.0

Easily play podcasts

Podcast Handler

A simple tool to play and keep track of your podcasts.

It consist in a simple command-line script and a simple ncurses gui to listen to your podcasts in streaming, without downloading them.

It saves the current elapsed time, so you can stop listening and than continue later restarting from the correct position.

You can manually insert the url of the audio file in the command line, or set it as the default player in your favourite podcast aggregator (I use newsboat, more info above)

Requirements

1. Python >= 3.0
2. Music Player Daemon (link)

Install

To install the package use the python package installer pip:

	pip install podcasthandler

Please note that the music server mpd should be running in your computer, in order to use the program.

You can also download the source code from GitLab:

	git clone https://gitlab.com/fnt400/podcasthandler.git

Usage

Here's the help file:

usage: podcasthandler [-h] [-H HOST] [-u URL] [-p POSITION] [-g] command

positional arguments:
  command               play, stop, status, restart, gui

optional arguments:
  -h, --help            show this help message and exit
  -H HOST, --host HOST  set mpd host (default filod)
  -u URL, --url URL     set podcast episode url
  -p POSITION, --position POSITION
                        set podcast position (mm:ss)
  -g, --gui             start with curses gui

And here's the available commands:

Play

Play a specified url. Without the URL argument, it continues the last played url.

With the POSITION argument, it starts playing from a specific position (minutes:seconds)

You can set the mpd host (if you have other mpd instances in your local network), the next time, if not specified, it will use the same host.

Examples:

	$ podcasthandler play

With this command it will continue playing the last file you listened to, from the correct position in the last mpd server you used (probably your own computer, so "localhost").

	$ podcasthandler play -u "https://www.buzzsprout.com/1263722/5071877-unfettered-freedom-ep-3-facebook-zoom-appimage-kdenlive-new-linux-users.mp3?blob_id=20355212" -H 192.168.1.50 -p 5:24

With this command it will start playing that audio file address in the computer at 192.168.1.50 from 5 minutes and 24 seconds.

Stop

Stop playing.

Status

It displays generic informations about what you are listening to or what you listened the last time.

Restart

Restart from the beginning of the file.

Gui

Start the ncurses gui (only when a file is playing, otherwise you can use command play with the "-g" option).

Newsboat config

You can set podcasthandler to be used in Newsboat adding this line to the config file (usually in ~/.config/newsboat/config).

	browser "podcasthandler play -g -H localhost -u %u"

You can select the playable file within the article, pushing the key "1".

Known Bugs

• gui crashes on window resize