Skip to content

uitgeteld/grainular

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Grainular

Professional image editing with film grain effects, right in your browser. No quality loss, no server uploads - everything happens client-side.

Grainular

Features

Film Grain Effects - Add colored or black & white grain to your images
🎨 Full Image Controls - Adjust brightness, saturation, and convert to B&W
💾 Lossless Export - Download images as PNG with no quality loss
🌓 Light/Dark Mode - Beautiful wheat-grain themed interface
🚀 Client-Side Processing - All editing happens in your browser
📱 Responsive Design - Works on desktop, tablet, and mobile

Usage

Web Application

  1. Visit the website
  2. Upload an image (or drag & drop)
  3. Edit using the controls:
    • Black & White toggle
    • Brightness slider (0-100)
    • Saturation slider (0-100)
    • Colored Grain (0-100)
    • B&W Grain (0-100)
  4. Download your edited image

NPM Package (for Discord Bots, etc.)

The JavaScript modules can be used in Node.js projects:

npm install @uitgeteld/grainular
const { addGrain, saturate, adjustBrightness, toBlackWhite } = require('@uitgeteld/grainular');

// Process image data
imageData = addGrain(imageData, 20, true);      // colored grain
imageData = saturate(imageData, 1.5);           // increase saturation
imageData = adjustBrightness(imageData, 1.2);   // increase brightness
imageData = toBlackWhite(imageData);            // convert to B&W

Technology Stack

  • Pure JavaScript - No frameworks, just vanilla JS
  • HTML5 Canvas API - For image processing
  • CSS3 - Modern, responsive styling
  • Local Storage - Theme preference persistence

Development

Open index.html in a browser to run the web application. No build process required!

For Discord bot integration or Node.js usage, install via npm:

npm install @uitgeteld/grainular
const grainular = require('@uitgeteld/grainular');
// Use grainular.addGrain, grainular.saturate, etc.

Browser Compatibility

Works in all modern browsers that support HTML5 Canvas:

  • Chrome/Edge 90+
  • Firefox 88+
  • Safari 14+

Contact

License

See LICENSE file for details.


Built with ❤️ for photographers and creators.

About

Grainular is a website where you can edit your pictures on

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors