-
Notifications
You must be signed in to change notification settings - Fork 0
/
pod-kast.1
121 lines (121 loc) · 4.3 KB
/
pod-kast.1
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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "POD-KAST" "1" "" "Version 0.8.0" "Pod-Kast Documentation"
.hy
.SH NAME
.PP
\f[B]pod-kast\f[R] \[em] starts the command line podcast retrieval
program
.SH SYNOPSIS
.PP
\f[B]pod-kast\f[R]
.PP
\f[B]pod-kast\f[R] [\f[B]-u\f[R] | \f[B]\[en]update\f[R] | \f[B]-d\f[R]
| \f[B]\[en]download\f[R] | \f[B]-h\f[R] | \f[B]\[en]help\f[R]]
.SH DESCRIPTION
.PP
Welcome to Pod-kast 0.8.0 written by Marc Lytle and conceived by myself,
Chime Hart.
.PP
Over many years almost all podcast clients seemed to be lacking an
interface which made sense, as well as features I was hoping for.
The only one I understood was hpodder, but it is no longer available.
In Pod-kast, since I am totally blind and listen with Speakup, a Linux
screen-reader, we took great care to make all functions really obvious
by having numbered menus and yes having the word \[lq]number\[rq] before
each digit removing any ambiguity.
.PP
Here are some conventions for operating the program.
Presssing `q' and pressing enter will quit any menu.
If the number of results to be listed exceeds more than one screen,
press `n' and enter for the next page.
Press `p' and enter to move back pages.
When listing episodes for download or removal from the download queue,
multiple episodes can be chosen.
To choose episodes 1 through 5, episode 9, and episode 13 through 16,
you can enter 1-5 9 13-16 and press enter and they will all be
processed.
Press `q' and hit enter to process the request.
.PP
Just before we begin downloading our favorite podcasts, let\[cq]s go
over in detail each of our menu options.
.IP \[bu] 2
Number 1 Add Catagory.
Sure makes it easier to separate items by subject.
While I only have 2, you may want many more.
It will prompt for a full-path where to save.
.IP \[bu] 2
Number 2 You can edit your catagories.
.IP \[bu] 2
Number 3 Delete a category.
It will not allow you to delete a category if any Podcasts are
associated with it still.
_ Number 4 You can add a new podcast.
It will prompt for an url-and-then which catagory you will store in.
Later we will discuss another way of adding items.
.IP \[bu] 2
Number 5 You can edit an exsisting podcast by altering any of the fields
such as urls, nick-name of podcast, or your chosen catagory.
.IP \[bu] 2
Number 6 You can delete an exsisting podcast.
This can be handy if you have an actual or similar/ duplicate item, as
the program doesn\[cq]t check.
.IP \[bu] 2
Number 7 Choose episodes to download.
This will take you to your list of podcasts to which you are subscribed.
It will prompt you for an category.
If you enter none, it will list all podcasts.
Choose a podcast and the availabel episode will be listed.
As you navigate through pages, it will mark the episodes as viewed and
will not show up the next time you enter a listing of that podcast\[cq]s
episodes.
See archive to view previously viewed episodes.
.IP \[bu] 2
Number 8 You can begin your downloads.
.IP \[bu] 2
Number 9 You can search for podcasts via Apple podcast search.
After typing what you are looking for, you will see the results.
Then you can type numbers separately or with dashes if consecutive.
After that you would hit a q to go to a screen where you will confirm
each catagory and download location of items you have chosen.
Items not chosen will be ignored.
.IP \[bu] 2
Number 10 You can delete items from your download queue.
.IP \[bu] 2
Number 11 You can update all podcasts.
Certainly creating a cron-job would be most efficient, but this manual
way will announce along the way its progress.
Also, from a commandline, you can type pod-kast -u
.IP \[bu] 2
Number 12 You can see previously viewed episodes from your list of
podcasts.
.SS Options
.TP
-u, \[en]update
Updates new episodes for all known podcasts
.TP
-d, \[en]download
Downloads all podcast episodes currently in the download queue
.TP
-h, \[en]help *********not working yet
Prints help file.
.SH FILES
.TP
\f[I]\[ti]/.pod-kast/pod-kast-config\f[R]
Program configuration file.
.TP
\f[I]\[ti]/.pod-kast/pod-kast.db\f[R]
Sqlite database file.
.TP
\f[I]\[ti]/.pod-kast/logs/pod-kast.log\f[R]
Log files if not configured for syslog
.SH BUGS
.PP
See GitHub Issues: <https://github.com/mlytle4218/pod-kast-rust/issues>
.PP
For technical questions email the author.
.PP
For operational questions email chime \[at] <chime@huber-humphrey.com>
.SH AUTHOR
.PP
Marc Lytle <mlytle@gmail.com>