NAME

       podboat - a podcast download manager for text terminals

SYNOPSIS

       podboat [-C configfile] [-q queuefile] [-a] [-h]

DESCRIPTION

       podboat is a podcast manager for text terminals. It is a helper program to newsboat which
       queues podcast downloads into a file. These queued downloads can then be download with
       newsboat.

OPTIONS

       -h, --help
           Display help

       -C configfile, --config-file=configfile
           Use an alternative configuration file

       -q queuefile, --queue-file=queuefile
           Use an alternative queue file

       -a, --autodownload
           Start automatic download of all queued files on startup

       -l loglevel, --log-level=loglevel
           Generate a logfile with a certain loglevel. Valid loglevels are 1 to 6. An actual
           logfile will only be written when you provide a logfile name.

       -d logfile, --log-file=logfile
           Use this logfile as output when logging debug messages. Please note that this only
           works when providing a loglevel.

PODCAST SUPPORT

       A podcast is a media file distributed over the internet using syndication feeds such as
       RSS, for later playback on portable players or computers. Newsboat contains support for
       downloading and saving podcasts. This support differs a bit from other podcast aggregators
       or "podcatchers" in how it is done.

       Podcast content is transported in RSS feeds via special tags called "enclosures". Newsboat
       recognizes these enclosures and stores the relevant information for every podcast item it
       finds in an RSS feed. Since version 2.0, it also recognizes and handles the Yahoo Media
       RSS extensions. What the user then can do is to add the podcast download URL to a download
       queue. Alternatively, newsboat can be configured to automatically do that. This queue is
       stored in the file $HOME/.newsboat/queue.

       The user can then use the download manager podboat to download these files to a directory
       on the local filesystem. Podboat comes with the newsboat package, and features a look and
       feel very close to the one of newsboat. It also shares the same configuration file.

       Podcasts that have been downloaded but haven’t been played yet remain in the queue but are
       marked as downloaded. You can remove them by purging them from the queue with the "P" key.
       After you’ve played a file and close podboat, it will be removed from the queue. The
       downloaded file remains on the filesystem.

CONFIGURATION COMMANDS

       download-path (parameters: <path>; default value: ~/)
           Specifies the directory where podboat shall download the files to. Optionally, the
           placeholders "%n" (for the podcast feed’s name) and "%h" (for the podcast feed’s
           hostname) can be used to place downloads in a directory structure. (example:
           download-path "~/Downloads/%h/%n")

       max-downloads (parameters: <number>; default value: 1)
           Specifies the maximum number of parallel downloads when automatic download is enabled.
           (example: max-downloads 3)

       player (parameters: <player command>; default value: "")
           Specifies the player that shall be used for playback of downloaded files. (example:
           player "mp3blaster")

XDG BASE DIRECTORY SUPPORT

       Podboat defaults to storing everything in $HOME/.newsboat directory. If you prefer XDG,
       create $HOME/.config/newsboat and $HOME/.local/share/newsboat directories, and Podboat
       will use them from there on.

       If you already have some files in $HOME/.newsboat/, move the queue file to
       $HOME/.local/share/newsboat/, and that should be it.

       See also a corresponding section in newsboat(1).

FILES

       dotfiles
           $HOME/.newsboat/config

           $HOME/.newsboat/urls

       XDG
           $HOME/.config/newsboat/config

           $HOME/.config/newsboat/urls

SEE ALSO

       newsboat(1)

AUTHOR

       Alexander Batischev <eual.jp@gmail.com>
           Author.

                                            12/30/2017                                 PODBOAT(1)