๐ŸŽฌ For RNS Videomedia

Find every jump.
Automatically.

Drop in your raw footage. Rider Finder watches the whole video, finds every horse on screen, and saves each jump as its own ready-to-edit clip.

Get Started
Overview

How it works

Three steps from raw footage to ready-to-edit clips โ€” no manual scrubbing required.

1

Watches your video

AI scans through your footage frame by frame, looking for horses on screen.

2

Finds the jumps

Each time a horse appears, Rider Finder marks the start and end of that moment.

3

Saves the clips

Every jump is saved as its own video file โ€” ready to drag straight into your editing software.

One-Time Setup

Getting set up

You only need to do this once. It takes about 5โ€“10 minutes.

1 Open Terminal

Terminal is a text window built into every Mac. It lets you run programs by typing short commands. Don't worry โ€” you'll only ever be pasting in the commands shown on this page.

To open it: press โŒ˜ Command + Space at the same time, type Terminal, then press Enter.

๐Ÿ’ก What you'll see: A dark window with some text ending in a % symbol. That symbol means Terminal is ready and waiting for your next command.
2 Install Homebrew

Homebrew is a free tool that helps install software on a Mac. Click Copy on the command below, paste it into Terminal, and press Enter.

Your Mac will ask for your password โ€” this is normal and keeps your computer secure. Type it in and press Enter. You won't see the letters appear as you type, but it's working.

Terminal
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
โณ This takes a few minutes. When it's done, you'll see the % symbol again. If Homebrew shows a "Next steps" section at the end, copy and paste those commands too, then press Enter after each one.
3 Install Python and ffmpeg

Copy and paste this command into Terminal and press Enter. It installs the two tools Rider Finder needs to run.

Terminal
brew install python ffmpeg
4 Download Rider Finder

Copy and paste this command into Terminal and press Enter. It downloads Rider Finder straight to your Desktop โ€” no unzipping needed.

Terminal
git clone https://github.com/Schifftacular/rider-finder.git ~/Desktop/rider-finder
โœ… When it's done, you'll see a folder called rider-finder appear on your Desktop. That's it โ€” no need to move anything.
5 Finish the installation

Copy and paste this command into Terminal and press Enter. It installs the AI that Rider Finder uses to recognise horses in your footage.

Terminal
cd ~/Desktop/rider-finder && pip3 install -r requirements.txt --break-system-packages
โœ… You're all set up! You only ever need to do steps 1โ€“5 once. The next time you use Rider Finder, skip straight to the "Run it" section below.
Every Time You Use It

Running Rider Finder

Once you're set up, this is all you need to do each time you have footage to process.

1 Open Terminal

Press โŒ˜ Command + Space, type Terminal, and press Enter.

2 Go to the Rider Finder folder

Copy and paste this command into Terminal and press Enter. This tells Terminal where to find Rider Finder.

Terminal
cd ~/Desktop/rider-finder
3 Type the command โ€” but don't press Enter yet

Click Copy below and paste it into Terminal. Make sure there is a space at the very end of the command. Don't press Enter yet โ€” you still need to add your video file.

Terminal
python extract_jump_clips.py 
4 Drag your video file onto the Terminal window

Find your video in Finder and drag it straight onto the Terminal window. The file's location will appear automatically after the command.

๐ŸŽฌ What it looks like after dragging:

python extract_jump_clips.py /Users/yourname/Movies/footage.mp4
5 Press Enter and wait

Press Enter. Rider Finder will start working through your video. You'll see progress in Terminal as it goes.

๐Ÿ“ When it's finished: Your clips will be in a folder called clips, saved in the same place as your original video. Each clip is named with the jump's start time so they stay in order.
Keeping Up to Date

Getting updates

When a new version of Rider Finder is available, getting it takes just one command.

1 Open Terminal and run this command

This downloads the latest version of Rider Finder straight to your computer, replacing only what's changed.

Terminal
cd ~/Desktop/rider-finder && git pull
๐Ÿ’ก That's it. If Terminal says Already up to date. then you already have the latest version and there's nothing to do.
Tips & Troubleshooting

Getting the best results

If something isn't quite right, these small adjustments usually fix it.

๐Ÿ”—

Clips getting merged together?

Add --gap 20 to the end of the command (after your video file) to put more space between separate jumps.

๐Ÿ”

Missing some jumps?

Add --gap 5 to make Rider Finder treat nearby jumps as separate events.

โšก

Clips cut off too early?

Add --buffer 10 to include more seconds of footage before and after each jump.

๐Ÿ“น

Supported video formats

Works with most camera and memory card formats: .mp4, .mov, .avi, .mkv, .mts, and more.