1PODBOAT(1)                                                          PODBOAT(1)
2
3
4

NAME

6       podboat - a podcast download manager for text terminals
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

17       -h, --help
18           Display help
19
20       -C configfile, --config-file=configfile
21           Use an alternative configuration file
22
23       -q queuefile, --queue-file=queuefile
24           Use an alternative queue file
25
26       -a, --autodownload
27           Start automatic download of all queued files on startup
28
29       -l loglevel, --log-level=loglevel
30           Generate a logfile with a certain loglevel. Valid loglevels are 1
31           to 6. An actual logfile will only be written when you provide a
32           logfile name.
33
34       -d logfile, --log-file=logfile
35           Use this logfile as output when logging debug messages. Please note
36           that this only works when providing a loglevel.
37

PODCAST SUPPORT

39       A podcast is a media file distributed over the internet using
40       syndication feeds such as RSS, for later playback on portable players
41       or computers. Newsboat contains support for downloading and saving
42       podcasts. This support differs a bit from other podcast aggregators or
43       "podcatchers" in how it is done.
44
45       Podcast content is transported in RSS feeds via special tags called
46       "enclosures". Newsboat recognizes these enclosures and stores the
47       relevant information for every podcast item it finds in an RSS feed.
48       Since version 2.0, it also recognizes and handles the Yahoo Media RSS
49       extensions. What the user then can do is to add the podcast download
50       URL to a download queue. Alternatively, newsboat can be configured to
51       automatically do that. This queue is stored in the file
52       $HOME/.newsboat/queue.
53
54       The user can then use the download manager podboat to download these
55       files to a directory on the local filesystem. Podboat comes with the
56       newsboat package, and features a look and feel very close to the one of
57       newsboat. It also shares the same configuration file.
58
59       Podcasts that have been downloaded but haven’t been played yet remain
60       in the queue but are marked as downloaded. You can remove them by
61       purging them from the queue with the "P" key. After you’ve played a
62       file and close podboat, it will be removed from the queue. The
63       downloaded file remains on the filesystem.
64

CONFIGURATION COMMANDS

66       download-path (parameters: <path>; default value: ~/)
67           Specifies the directory where podboat shall download the files to.
68           Optionally, placeholders can be used to place downloads in a
69           directory structure. See "Format Strings" section of Newsboat
70           manual for details on available formats. This setting is applied at
71           enqueueing time; changing it won’t affect download paths of the
72           podcasts that were already added to the queue. (example:
73           download-path "~/Downloads/%h/%n")
74
75       download-filename-format (parameters: <string>; default value:
76       "%?u?%u&%Y-%b-%d-%H%M%S.unknown?")
77           Specifies how podboat would name the files it downloads (see also
78           download-path). See "Format Strings" section of Newsboat manual for
79           details on available formats. (example: download-filename-format
80           "%F-%t.%e")
81
82       max-downloads (parameters: <number>; default value: 1)
83           Specifies the maximum number of parallel downloads when automatic
84           download is enabled. (example: max-downloads 3)
85
86       player (parameters: <player command>; default value: "")
87           Specifies the player that shall be used for playback of downloaded
88           files. (example: player "mp3blaster")
89
90       podlist-format (parameters: <format>; default value: "%4i [%6dMB/%6tMB]
91       [%5p %%] [%7k kb/s] %-20S %u  %F")
92           This variable defines the format of entries in podboat’s download
93           list. See the respective section in the documentation for more
94           information on format strings. (example: podlist-format "%i %u
95           %-20S %F")
96

XDG BASE DIRECTORY SUPPORT

98       Podboat defaults to storing everything in $HOME/.newsboat directory. If
99       you prefer XDG, create $HOME/.config/newsboat and
100       $HOME/.local/share/newsboat directories, and Podboat will use them from
101       there on.
102
103       If you already have some files in $HOME/.newsboat/, move the queue file
104       to $HOME/.local/share/newsboat/, and that should be it.
105
106       See also a corresponding section in newsboat(1).
107

FILES

109       dotfiles
110           $HOME/.newsboat/config
111
112           $HOME/.newsboat/queue
113
114       XDG
115           $HOME/.config/newsboat/config
116
117           $HOME/.local/share/newsboat/queue
118

ENVIRONMENT

120       BROWSER
121           Tells Newsboat what browser to use if there is no "browser" setting
122           in the config file. If this variable doesn’t exist, a default of
123           lynx(1) will be used.
124
125       CURL_CA_BUNDLE
126           Tells Newsboat to use the specified certificate file to verify the
127           peer. The file may contain multiple certificates. The
128           certificate(s) must be in PEM format.
129
130           This option is useful if your libcurl is built without useful
131           certificate information, and you can’t rebuild the library
132           yourself.
133
134       TMPDIR
135           Tells Newsboat to use the specified directory for storing temporary
136           files. If this variable doesn’t exist, a default of /tmp will be
137           used.
138

SEE ALSO

140       newsboat(1)
141

AUTHOR

143       Alexander Batischev <eual.jp@gmail.com>
144           Author.
145
146
147
148                                  01/29/2020                        PODBOAT(1)
Impressum