File: podbeuter.1

package info (click to toggle)
newsbeuter 2.9-5+deb9u2
  • links: PTS
  • area: main
  • in suites: stretch
  • size: 4,692 kB
  • ctags: 3,693
  • sloc: cpp: 18,663; ruby: 1,797; xml: 350; sh: 199; makefile: 171; perl: 101
file content (100 lines) | stat: -rw-r--r-- 4,523 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
'\" t
.\"     Title: podbeuter
.\"    Author: Andreas Krennmair <ak@newsbeuter.org>
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 02/19/2015
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "PODBEUTER" "1" "02/19/2015" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
podbeuter \- a podcast download manage for text terminals
.SH "SYNOPSIS"
.sp
\fIpodbeuter\fR [\-C configfile] [\-q queuefile] [\-a] [\-h]
.SH "DESCRIPTION"
.sp
\fIpodbeuter\fR is a podcast manager for text terminals\&. It is a helper program to \fInewsbeuter\fR which queues podcast downloads into a file\&. These queued downloads can then be download with \fInewsbeuter\fR\&.
.SH "OPTIONS"
.PP
\-h
.RS 4
Display help
.RE
.PP
\-C configfile
.RS 4
Use an alternative configuration file
.RE
.PP
\-q queuefile
.RS 4
Use an alternative queue file
.RE
.PP
\-a
.RS 4
Start automatic download of all queued files on startup
.RE
.SH "PODCAST SUPPORT"
.sp
A podcast is a media file distributed over the internet using syndication feeds such as RSS, for later playback on portable players or computers\&. Newsbeuter contains support for downloading and saving podcasts\&. This support differs a bit from other podcast aggregators or "podcatchers" in how it is done\&.
.sp
Podcast content is transported in RSS feeds via special tags called "enclosures"\&. Newsbeuter 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, newsbeuter can be configured to automatically do that\&. This queue is stored in the file $HOME/\&.newsbeuter/queue\&.
.sp
The user can then use the download manager "podbeuter" to download these files to a directory on the local filesystem\&. Podbeuter comes with the newsbeuter package, and features a look and feel very close to the one of newsbeuter\&. It also shares the same configuration file\&.
.sp
Podcasts that have been downloaded but haven\(cqt been played yet remain in the queue but are marked as downloaded\&. You can remove them by purging them from the queue with the \fIP\fR key\&. After you\(cqve played a file and close podbeuter, it will be removed from the queue\&. The downloaded file remains on the filesystem\&.
.SH "CONFIGURATION COMMANDS"
.PP
\fIdownload\-path\fR (parameters: <path>; default value: \fI~/\fR)
.RS 4
Specifies the directory where podbeuter shall download the files to\&. Optionally, the placeholders "%n" (for the podcast feed\(cqs name) and "%h" (for the podcast feed\(cqs hostname) can be used to place downloads in a directory structure\&. (example: download\-path "~/Downloads/%h/%n")
.RE
.PP
\fImax\-downloads\fR (parameters: <number>; default value: \fI1\fR)
.RS 4
Specifies the maximum number of parallel downloads when automatic download is enabled\&. (example: max\-downloads 3)
.RE
.PP
\fIplayer\fR (parameters: <player command>; default value: \fI""\fR)
.RS 4
Specifies the player that shall be used for playback of downloaded files\&. (example: player "mp3blaster")
.RE
.SH "FILES"
.sp
\fI$HOME/\&.newsbeuter/config\fR
.sp
\fI$HOME/\&.newsbeuter/queue\fR
.SH "SEE ALSO"
.sp
newsbeuter(1)\&. The documentation that comes with newsbeuter is a good source about the general use and configuration of newsbeuter\(cqs podcast support\&.
.SH "AUTHORS"
.sp
Andreas Krennmair <ak@newsbeuter\&.org>, for contributors see AUTHORS file\&.
.SH "AUTHOR"
.PP
\fBAndreas Krennmair\fR <\&ak@newsbeuter\&.org\&>
.RS 4
Author.
.RE