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

What it needs

See it running

On All Power Marine, an 8-post lift lowers a yacht to the waterline as you scroll.

Install

  1. Step 1

    Upload kiss-locomotion.zip via Plugins → Add New → Upload Plugin and activate.

  2. Step 2

    Activation lands you on the plugin Dashboard. Go to KISS LocoMotion → Sequences and import a ZIP of frames.

  3. 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.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.
  2. 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.
  3. 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.
  4. 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.
  5. 1.0.18

    • New: Screen height on phones and tablets (Stage size & scroll, per device).
  6. 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