1SURL(1)                         text processing                        SURL(1)
2
3
4

NAME

6       surl - a URL shortening application, supports various sites
7

SYNOPSIS

9       surl [OPTION]
10
11       Modes: stdin or -f (default: stdin)
12

DESCRIPTION

14       surl is a command line application that can transform links and shorten
15       them.
16
17       The idea is to input a huge amount of text and/or links.
18
19       The input can be in two modes:
20
21          · stdin (standard input or piped command, default)
22
23          · read input from a text file (using the -f option)
24

OPTIONS

26       -h, --help
27              This help message
28
29       -v, --version
30              Prints version info
31
32       -c,--url <url>
33              URL to shorten
34
35       -a,--api-key <key>
36              Use an API key
37
38       -f,--file <filename>
39              Read input from filename
40
41       -i, --in-place
42              Save changes to file directly (Requires: -f)
43
44       -l, --links-only
45              Output only a list of links (old_url => shortened_url)
46
47       -o,--output <filename>
48              Output to file
49
50       -p,--password <password>
51              Your password
52
53       -q, --quiet
54              Suppress any extra messages
55
56       -t,--title <title>
57              Title (short custom name/alias) for the url
58
59       -u,--username <username>
60              Your username
61
62       -s,--service <service>
63              The URL shortening service to use (Default: tinyurl.com)
64
65       -r,--script <path>
66              The surlscript to execute
67

SUPPORTED SERVICES

69       surl supports a vast range of url shortening services.
70
71       You can view the full list by typing: surl --help
72

EXAMPLES

74       · echo 'http://google.co.uk' | surl -a myapikey123 -u example -s bit.ly
75
76       · echo 'http://www.google.com' | surl -s tr.im
77
78       · surl -c http://www.google.com -s tr.im
79
80       · surl -f example.txt -i -s tr.im
81

BUGS

83       Should  you  find  any  bugs,  report  them  at:   https://bugs.launch‐
84       pad.net/surl
85

AUTHOR

87       Savvas   Radevic   <vicedar@gmail.com>,   Ahmed   El-Mahdawy   <aa.mah‐
88       dawy.10@gmail.com>
89

91       Copyright © 2009-2011 Savvas Radevic <vicedar@gmail.com>,  Copyright  ©
92       2009-2010 Ahmed El-Mahdawy <aa.mahdawy.10@gmail.com>
93
94
95
96
970.7                               2011-01-06                           SURL(1)
Impressum