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
|
.TH http-music-crawl-http 1
.SH NAME
http-music-crawl-http - create a playlist file using an HTTP-based directory listing
.SH SYNOPSIS
.B http-music crawl-http
<download URL>
[opts...]
.SH DESCRIPTION
\fBhttp-music-crawl-http\fR is a (convolutedly-named) command line utility used to generate playlist files for \fBhttp-music\fR by crawling the directory listing found at a given URL.
http-music uses playlist files as its source of music; without a playlist file, the program simply does not know what to play!
.PP
The resulting playlist file is structured as a tree that represents the path that the crawler follows.
For instance, if the links of a directory listing give the following tree:
.PP
.nf
.RS
http://example.com/
Rainbows/
Sunlight.mp3
Rainbows.mp3
Pineapples.mp3
Cool Author 72/
Good Album/
Hello world!.mp3
Bad News/
Bad News - Single/
Bad News.mp3
Irony/
Rahhhh!!.mp3
.RE
.fi
.PP
\[char46]\[char46]then the following playlist file is generated:
.PP
.nf
.RS
{items: [
{name: 'Rainbows', items: [
{name: 'Sunlight', downloaderArg: 'http://example.com/Rainbows/Sunlight.mp3'},
{name: 'Rainbows', downloaderArg: 'http://example.com/Rainbows/Rainbows.mp3'},
{name: 'Pineapples', downloaderArg: 'http://example.com/Rainbows/Pineapples.mp3'}
]},
{name: 'Cool Author 72', items: [
{name: 'Good Album', items: [
{name: 'Hello World!', downloaderArg: 'http://example.com/Cool%20Author%2072/Good%20Album/Hello%20World.mp3'},
]}
]},
{name: 'Bad News', [
{name: 'Bad News - Single', items: [
{name: 'Bad News', downloaderArg: 'http://example.com/Bad%20News/Bad%20News%20-%20Single/Bad%20News.mp3'}
]},
{name: 'Irony', items: [
{name: 'Rahhhh!!', downloaderArg: 'http://example.com/Bad%20News/Irony/Rahhhh!!.mp3'}
]}
]}
]}
.RE
.fi
.PP
As you can see, the resulting playlist file follows the same structure as the directory listing.
.SH OPTIONS
.TP
.BR -m ", " --max-download-attempts
Sets the maximum number of times any single directory will be attempted to be downloaded, when the HTTP download request fails.
Defaults to 5.
.TP
.BR -v ", " --verbose
Outputs potentially-useful debugging information regarding what files and links are (and aren't) being followed.
Note that log output goes to STDERR, so you can still pipe STDOUT to a file to save the resulting playlist.
|
