Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/ericksonvilleta/ibaw-gsap-video-scroll/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
A lightweight WordPress plugin that leverages GSAP and ScrollTrigger to seamlessly scrub through MP4 video playback as the user scrolls down the page.
Features
- GSAP Integration: Automatically enqueues GSAP Core and ScrollTrigger from a reliable CDN.
- Shortcode Implementation: Easily embed the scroll-animated video anywhere on your site using a simple shortcode.
- Customizable Scroll Depth: Adjust the
scroll_heightparameter to control how long the user needs to scroll to finish the video, effectively acting as a playback speed controller. - Sticky Viewport Layout: Keeps the video pinned cleanly to the viewport while the scrubbing animation takes place.
Installation
- Create a folder named
ibaw-gsap-video-scrollin your WordPresswp-content/plugins/directory. - Upload the
ibaw-gsap-video-scroll.phpfile into this folder. - Log in to your WordPress Admin Dashboard.
- Navigate to Plugins > Installed Plugins.
- Locate IBAW-GSAP Video Scroll Animation and click Activate.
Screenshots
Video
Play the video to see it in action
https://github.com/user-attachments/assets/07e2e466-00ae-4edf-863e-d3a31319e8b4
Usage
Insert the shortcode on any post, page, or page builder (such as an Elementor shortcode widget).
Standard Shortcode
[ibaw_scroll_video src="[https://yourdomain.com/wp-content/uploads/your-video.mp4](https://yourdomain.com/wp-content/uploads/your-video.mp4)"]