Skip to main content

Image and video pixel blending processor

Project description

IMDER

PyPI version License: MIT

Image & Video Pixel Blender - Plugin Edition

A streamlined, CLI-first Python package for pixel-sorting image and video transformations. This is the lightweight, automation-friendly version of the full IMDER tool, designed for integration into pipelines, scripts, and other applications.

What it does

IMDER rearranges pixels between a base and target media using spatial sorting algorithms, creating glitch-art style transitions and data-bending effects without neural networks or heavy dependencies.

Supported formats:

  • Images: PNG, JPG, WebP
  • Video: MP4, AVI, MOV, MKV, FLV, WMV

Installation

pip install imder

Requirements: Python 3.8+, OpenCV, NumPy, Pillow. FFmpeg optional (required for audio features).

Usage

As a Python Library

import imder

# Process two images, output PNG and GIF
imder.process(
    base="path/to/image1.jpg",
    target="path/to/image2.jpg",
    result="path/to/output/",
    results=["png", "gif"],      # Options: png, gif, mp4
    algo="shuffle",              # shuffle, merge, missform, fusion
    res=512,                     # 128, 256, 512, 1024, 2048
    sound="mute"                 # mute, gen (generated), target (from video)
)

# CLI mode
imder.launch_interactive()

Command Line

# Interactive mode
imder

# Direct processing
imder base.jpg target.jpg ./output --results gif mp4 --algo missform --res 1024

# With target audio extraction (quality 1-10)
imder base.jpg target.mp4 ./out --results mp4 --sound target --sq 5

Algorithm Selection

Algorithm Images Videos Description
shuffle Random pixel swapping by luminosity bins
merge Grayscale-sorted pixel replacement
missform Binary threshold morphing
fusion Animated pixel sorting with interpolation

Sound options:

  • mute: Silent output
  • gen: Generate synthetic audio from pixel color values
  • target: Extract audio from target video (requires FFmpeg, --sq for quality 1-10)

Limitations vs Full Version

This PyPI distribution is a minimal, headless build optimized for automation:

Feature PyPI Package Full Version
Interface CLI / Python API GUI (PyQt5) + CLI
Shape Analysis ✅ (Interactive segmentation)
Pen Tool ✅ (Manual mask drawing)
Preview ✅ (Real-time animation preview)
Algorithms 4 core modes 9+ modes (Pattern, Disguise, Navigate, etc.)
Dependencies Lightweight Full Qt stack

Use this package when you need to batch process files, integrate into web services, or call from other Python applications. Use the GitHub version for interactive artistic workflows.

GitHub Repository

For the full-featured GUI application, source code, and detailed algorithm documentation:
👉 https://github.com/HAKORADev/IMDER

License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

imder-1.0.2.tar.gz (24.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

imder-1.0.2-py3-none-any.whl (9.1 kB view details)

Uploaded Python 3

File details

Details for the file imder-1.0.2.tar.gz.

File metadata

  • Download URL: imder-1.0.2.tar.gz
  • Upload date:
  • Size: 24.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for imder-1.0.2.tar.gz
Algorithm Hash digest
SHA256 d629adea4c1a53aef7193cec4bae0c81f9c3c5fd32102b40fd52f353bc985702
MD5 f7fbec202277a14c6d08b532c246faca
BLAKE2b-256 a9f5a8e188475138955155e3d0793c9c6f315eb235da8e5b6dcaabace362d3d1

See more details on using hashes here.

File details

Details for the file imder-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: imder-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 9.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for imder-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 24427bd9683344d32adb0e25c56efd37476b29ae92e2391051482ee28d3605d2
MD5 ad7f58f419fadbe0db3009cc2b0d3555
BLAKE2b-256 9deaeaf5ae17faf9774f66c26808a614cce03b3576636a1799b68cd6cd011632

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page