cpod

 1=head1 NAME
 2
 3cpod - cron(8) friendly podcatcher
 4
 5=head1 SYNOPSIS
 6
 7B<cpod> [B<-h>] [B<-p> I<number>] [B<-r> I<number>] [B<-v>]
 8
 9=head1 DESCRIPTION
10
11cpod is a small cron(8) friendly podcatcher which is only responsible
12for downloading podcast episodes. It doesn't play them, it doesn't
13enqueue them and it doesn't track the episodes you already listend to. It
14simply fetches them no more, no less.
15
16If you don't pass any command line flags to cpod it will automatically
17update all feeds and download all (new) episodes. Since cpod supports
18continuous downloads you can also interrupted it at any point and the
19next time you invoke it will automatically resume unfinished downloads
20unless those unfinished downloads are no longer part of your episode
21scope.
22
23cpod is using a plain text file to store your podcast subscriptions. You
24need to manually create this file before starting cpod. Open the file
25with your favorite text editor and add your desired URLs (one per line).
26The file path is documented in the B<FILES> section below.
27
28For OPML import and export two separated optional binaries are provided.
29If you installed them take a look at cpod-import(1) and cpod-export(1)
30in case your are seeking more information.
31
32=head1 OPTIONS
33
34=over 4
35
36=item B<-h>
37
38Display help/defaults and exit.
39
40=item B<-p> I<number>
41
42Number of maximal parallel downloads.
43
44=item B<-r> I<number>
45
46Number of most recent episodes to download.
47
48=item B<-v>
49
50Display version number and exit.
51
52=back
53
54=head1 ENVIRONMENT
55
56=over 4
57
58=item B<CPOD_DOWNLOAD_DIR>
59
60The download directory (default: ~/podcasts).
61
62=item B<XDG_CONFIG_HOME>
63
64Base directory with configuration files (default: ~/.config).
65
66=back
67
68=head1 FILES
69
70=over 4
71
72=item I<~/podcasts>
73
74Default podcast download directory.
75
76=item I<~/.config/cpod/urls>
77
78Plain text file containing all subscribed feeds.
79
80=back
81
82=head1 EXAMPLES
83
84Update all feeds and download new episodes:
85
86	cpod
87
88Download the most recent episodes of each feed:
89
90	cpod -r 1
91
92Subscribe to a new podcast:
93
94	echo "URL" >> "${XDG_CONFIG_HOME:-$HOME/.config}/cpod/urls"
95
96=head1 SEE ALSO
97
98cpod-export(1), cpod-import(1), cron(8)