{"id":17771913,"url":"https://github.com/makew0rld/live-glitch","last_synced_at":"2025-07-23T02:35:28.575Z","repository":{"id":116234260,"uuid":"252604728","full_name":"makew0rld/live-glitch","owner":"makew0rld","description":"Realtime glitch art effects with Python and OpenCV.","archived":false,"fork":false,"pushed_at":"2020-04-21T23:58:40.000Z","size":83765,"stargazers_count":8,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-01T17:09:30.496Z","etag":null,"topics":["glitch","glitch-art","opencv","opencv-python","python","realtime","webcam"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/makew0rld.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-04-03T01:33:04.000Z","updated_at":"2025-01-30T20:38:30.000Z","dependencies_parsed_at":null,"dependency_job_id":"5d288a5f-eaf7-448e-8e95-ae86becf89bf","html_url":"https://github.com/makew0rld/live-glitch","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makew0rld%2Flive-glitch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makew0rld%2Flive-glitch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makew0rld%2Flive-glitch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makew0rld%2Flive-glitch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/makew0rld","download_url":"https://codeload.github.com/makew0rld/live-glitch/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250150871,"owners_count":21383238,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["glitch","glitch-art","opencv","opencv-python","python","realtime","webcam"],"created_at":"2024-10-26T21:37:23.034Z","updated_at":"2025-04-21T23:32:07.798Z","avatar_url":"https://github.com/makew0rld.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# live-glitch\n\n![Example screenshot](./screenshot.jpg)\n![Second example screenshot](./screenshot2.jpg)\n\nThis project uses Python and OpenCV to apply [glitch art](https://en.wikipedia.org/wiki/Glitch_art)\nstyle effects in real time, using the webcam.\n\n## Features/Effects\n- VHS date text (`v` key)\n- Scanlines (`v` key)\n- Face dragging (`f` key)\n  - `/` key - Flip orientation\n  - Left arrow - drag to the left/up\n  - Right arrow - drag to the right/down\n  - Up and down arrows - move line that is dragged\n- Face glitch (`g` key)\n  - `/` key - Flip orientation\n  - Up and down arrows - change glitching speed\n- Tears (`t` key)\n- Censor / Blackout bar (`b` key)\n- Screenshot (`s` key)\n- Record video (`r` key to start and then stop)\n- See debug info like FPS, face points, etc (`d` key)\n\n## Commandline\n```\n❯ python3 main.py --help\nusage: main.py [-h] [-w RESIZE_WIDTH] [-d DISPLAY_WIDTH]\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -w RESIZE_WIDTH, --resize-width RESIZE_WIDTH\n                        The internal image width for processing.\n  -d DISPLAY_WIDTH, --display-width DISPLAY_WIDTH\n                        The width of the image displayed on the screen.\n```\nNo options are required, I would recommend just running it as is, and changing\nDISPLAY_WIDTH if the output is too small.\n\n# Dependencies\n1. Install OpenCV for your system. It should come with Python bindings, don't install it through pip.\n2. `pip3 install -U --user Pillow numpy dlib imutils`\n\nInstalling [dlib](http://dlib.net) will take a long time, and is resource intensive. You should leave\nyour computer and do something else while it's installing.\n\n## Features to add\n- Maybe icons/imagery\n- Random VHS-style rolling glitch, where a whole top or bottom section is shifted a bit to the left or right\n- Eye removal\n- Test on platforms other than Linux and Python 3.8\n\n## Similar projects\n- VaporWaveArt ([article](https://towardsdatascience.com/computer-vision-for-vaporwave-art-32a330c827ee), [repo](https://github.com/TimChinenov/VaporWaveArt))\nby @TimChinenov. This project helped inspire and direct a lot of what I've done here.\n  - Not live, operates on static images\n  - Adds vaporwave style icons/imagery and text on top\n\n## License\nGPL version 3. See [LICENSE](./LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmakew0rld%2Flive-glitch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmakew0rld%2Flive-glitch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmakew0rld%2Flive-glitch/lists"}