<h1 align="center">glitch-this!</h1>
<p align="center"><i>Create glitched images and GIFs, with highly customizable options!</i></p>
<hr><p align="center">
<a href="https://pypi.org/project/glitch-this"><img alt="Pypi release" src="https://img.shields.io/pypi/v/glitch-this?color=red&label=pypi%20release&logo=pypi&logoColor=blue" /></a>
<img alt="Stars" src="https://img.shields.io/github/stars/TotallyNotChase/glitch-this.svg?label=Stars&style=flat" />
<a href="https://pepy.tech/project/glitch-this"><img alt="Pypi downloads" src="https://pepy.tech/badge/glitch-this" /></a>
<a href="http://www.python.org/download/"><img alt="Python 3" src="https://img.shields.io/badge/Python-3-yellow.svg"></a>
<a href="https://github.com/TotallyNotChase/glitch-this/blob/master/LICENSE"><img src="https://img.shields.io/github/license/TotallyNotChase/glitch-this.svg" alt="License"/></a>
</p>
A commandline tool + `python` library to glitchify images and **even make GIFs** out of them!
Featuring *100 gradually different levels of glitching intensity*! The algorithm used to create glitched images is a slightly modifed version of the popular [ImageGlitcher](https://www.airtightinteractive.com/demos/js/imageglitcher/) tool's algorithm, so you can expect the glitched images to look really cool!
**NOW WITH GIF TO GLITCHED GIF SUPPORT! Check out the [docs](https://github.com/TotallyNotChase/glitch-this/wiki/Home)!**
If you like using this tool, please consider **starring on Github**!
What are you waiting for? Import the library and get glitching!
**NOTE** : Works best with RGB/RGBA images
Checkout a web demo right [here](https://github.com/pahefu/web-glitch-this), courtesy of @[pahefu](https://github.com/pahefu)
## What others have to say ~
* [#1 hot in r/python](https://www.reddit.com/r/Python/comments/f7taiy/my_python_imagegif_glitching_library_is_now_on/)
* [#1 hot in r/programming](https://www.reddit.com/r/programming/comments/f7q2q3/i_made_a_commandline_script_to_make_glitched/)
* [#1 hot in r/broken_gifs](https://www.reddit.com/r/brokengifs/comments/f7pyqw/i_made_a_commandline_script_to_make_glitched_gifs/)
* [#1 hot in r/glitch_art](https://www.reddit.com/r/glitch_art/comments/f7q0hc/i_made_a_script_to_make_glitched_images_and_gifs/)
* [#4 product of the day in producthunt](https://www.producthunt.com/posts/glitch-this)
<a href="https://www.producthunt.com/posts/glitch-this?utm_source=badge-featured&utm_medium=badge&utm_souce=badge-glitch-this" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=186201&theme=light" alt="glitch-this - Create highly customizable glitched images and GIFs! | Product Hunt Embed" style="width: 250px; height: 54px;" width="250" height="54" /></a>
## FEATURES!
* Choose any **glitching intensity** between 0.1 and 10.0, yes those are floats!
*Each level is gradually different*!
Want just a tiny bit of glitching, enough to make your image look cool? - use level 2 (my favorite)!
* Add **scan lines** for a retro CRT effect! Add **color offset** for even cooler glitching!
* Create **Glitched GIFs** from a normal image!
That's right, before this tool, I had to manually download each image from [ImageGlitcher](https://www.airtightinteractive.com/demos/js/imageglitcher/), save them, and then head to a GIF creation website.
Now you can do it *all* at once!
* Glitch normal **GIFs** into **glitched GIFs**!
* Customize **step** of glitching, you can glitch *every step'th frame* instead of all frames!
* **Increment/Decrement glitching intensity** while glitching every frame!
So you can have a frame *glitched with intensity 2*, but the *next can be 5*, the *next to that can be 8* and so on!
* Customize the **number of frames** in a GIF as well as their **duration** - all from the comfort of your terminal!
* Set how many times the GIF should **loop**!
* Set your own custom **seed** for a predictable RNG!
## Changelog
View the changelog [here](https://github.com/TotallyNotChase/glitch-this/blob/master/CHANGELOG.md)
## Requirements
* `python 3`
* `pillow`
* `numpy`
These will be automatically installed when you install the library! (assuming you have `python3`)
## Installation
Simply install `glitch-this` from [pypi](https://pypi.org/project/glitch-this/)!
```
pip install glitch-this
```
(OR)
```
pip3 install glitch-this
```
## Quick Start
Now that you have the library installed, all you need to do is invoke the script and pass in the params
`glitch_this [IMAGE PATH] [GLITCH_LEVEL]`
Try `glitch_this -h` for more info! Directly from your commandline!
Or, Check out the [script docs](https://github.com/TotallyNotChase/glitch-this/wiki/Documentation:-The-commandline-script)!
Interested in the library? Check out the [library docs](https://github.com/TotallyNotChase/glitch-this/wiki/Documentation:-The-glitch-this-library)!
## DOCS! WHERE TO?!
Read the [script docs](https://github.com/TotallyNotChase/glitch-this/wiki/Documentation:-The-commandline-script)!
Read the [library docs](https://github.com/TotallyNotChase/glitch-this/wiki/Documentation:-The-glitch-this-library)!
Check out a [full example](https://github.com/TotallyNotChase/glitch-this/blob/master/test_script.py) using the library!
## Whoa! Cool Glitches
Here's some glitched images generated from this script - of different intensity levels!
**NOTE**: All these images had `-c` parameter included, for color offset
#### Original image for reference:-
#### Glitched version - Level 2:-
*Not badly glitched now is it?*
#### Glitched version - Level 5:-
*Well it's certainly starting to get glitchy*
#### Glitched version - Level 8:-
*I don't know what I'm looking at*
Let's get some **scan lines** on there!
#### Glitched version (scan_lines)- Level 2:-
#### Glitched version (scan_lines) - Level 5:-
#### Glitched version (scan_lines) - Level 8:-
That's neat, but how about some GIFs? Here's some GIFs from the same image:-
*Note: All the GIFs use default values from `FRAMES` and `DURATION`, i.e 23 and 200 respectively*
#### Glitched GIF - Level 2:-
#### Glitched GIF - Level 5:-
#### Glitched GIF - Level 8:-
Raw data
{
"_id": null,
"home_page": "https://github.com/TotallyNotChase/Glitch-and-Gif",
"name": "glitch-this",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "",
"author": "TotallyNotChase",
"author_email": "totallynotchase42@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d5/53/893ebbf7b3b0301895ec755174f854e495adc9ee93f2d1c7c0493e7b7161/glitch_this-1.0.3.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">glitch-this!</h1>\n<p align=\"center\"><i>Create glitched images and GIFs, with highly customizable options!</i></p>\n<hr><p align=\"center\">\n <a href=\"https://pypi.org/project/glitch-this\"><img alt=\"Pypi release\" src=\"https://img.shields.io/pypi/v/glitch-this?color=red&label=pypi%20release&logo=pypi&logoColor=blue\" /></a>\n <img alt=\"Stars\" src=\"https://img.shields.io/github/stars/TotallyNotChase/glitch-this.svg?label=Stars&style=flat\" />\n <a href=\"https://pepy.tech/project/glitch-this\"><img alt=\"Pypi downloads\" src=\"https://pepy.tech/badge/glitch-this\" /></a>\n <a href=\"http://www.python.org/download/\"><img alt=\"Python 3\" src=\"https://img.shields.io/badge/Python-3-yellow.svg\"></a>\n <a href=\"https://github.com/TotallyNotChase/glitch-this/blob/master/LICENSE\"><img src=\"https://img.shields.io/github/license/TotallyNotChase/glitch-this.svg\" alt=\"License\"/></a>\n</p>\n\nA commandline tool + `python` library to glitchify images and **even make GIFs** out of them!\nFeaturing *100 gradually different levels of glitching intensity*! The algorithm used to create glitched images is a slightly modifed version of the popular [ImageGlitcher](https://www.airtightinteractive.com/demos/js/imageglitcher/) tool's algorithm, so you can expect the glitched images to look really cool!\n\n**NOW WITH GIF TO GLITCHED GIF SUPPORT! Check out the [docs](https://github.com/TotallyNotChase/glitch-this/wiki/Home)!**\n\nIf you like using this tool, please consider **starring on Github**!\n\n\n\nWhat are you waiting for? Import the library and get glitching!\n\n**NOTE** : Works best with RGB/RGBA images\n\nCheckout a web demo right [here](https://github.com/pahefu/web-glitch-this), courtesy of @[pahefu](https://github.com/pahefu)\n\n## What others have to say ~\n* [#1 hot in r/python](https://www.reddit.com/r/Python/comments/f7taiy/my_python_imagegif_glitching_library_is_now_on/)\n* [#1 hot in r/programming](https://www.reddit.com/r/programming/comments/f7q2q3/i_made_a_commandline_script_to_make_glitched/)\n* [#1 hot in r/broken_gifs](https://www.reddit.com/r/brokengifs/comments/f7pyqw/i_made_a_commandline_script_to_make_glitched_gifs/)\n* [#1 hot in r/glitch_art](https://www.reddit.com/r/glitch_art/comments/f7q0hc/i_made_a_script_to_make_glitched_images_and_gifs/)\n* [#4 product of the day in producthunt](https://www.producthunt.com/posts/glitch-this)\n\n<a href=\"https://www.producthunt.com/posts/glitch-this?utm_source=badge-featured&utm_medium=badge&utm_souce=badge-glitch-this\" target=\"_blank\"><img src=\"https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=186201&theme=light\" alt=\"glitch-this - Create highly customizable glitched images and GIFs! | Product Hunt Embed\" style=\"width: 250px; height: 54px;\" width=\"250\" height=\"54\" /></a>\n\n## FEATURES!\n* Choose any **glitching intensity** between 0.1 and 10.0, yes those are floats!\n\n *Each level is gradually different*!\n\n Want just a tiny bit of glitching, enough to make your image look cool? - use level 2 (my favorite)!\n* Add **scan lines** for a retro CRT effect! Add **color offset** for even cooler glitching!\n* Create **Glitched GIFs** from a normal image!\n\n That's right, before this tool, I had to manually download each image from [ImageGlitcher](https://www.airtightinteractive.com/demos/js/imageglitcher/), save them, and then head to a GIF creation website.\n\n Now you can do it *all* at once!\n* Glitch normal **GIFs** into **glitched GIFs**!\n* Customize **step** of glitching, you can glitch *every step'th frame* instead of all frames!\n* **Increment/Decrement glitching intensity** while glitching every frame!\n\n So you can have a frame *glitched with intensity 2*, but the *next can be 5*, the *next to that can be 8* and so on!\n\n* Customize the **number of frames** in a GIF as well as their **duration** - all from the comfort of your terminal!\n* Set how many times the GIF should **loop**!\n* Set your own custom **seed** for a predictable RNG!\n\n## Changelog\nView the changelog [here](https://github.com/TotallyNotChase/glitch-this/blob/master/CHANGELOG.md)\n\n## Requirements\n* `python 3`\n* `pillow`\n* `numpy`\n\nThese will be automatically installed when you install the library! (assuming you have `python3`)\n## Installation\n\nSimply install `glitch-this` from [pypi](https://pypi.org/project/glitch-this/)!\n\n```\npip install glitch-this\n```\n\n(OR)\n\n```\npip3 install glitch-this\n```\n\n## Quick Start\n\nNow that you have the library installed, all you need to do is invoke the script and pass in the params\n\n`glitch_this [IMAGE PATH] [GLITCH_LEVEL]`\n\n\n\nTry `glitch_this -h` for more info! Directly from your commandline!\n\nOr, Check out the [script docs](https://github.com/TotallyNotChase/glitch-this/wiki/Documentation:-The-commandline-script)!\n\nInterested in the library? Check out the [library docs](https://github.com/TotallyNotChase/glitch-this/wiki/Documentation:-The-glitch-this-library)!\n\n## DOCS! WHERE TO?!\n\nRead the [script docs](https://github.com/TotallyNotChase/glitch-this/wiki/Documentation:-The-commandline-script)!\n\nRead the [library docs](https://github.com/TotallyNotChase/glitch-this/wiki/Documentation:-The-glitch-this-library)!\n\nCheck out a [full example](https://github.com/TotallyNotChase/glitch-this/blob/master/test_script.py) using the library!\n\n## Whoa! Cool Glitches\nHere's some glitched images generated from this script - of different intensity levels!\n\n**NOTE**: All these images had `-c` parameter included, for color offset\n\n#### Original image for reference:-\n\n\n\n#### Glitched version - Level 2:-\n\n\n\n*Not badly glitched now is it?*\n\n#### Glitched version - Level 5:-\n\n\n\n*Well it's certainly starting to get glitchy*\n\n#### Glitched version - Level 8:-\n\n\n\n*I don't know what I'm looking at*\n\nLet's get some **scan lines** on there!\n\n#### Glitched version (scan_lines)- Level 2:-\n\n\n\n#### Glitched version (scan_lines) - Level 5:-\n\n\n\n#### Glitched version (scan_lines) - Level 8:-\n\n\n\nThat's neat, but how about some GIFs? Here's some GIFs from the same image:-\n\n*Note: All the GIFs use default values from `FRAMES` and `DURATION`, i.e 23 and 200 respectively*\n\n#### Glitched GIF - Level 2:-\n\n\n\n#### Glitched GIF - Level 5:-\n\n\n\n#### Glitched GIF - Level 8:-\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "A package to glitch images and GIFs, with highly customizable options!",
"version": "1.0.3",
"project_urls": {
"Homepage": "https://github.com/TotallyNotChase/Glitch-and-Gif"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "92b5319faeb1f307fccb08846b0caf5fe6aafc68c0dca590aa934f1416116f41",
"md5": "935a2fe4a5832a72ec7f2d0758e3300b",
"sha256": "6db1149f6ece1603e18dfea598847c4402c19813bad10d066dcf4ebf1f886cce"
},
"downloads": -1,
"filename": "glitch_this-1.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "935a2fe4a5832a72ec7f2d0758e3300b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 14091,
"upload_time": "2024-03-11T20:58:17",
"upload_time_iso_8601": "2024-03-11T20:58:17.184780Z",
"url": "https://files.pythonhosted.org/packages/92/b5/319faeb1f307fccb08846b0caf5fe6aafc68c0dca590aa934f1416116f41/glitch_this-1.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d553893ebbf7b3b0301895ec755174f854e495adc9ee93f2d1c7c0493e7b7161",
"md5": "d1eb70186cab14bb48f6581c1c87385e",
"sha256": "8e35fd14550783845dc71e32b2cf979fbf11254930a9f8e791c548d7d2160bfe"
},
"downloads": -1,
"filename": "glitch_this-1.0.3.tar.gz",
"has_sig": false,
"md5_digest": "d1eb70186cab14bb48f6581c1c87385e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 15625,
"upload_time": "2024-03-11T20:58:18",
"upload_time_iso_8601": "2024-03-11T20:58:18.867525Z",
"url": "https://files.pythonhosted.org/packages/d5/53/893ebbf7b3b0301895ec755174f854e495adc9ee93f2d1c7c0493e7b7161/glitch_this-1.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-11 20:58:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "TotallyNotChase",
"github_project": "Glitch-and-Gif",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "glitch-this"
}
JSON
