Repository navigation
Overview
The first stable release of the Dither Video App, a tool for applying dithering effects to videos. Designed for fun and a personal tool to run locally, this application allows users to experiment with various dithering algorithms, palettes, and configurations while providing an interface.
- Features
Dithering Algorithms
Ordered Dithering
Floyd-Steinberg
Jarvis-Judice-Ninke
Sierra
Stucki
Pattern-based dithering
Customizable Palettes
Add up to 8 colors for dithering.
Save and load palettes for future projects.
Real-time Preview
Adjustable live preview toggle to view dithering effects instantly as settings are updated.
Lock zoom option to keep the preview area consistent during changes.
Adjustments
Brightness, Contrast, and Saturation sliders with fine-tune numerical displays.
Resolution scaling for output video.
Output
High-quality .mp4 video with optional reduction in noise or messiness.
Configurable dithering strength and resolution for optimized results.
Zoom and Pan Features
Interactive zoom and pan for precise previewing of video frames.
User-Friendly Interface
Compact yet segmented GUI design for efficient workflow.
Clear and accessible layout for all controls.
Performance
Built-in FFmpeg integration for video processing.
Optimized for multi-threaded processing for faster results.
Requirements for building from source
Python 3.10+
FFmpeg (included in the release)
Dependencies specified in requirements.txt.
- Installation
Windows Executable
Download the precompiled .exe file from the release assets.
No additional setup should be required.
Source Code
Clone the repository and follow the instructions in the README to set up the environment.
Changelog
Initial implementation of dithering algorithms.
Added interactive GUI with real-time preview functionality.
Enhanced customization options for dithering and color palettes.
Integrated FFmpeg for seamless video processing.
Added lock zoom and resolution scaling options.
Known Issues
Windows flagged the ffmpeg EXE as a virus and I'm not expert enough to know why. Unsure if Windows will do this for the compiled EXE. I can confirm I used the gyan version 7.1 release.
Some dithering processes may take longer for high-resolution videos.
Performance may vary on older systems without hardware acceleration.
Future Plans
Add GPU acceleration (optional toggle).
Support for additional dithering algorithms and presets.
Further optimization for processing speed.
Exported as MP4 at the lowest resolution, pattern dithering, then converted to a GIF.
