KISS LocoMotion
Scroll becomes the playhead.
Give KISS LocoMotion a sequence of frames or a video and say how much scrolling it should take. As the visitor scrolls, the picture moves, and captions or numbered steps arrive with it.
- Version
- 1.1.0
- WordPress
- 6.0+
- Tested up to
- WordPress 7.1.4
- PHP
- 7.4+
- Releases
- 59
- License
- GPL 2.0 or later
What it solves
Explaining how a product works usually means a long video nobody finishes, or a row of still pictures. A scroll-driven sequence lets the visitor set the pace and stop on the step they care about.
LocoMotion keeps it to three ideas: a tall track whose height is the duration, a stage pinned inside it, and progress from 0 to 1. Everything else, from the frame shown to the caption on screen, follows progress.
What it does
Three sources
A frame sequence from one ZIP upload, frames picked from the media library, or an MP4.
Human controls
Stage height, scroll distance, start and end, a hold at the end, easing, fit and focal point. A longer track is a slower scrub.
Slides on the timeline
Text timed to the scroll: numbered steps beside the visual, or captions over it in nine positions.
Progress in CSS
Publishes --loco-progress and --loco-frame, so captions, parallax and progress rails can be written in plain CSS.
SVG tools
Optimize, recolor and reframe illustrator SVGs in the browser, then save them as a sequence.
Kind on phones
Scrub, play once or show the first frame only, with defaults that never make a phone download 120 frames by accident.
Reduced motion respected
Visitors who ask for less motion get a still first frame, no pinning and no scroll track.
Never the LCP
The first frame is a real image; nothing else loads until the stage nears the screen. GSAP is self-hosted, and a built-in engine can run without it.
What it needs
- WordPress 6.0 or later
- PHP 7.4 or later
- Elementor for the widget
- The [kiss_locomotion] shortcode works without it
See it running
On All Power Marine, an 8-post lift lowers a yacht to the waterline as you scroll.
Install
- 01
Step 1
Upload kiss-locomotion.zip via Plugins → Add New → Upload Plugin and activate.
- 02
Step 2
Activation lands you on the plugin Dashboard. Go to KISS LocoMotion → Sequences and import a ZIP of frames.
- 03
Step 3
In Elementor, drop the KISS LocoMotion widget into a full-width container, pick the sequence, set the stage height and scroll distance, publish.
New versions install the same way: upload the new ZIP over the old one. Settings are kept.
Changelog
59 releases so far. The newest:
1.1.0
- Added Updates itself. New versions now arrive in Dashboard › Updates like any plugin from wordpress.org, with one-click and automatic updates, served from imaginarytrout.com. Nothing to set up.
- Added A red "Update to v…" badge beside the version on the plugin's own screens whenever a newer version is waiting. It links to Dashboard › Updates.
- Added The plugin's icon in the admin menu and beside each screen title, and its icon and banner on the update screen.
- Added Marked compatible with WordPress 7.1.4 ("Tested up to"), so the update screen no longer says "Not tested".
- Security The update check is a read-only HTTPS request to imaginarytrout.com, made from wp-admin and WordPress's scheduled update check, never from a visitor's page.
1.0.21
- Fixed the Ripple could show a drawing that was still loading, half rippled, before switching itself off. It now starts only once every drawing has fully loaded.
- Changed Ripple is off in Safari (and on iPads and iPhones, where every browser uses Safari's engine). Safari draws this effect too slowly to keep. Chrome, Edge and Firefox on computers keep it.
1.0.20
- Fixed under a section that another plugin pins while you scroll (KISS 3D, for example), the dots sent you back up into that section. LocoMotion now measures its sections after every other scroll effect on the page.
1.0.19
- Fixed a section placed under something that changes height after the page loads (a 3D viewer, for example, especially after turning a tablet) stopped following the scroll: the slides did not change and the dots jumped past it into the next section.
1.0.18
- New: Screen height on phones and tablets (Stage size & scroll, per device).
1.0.17
- Fixed the shortcode in a Custom HTML block, a Shortcode block or the classic editor printed a small first-screen script that WordPress's content filters broke ("SyntaxError: Invalid or unexpected token" in the console), so the section could shift on the first scroll.
KISS LocoMotion questions
It has not been re-encoded all-intra. Browsers seek efficiently only to keyframes. The exact ffmpeg command is under KISS LocoMotion → Help.
A parent container is clipping overflow, which defeats position: sticky. Remove the clip, or switch Advanced → LocoMotion → Pinning to script-driven.
They can, and the editor will warn you. One per page is the guidance.
Other KISS plugins
Want KISS LocoMotion on your site?
It is not on WordPress.org yet. It runs on the sites we build and manage. Tell us about yours, or about a plugin you need built.
Start a project