---
name: "shorlfilter"
section: "1"
platform: "linux"
package: "shorlfilter"
version: "0.5.2-2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/shorlfilter"
---

# shorlfilter(1)

text filter that turns long URLs into shorls (short URLs)

## NAME

shorlfilter - text filter that turns long URLs into shorls (short URLs)

## SYNOPSIS

shorlfilter \[options\] \[file ...\]

```
 Options:
   --help                brief help message
   --man                 full man page
   -v, --version         print version information and exit
   -l N, --length=N      minimum length of URL in characters to shorlify, default 45
   -r N, --retry=N       number of times to retry shorl query before failing
```

## DESCRIPTION

Shorlfilter takes piped input or a filename from the command line and returns the same file with any long URLs turned into shorls.

See http://shorl.com for more information on shorls.

If shorlfilter is unable to get a replacement short URL from shorl.com, the long URL will be left unchanged in the output of the filter.

## EXAMPLES

Convert all URLs longer than 60 characters to shorls in file\_with\_long\_urls, save results in file\_with\_short\_urls:

cat file\_with\_long\_urls ⎪ shorlfilter -n 60 \> file\_with\_short\_urls

Add the following to your .muttrc to have all outgoing messages in the mutt mail user agent be shorlified:

macro compose y \<filter-entry\>'shorlfilter'\\ry\<send-message\>'

Add the following to your .vimrc to have map F5 to filter the currently open document through shorlfilter:

noremap \<F5\> :%!shorlfilter\<CR\>

## BUGS

Does not recognize URLs unless they start with http:// or https://. Ideally there would be better heuristics for recognizing long URLs in text even if they don't have the proper protocol string.

## COPYRIGHT

Copyright (c) 2003, 2004 Adam Rosi-Kessel. This is free software; see the source for copying conditions.  There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, to the extent permitted by law.

## AUTHOR

Adam Rosi-Kessel, ajkessel@debian.org