{"id":25323748,"url":"https://github.com/afcms/ultimate-revenge","last_synced_at":"2026-04-24T16:03:59.545Z","repository":{"id":277327291,"uuid":"932072510","full_name":"AFCMS/ultimate-revenge","owner":"AFCMS","description":"Jumpscare anyone touching your computer!","archived":false,"fork":false,"pushed_at":"2025-02-13T10:18:40.000Z","size":7,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-09T00:34:09.023Z","etag":null,"topics":["argparse","ffmpeg","gnome","gsconnect","jumpscare","kdeconnect","pipewire","prank","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AFCMS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-02-13T10:15:52.000Z","updated_at":"2025-02-13T23:20:27.000Z","dependencies_parsed_at":"2025-02-13T11:37:53.965Z","dependency_job_id":null,"html_url":"https://github.com/AFCMS/ultimate-revenge","commit_stats":null,"previous_names":["afcms/ultimate-revenge"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AFCMS/ultimate-revenge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AFCMS%2Fultimate-revenge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AFCMS%2Fultimate-revenge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AFCMS%2Fultimate-revenge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AFCMS%2Fultimate-revenge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AFCMS","download_url":"https://codeload.github.com/AFCMS/ultimate-revenge/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AFCMS%2Fultimate-revenge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32230421,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T13:21:15.438Z","status":"ssl_error","status_checked_at":"2026-04-24T13:21:15.005Z","response_time":64,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["argparse","ffmpeg","gnome","gsconnect","jumpscare","kdeconnect","pipewire","prank","python3"],"created_at":"2025-02-14T00:25:15.709Z","updated_at":"2026-04-24T16:03:59.536Z","avatar_url":"https://github.com/AFCMS.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ultimate Revenge\n\nForgot to lock your computer? Then you notice your friend's wanting to ruin it? Remotly jumpscare them! And best of all,\nrecord their reaction!\n\nThis carefuly crafted Python script will max out the volume, play a video of you choice at full screen\nafter disabling desktop animations, while recording the webcam.\n\nThis software has been tested on Fedora Workstation and require the following:\n\n- [GNOME Desktop Environment](https://www.gnome.org) with Wayland session\n- [PipeWire](https://pipewire.org) as audio server\n- [FFPLAY/FFMPEG](https://www.ffmpeg.org) installed (required for playing the video and recording webcam)\n\nYou can trigger the jumpscare with any tool allowing you to run a command on the target session.\nIn my case I conveniently use GSConnect + KDE Connect from my phone:\n\n- [GSConnect](https://extensions.gnome.org/extension/1319/gsconnect)\n- [KDE Connect](https://kdeconnect.kde.org)\n\nAnother solution is to use `ssh` to remotely run the script (via Tailscale for easy access via phone).\n\nI recommend you this very effective jumpscare (beware if you are subject to epilepsy): https://youtu.be/ToRqXvEfSCQ\n\n## How to run\n\nCreate virtualenv:\n\n```bash\npython3 -m venv .venv \u0026\u0026 source .venv/bin/activate\n```\n\nRun the script (with your webcam device and video file):\n\n```bash\npython main.py /dev/video1 /path/to/video.mp4\n```\n\nYou can also run the convenience script `run.sh`:\n\n```bash\nmain.sh /dev/video1 /path/to/video.mp4\n```\n\nSee `--help` for more options.\n\nYou can setup a command in GSConnect for exemple to run the script.\n\nAlternatively you can use `ssh`:\n\n```bash\nWAYLAND_DISPLAY=wayland-0 main.sh /dev/video1 /path/to/video.mp4\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fafcms%2Fultimate-revenge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fafcms%2Fultimate-revenge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fafcms%2Fultimate-revenge/lists"}