insert nonsensical useragent for sourceshit, so it won't try to show its idiotic...
[syren.git] / man / syren.1
blob977c038ee2e311a032f2aa429747cfb5d5db1cc5
1 .TH "Syren" "1" "0.0.6" "Ketmar Dark" "Syren Downloader"
2 .SH "NAME"
3 Syren \- The non\-interactive network downloader for GNU/Linux.
4 .SH "SYNOPSIS"
5 syren [
6 .B option
7 ] <
8 .B URL
10 .SH "DESCRIPTION"
11 .B Syren
12 is a free utility for non\-interactive download of files from the Web.
13 It supports scripting,
14 .B HTTP,
15 .B HTTPS
16 and
17 .B FTP
18 protocols,
19 as well as retrieval through
20 .B HTTP
21 proxies.
22 .SH "OPTIONS"
23 Syren has alot of short options and many long ones.
24 Long options can be specified in .syrenrc file (without long dash).
25 You may put several options that do not require arguments together,
26 like
27 .B "syren \-XNq <URL>"
28 .TP
29 .IP -h
30 Output help information and exit.
31 .IP -V
32 Output version information and exit.
33 .IP "-h all"
34 show 'long' configuration options
35 .IP "-h <longopt>"
36 show 'long' configuration option description
37 .IP "-o filename"
38 output to specified file
39 .IP "-O filename"
40 output to specified file (same as '\-o')
41 .IP "-r filename"
42 resume download (do not use saved state, use file)
43 .IP "-s filename"
44 restore state
45 .IP "-S filename"
46 redownload file using state (ignore starting position, recreate)
47 .IP "-D filename"
48 dump state file and exit
49 .IP -k
50 keep state file
51 .IP "-P <str|@fn>"
52 make POST request
53 .IP "-c <str|@fn>"
54 send cookies
55 .IP "-C filename"
56 dump cookies
57 .IP "-H <str|@fn>"
58 additional headers
59 .IP -i
60 download server reply and stop
61 .IP "-I name_or_ip"
62 use specified net interface (\"\-\" any)
63 .IP -X
64 do not use proxies
65 .IP -A
66 don't preallocate disk space
67 .IP -T
68 turn off terminal window title changing
69 .IP -Z
70 write CR after progress string
71 .IP -w
72 generate .syrenrc file with the current config
73 .IP -N
74 don't write state file
75 .IP -F
76 force retry on any download error
77 .IP -e
78 encode URL
79 .IP -E
80 decode URL
81 .IP -q
82 be quiet
83 .IP -Q
85 .B VERY
86 quiet
87 .SH "FILES"
88 .B ~/.syrenrc
89 .br
90 .B ~/.syren/.syrenrc
91 .SH "ENVIRONMENT VARIABLES"
92 .IP HOME
93 Specifies the home directory
94 .SH "EXAMPLES"
95 To run this program the standard way type:
96 .LP
97 syren http://some.site.com/abc.html
98 .SH "AUTHORS"
99 Ketmar Dark <psyc://ketmar.no-ip.org/~Ketmar>
100 .SH "SEE ALSO"
101 wget(1) curl(1)