Frequently Asked Questions
Yes. Your data never leaves your computer. All image processing happens directly in your browser. Your images are never uploaded to a server, thus ensuring your privacy.
It turns image editing from a manual and laborious task into a creative discovery. The random evolution process coupled with multi-stage image filtering can show you filtered images that you may not even have imagined if you tried filtering images manually. You don't even have to understand what those filtering terms mean and don't have to bother tweaking values. You can simply choose what looks good to you. The algorithm intelligently hones in on the perfect settings based on your choices.
Particle Swarm Optimization is an evolutionary algorithm inspired by the social behavior of bird flocks or fish schools. Each "particle" of the "population" is an image (one of the images you see in the grid of images) variation that "flies" through the multi-dimensional space of all possible filter combinations. The images you select guides the filter values and parameters to the best-looking results.
-
Inertia (Momentum): Controls how much a particle continues in its current direction.
- High (e.g., > 1.0): Promotes exploration. Particles will boldly fly into new, unexplored areas of filter combinations. Good for the first few rounds.
- Low (e.g., < 0.6): Promotes exploitation. Particles will slow down and refine their search around the current best results. Good for fine-tuning.
- Optimal Range: Typically 0.6 to 0.9.
- Cognition (Personal Best): Controls how much a particle is attracted to its *own* best-found parameters so far. This represents the particle's memory or "personal experience." A higher value makes it more stubborn and reliant on its own past success.
- Social (Global Best): Controls how much a particle is attracted to the *swarm's* best-found parameters. This represents the influence of the community of image parameters. A higher value makes the swarm converge more quickly on a promising result found by any single particle.
The key is to balance these forces. A good starting point is high cognition and social values (e.g., 1.5 - 2.0). If you feel the results are too similar, try increasing inertia to explore more diverse options.
The image filter tool works best with static images like PNG, JPEG, and WebP. The resizing and cropping tools have broader support, but note that animated GIFs will be processed as static images (first frame only) to keep the app fast and lightweight. The image format support can be improved if this app is built with server-side functionality or as a desktop app or a mobile app.
No need to install anything else. Imager is a completely self-contained web application. There are no browser plugins or external software to install. It just works in any modern web browser like Chrome, Firefox, or Edge. It uses OpenCV for image processing and that's a 10MB download, so that's the only thing that can take a while to download, but it's already included with this project, so there's no need to connect to the internet if you've downloaded this project locally. You can download it as a zip file by clicking the green "Code" button here.