https://github.com/afcms/ultimate-revenge
Jumpscare anyone touching your computer!
https://github.com/afcms/ultimate-revenge
argparse ffmpeg gnome gsconnect jumpscare kdeconnect pipewire prank python3
Last synced: about 2 months ago
JSON representation
Jumpscare anyone touching your computer!
- Host: GitHub
- URL: https://github.com/afcms/ultimate-revenge
- Owner: AFCMS
- Created: 2025-02-13T10:15:52.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-02-13T10:18:40.000Z (over 1 year ago)
- Last Synced: 2025-09-09T00:34:09.023Z (9 months ago)
- Topics: argparse, ffmpeg, gnome, gsconnect, jumpscare, kdeconnect, pipewire, prank, python3
- Language: Python
- Homepage:
- Size: 6.84 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Ultimate Revenge
Forgot to lock your computer? Then you notice your friend's wanting to ruin it? Remotly jumpscare them! And best of all,
record their reaction!
This carefuly crafted Python script will max out the volume, play a video of you choice at full screen
after disabling desktop animations, while recording the webcam.
This software has been tested on Fedora Workstation and require the following:
- [GNOME Desktop Environment](https://www.gnome.org) with Wayland session
- [PipeWire](https://pipewire.org) as audio server
- [FFPLAY/FFMPEG](https://www.ffmpeg.org) installed (required for playing the video and recording webcam)
You can trigger the jumpscare with any tool allowing you to run a command on the target session.
In my case I conveniently use GSConnect + KDE Connect from my phone:
- [GSConnect](https://extensions.gnome.org/extension/1319/gsconnect)
- [KDE Connect](https://kdeconnect.kde.org)
Another solution is to use `ssh` to remotely run the script (via Tailscale for easy access via phone).
I recommend you this very effective jumpscare (beware if you are subject to epilepsy): https://youtu.be/ToRqXvEfSCQ
## How to run
Create virtualenv:
```bash
python3 -m venv .venv && source .venv/bin/activate
```
Run the script (with your webcam device and video file):
```bash
python main.py /dev/video1 /path/to/video.mp4
```
You can also run the convenience script `run.sh`:
```bash
main.sh /dev/video1 /path/to/video.mp4
```
See `--help` for more options.
You can setup a command in GSConnect for exemple to run the script.
Alternatively you can use `ssh`:
```bash
WAYLAND_DISPLAY=wayland-0 main.sh /dev/video1 /path/to/video.mp4
```