Skip to content

gfejer/databender

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

75 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

databender

a Python script that manipulates images and videos by converting them into NumPy arrays and directly editing pixel data to achieve unique glitch art effects.

Getting Started

GUI App

  1. Go to the Releases page.
  2. Download the version for your OS (Windows, Mac (Intel/ARM), or Linux).
  3. Run the executable.

Important

Note for Mac Users:
macOS might flag this application as an unrecognized or dangerous file. To open the app safely, follow these steps:

  1. Open System Settings.
  2. Go to Privacy & Security.
  3. Scroll down to the security section, locate the app (databender), and click Open Anyway.

Important

Note for Windows Users:
Because this application is packaged using PyInstaller into a single executable, some antivirus software (like Windows Defender) might falsely flag it as a virus. This is a known "false positive" issue with Python packaging tools. You can safely tell your antivirus to allow the file, or inspect the open-source code and run it via Python directly!

CLI Script

If you want to run the script manually:

  1. Clone the repository.
  2. Create a Python virtual environment:
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. Install dependencies:
pip install -r requirements.txt
  1. Run the script:
python databender_cli.py

Features and effects (for now)

  • Region of Interest (ROI) mask: Define a specific rectangular area by providing X, Y, width and height values to glitch only a targeted part of the image/video.

  • Color Manipulation: Adds a fixed integer value to all color channels (Red, Green, Blue).

  • Row Shifting: Horizontally displaces rows of pixels by a random amount.

  • Chromatic Aberration: Independent horizontal displacement of the Red, Green, and Blue color channels.

  • Pixel Sorting (lum / hue): Reorders pixels within specific intervals based on their mathematical properties.

  • Warping (normal / sin): Distorts the geometry of the image/video by shifting rows based on mathematical functions.

Example images

havas     korszallo

homok     pozsony

Example videos

1.mov
2.mov

About

a Python script that manipulates images and videos.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Languages