« get me outta code hell

http-music-crawl-http.1 « man - http-music - Command-line music player + utils (not a server!)
about summary refs log tree commit diff
path: root/man/http-music-crawl-http.1
blob: 949d682c0245701fc5e2260a5cb9568d95f7807c (plain)
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
.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
\fIdownloadURL\fR
[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
[
  ['Rainbows', [
    ['Sunlight', 'http://example.com/Rainbows/Sunlight.mp3'],
    ['Rainbows', 'http://example.com/Rainbows/Rainbows.mp3'],
    ['Pineapples', 'http://example.com/Rainbows/Pineapples.mp3']
  ]],
  ['Cool Author 72', [
    ['Good Album', [
      ['Hello World!', 'http://example.com/Cool%20Author%2072/Good%20Album/Hello%20World.mp3'],
    ]]
  ]],
  ['Bad News', [
    ['Bad News - Single', [
      ['Bad News', 'http://example.com/Bad%20News/Bad%20News%20-%20Single/Bad%20News.mp3']
    ]],
    ['Irony', [
      ['Rahhhh!!', '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.