YouTube Viewfinding

Zoom, rotate & crop YouTube videos

Install this script ?

Ask a question, post a review, or report the script.

Author

ctl2

Daily installs

Total installs

Ratings

1 0 0

Version

0.9

Created

2025-01-10

Updated

2025-02-26

Size

89.9 KB

Compatibility

License

GNU GPLv3

Applies to

youtube.com

Controls

Config options are under Controls and Behaviour.

Default keybinds

Action	Keybind
Pan & zoom	`z`
Rotate	`\`
Crop	`z + \`
Reset / undo reset	`x`
Open config menu	`left-alt + x`

Viewfinding

Viewfind with mouse inputs while holding down keybinds.

Action	Scroll	Left Click	Left Drag	Right Click
Pan / Zoom	Zoom	Quick pan	Pan	Reset pan & zoom
Rotate	Rotate	Snap to closest multiple of 90°	Rotate	Reset rotation
Crop	Crop every side	Clicking a panel will quick crop. Clicking elsewhere will pan and zoom to the cropped video.	Dragging a panel will crop. Dragging elsewhere will move the uncropped window.	Right clicking a panel will reset its crop. Right clicking elsewhere will reset all crop.

Touchpad

Some touchpads restrict pointer movement when keys are held. To avoid this, change your viewfinding keybinds to keys that don't produce text like ctrl and shift or switch from key holding to key toggling through the config menu.

Interfaces

Config options are under Interfaces.

Crosshair

Pan/zoom and rotate use a crosshair interface. The pan/zoom interface displays zoom level followed by coordinates. The rotation interface shows the video's current angle alongside the angle that will be snapped to on click.

For drag rotations, treat the video as a wheel that rotates around the crosshair's center.

Crop

In the crop interface, crop is represented by grey panels that extend from the edges of the video. These panels may be dragged to alter crop. Panels for uncropped sides are dragged via transparent handles at the video's edges.

Notes

The script only has an effect on video pages (URL is youtube.com/watch?v=...).
Videos are given a glow, similar to YouTube's "ambient mode" but confined within the video player. This can be turned off by unchecking Glow in the config menu.
On and off, I've spent a few years of my life working on this script, including months of unemployment getting it finished. If you want to show your appreciation and have the means, please donate to the Palestine Children's Relief Fund & tell me via feedback/DM.