filtr is a command-line tool for applying filters to pictures.
filtr is a wrapper around a lot of smaller pieces most notably ImageMagick or GraphicksMagick, neither of which are very small.
Individual filters are defined as "recipes" (which can be invoked on their own)
and all the filtr
script does is some basic housekeeping around calling them,
including things like transferring EXIF data from a source image to the newly
filtered version.
All of the examples listed here are also included in the examples folder.
$> ./filtr ./examples/soy-sauce.jpg ./examples/example-brdl.jpg brdl
In honour of James Bridle's 1 pixel camera.
$> ./filtr ./examples/soy-sauce.jpg ./examples/example-dazd.jpg dazd
$> ./filtr ./examples/soy-sauce.jpg ./examples/example-dthr.jpg dthr
$> ./filtr ./examples/soy-sauce.jpg ./examples/example-dthrpxl.jpg dthrpxl
$> ./filtr ./examples/soy-sauce.jpg ./examples/example-edwn.jpg edwn
This is principally used by the heathr
filtr.
$> ./filtr ./examples/soy-sauce.jpg ./examples/example-filtr.jpg filtr
$> ./filtr ./examples/soy-sauce.jpg ./examples/oysters.jpg heathr dthr pxl ./examples/example-heathr.png
$> ./filtr ./examples/soy-sauce.jpg ./examples/oysters.jpg heathr dthr pxl ./examples/example-heathr.jpg
If the output file is specified with a .png
extension then its background
colour will be transparent.
Named after the ever fabulous Heather Champ.
$> ./filtr ./examples/soy-sauce.jpg ./examples/example-postcrd.jpg postcrd
$> ./filtr ./examples/soy-sauce.jpg ./examples/example-postr.jpg postr
$> ./filtr ./examples/soy-sauce.jpg ./examples/example-pxl.jpg pxl
$> ./filtr ./examples/soy-sauce.jpg ./examples/example-pxldthr.jpg pxldthr
$> ./filtr ./examples/soy-sauce.jpg ./examples/example-rockstr.jpg rockstr
$> ./filtr ./examples/soy-sauce.jpg ./examples/oysters.jpg ./examples/example-stndpipe.jpg stndpipe
$> ./filtr ./examples/soy-sauce.jpg ./examples/oysters.jpg ./examples/example-stndpipe.png stndpipe
If the output file is specified with a .png
extension then its background
colour will be transparent. This is principally used by the heathr
filtr.
These are not included in the examples
folder because they're so big and it's
sort of a waste. Take a look at the example-heathr
images to get a sense of
how it works.
-
Unix – or anything with the equivalent of the standard Unix shell tools.
-
JHead – optional as there is a (slower) pure-Python equivalent should that be necessary.
-
The Atkinson Python library – optional as there is a (much slower) pure-Python equivalent should that be necessary.
Copyright (c) 2005-2013 Aaron Straup Cope. All Rights Reserved.
This is free software. You may use it and distribute it under the same terms as Perl itself.
-
Ladies and gentlemen : filtr – the original blog post announcing filtr in 2006.
-
Introducting Curvr – Richard Crowley's variation on filtr, written in C.
-
Older versions of filtr can be found at http://aaronland.info/bin/filtr/