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, placeholders can be
           used to place downloads in a directory structure. See "Format Strings" section of Newsboat manual for
           details on available formats. This setting is applied at enqueueing time; changing it won’t affect
           download paths of the podcasts that were already added to the queue. (example: download-path
           "~/Downloads/%h/%n")

       download-filename-format (parameters: <string>; default value: "%?u?%u&%Y-%b-%d-%H%M%S.unknown?")
           Specifies how podboat would name the files it downloads (see also download-path). See "Format
           Strings" section of Newsboat manual for details on available formats. (example:
           download-filename-format "%F-%t.%e")

       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")

       podlist-format (parameters: <format>; default value: "%4i [%6dMB/%6tMB] [%5p %%] [%7k kb/s] %-20S %u →
       %F")
           This variable defines the format of entries in podboat’s download list. See the respective section in
           the documentation for more information on format strings. (example: podlist-format "%i %u %-20S %F")

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/queue

       XDG
           $HOME/.config/newsboat/config

           $HOME/.local/share/newsboat/queue

ENVIRONMENT

       BROWSER
           Tells Newsboat what browser to use if there is no "browser" setting in the config file. If this
           variable doesn’t exist, a default of lynx(1) will be used.

       CURL_CA_BUNDLE
           Tells Newsboat to use the specified certificate file to verify the peer. The file may contain
           multiple certificates. The certificate(s) must be in PEM format.

           This option is useful if your libcurl is built without useful certificate information, and you can’t
           rebuild the library yourself.

       TMPDIR
           Tells Newsboat to use the specified directory for storing temporary files. If this variable doesn’t
           exist, a default of /tmp will be used.

SEE ALSO

       newsboat(1)

AUTHOR

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

                                                   03/23/2020                                         PODBOAT(1)