Instagram-like photo manipulation library in JavaScript
JavaScript CSS HTML
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

The completely new vewsion, Filterous-2 for both JavaScript for browser and Node.js is available at!

This repo is no longer maintained.



Image manipulation library in JavaScript that applies filters to photos à la Instagram on browser. This script take pixel data from a photo that you want to give filter effects, and maniplute its pixels using the canvas element. The finished photo can be displayed as canvas, or as downloadable image formats such as jpeg, png, or webp for Chrome.

This works on modern mobile browsers as well.

Created by Tomomi Imura

Simple Demo

Filterous Demo

Real-life Example App

W3C CoreMob camera - Mobile Web App


Just include filterous.js in your HTML file.

<script src="filterous.js"></script>

Filterous does not require any other depencies.

Basic Usage

Create a new instance.

var f = new Filterous(imageObject);

Leaving the second param results a finished photo as a canvas, otherwise in a specified images format.

var f = new Filterous(imageObject, 'jpeg');

Apply a filter (or multiple filters) then render.

f.filterImage('brightness', 50);

Examples of using other filters

f.filterImage('rgbAdjust', [1.4, 1.2, 1]);
f.filterImage('convolute', [ 0, 0, 0,
                             0, 1, 0,
                             0, 0, 0 ]

or add an image layer:

var starryLayer = new Image();
starryLayer.src = 'effects/stars.png';

var f = new PhotoFilter(Filterous, 'jpeg');



Using Presets (instead of defining filters manually)

  • Import filterousEffects.js.
  • Include the effects folder (contains the overlay image).
<script src="filterousEffects.js"></script>
ApplyEffects.nostalgia(imageObject, 'jpeg');

Take a look at the filterousEffects.js to see all available presets.


MIT License

Thank you

Thank you for the tutorial on the pixel manpulating tutorials :-)