1PODBOAT(1) PODBOAT(1)
2
6 podboat - a podcast download manager for text terminals
7
9 podboat [-C configfile] [-q queuefile] [-a] [-h]
10
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
17 -h, --help
18 Display help
19 -C configfile, --config-file=configfile
21 Use an alternative configuration file
22 -q queuefile, --queue-file=queuefile
24 Use an alternative queue file
25 -a, --autodownload
27 Start automatic download of all queued files on startup
28 -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 -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
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 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 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 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
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 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 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 player (parameters: <player command>; default value: "")
87 Specifies the player that shall be used for playback of downloaded
88 files. (example: player "mp3blaster")
89 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
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 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 See also a corresponding section in newsboat(1).
107
109 dotfiles
110 $HOME/.newsboat/config
111 $HOME/.newsboat/queue
113 XDG
115 $HOME/.config/newsboat/config
116 $HOME/.local/share/newsboat/queue
118
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 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 This option is useful if your libcurl is built without useful
131 certificate information, and you can’t rebuild the library
132 yourself.
133 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
140 newsboat(1)
141
143 Alexander Batischev <eual.jp@gmail.com>
144 Author.
145 01/29/2020 PODBOAT(1)