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.1.tar.gz (8.0 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.1-py3-none-any.whl (9.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: imder-1.0.1.tar.gz
  • Upload date:
  • Size: 8.0 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.1.tar.gz
Algorithm Hash digest
SHA256 8ec8f41b774dcae3c377f7bdced88d98e4fb8175d48d8856ee26d0fe2dfb7270
MD5 ec81b0d08ce4b541d9e09088424dba5b
BLAKE2b-256 702ebdb49e8b24d8e9439c375950a27faca91a69e7a5700f704be2506d27edfa

See more details on using hashes here.

File details

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

File metadata

  • Download URL: imder-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 9.4 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 90448163f0a523d13302a09b34f10d4827caf33be95e058fe4123edb809d822f
MD5 24bcdd433cc7e9c3a02d517225f2f685
BLAKE2b-256 b71cad80c19ac10a02e7d0ab2f6af373ed98dd0c57401bd6c8a43c7d160d115d

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