Guide

How to use camillo

Choose a segment, upload a ride video, match the start and end frames, then use the leaderboard and aligned videos to compare lines.

1

Pick the segment

Use an existing segment, or create one from a reference video if it's not listed yet.

2

Upload the run

Upload ordinary POV footage from an action camera. Extra video before and after the segment helps verification.

3

Match frames

The system will help you crop and match your video start and end with the segment reference.

4

Compare

When processing finishes, open the segment leaderboard, watch the aligned video, or generate further run comparisons.

Aligned POV comparison video thumbnail

Aligned videos.

Two videos are played side by side at matching trail positions, so differences are visible even when the original runs were at different speed.

GapTime difference between the two runs at the current point.
Relative GapWhere time is gained or lost inside the segment after the start and finish are normalized.
GPS tickA verified marker when the uploaded file has camera-native GPS that passes basic duration checks.
Video explanationWatch the walkthrough

How do I use the system?

  1. Open Segments and choose the trail section you rode.
  2. Open Upload, add your video, and choose Run.
  3. Select the matching start and end frames when prompted.
  4. Submit the upload. The GPU worker aligns it and the export worker renders the aligned video.
  5. Use Home or the segment leaderboard to follow status, open the result, comment, like, flag mistakes, or compare two runs.

For clips that are interesting but should not appear on the main leaderboard, upload them as Out-takes.

How long does it take?

As a rule of thumb, it takes about 10 times the length of the video to get all the results. A 3 minute video may take about 30 minutes to align, verify, and render.

That time goes into camillo's in-house AI models and compute so the system can produce the best alignment results achievable from the footage.

You do not have to wait on the site. You can crop videos, start uploads, and set start and end frames from a computer, tablet, or phone in a few moments. Use the multi uploader to set all your different segment runs going at once.

camillo will process the runs in the background, and your Home page will show you when they are done.

What activities does camillo support?

Users have already had successful results with mountain biking, skiing, go-karting, motocross, and automobile racing.

Feel free to try your sport. camillo works best when the footage has clear forward motion through changing scenery, so the visual aligner has distinctive features to follow.

What footage works best?

A high POV that shows more of the changing scenery usually works best. A wide camera view and 30fps footage give the aligner the most useful view of the trail or track.

The best results usually come when your POV and light conditions are close to the segment reference run. That said, we are regularly surprised by how good alignments can be even when two runs look quite different.

You can upload and crop your video to the segment on camillo. Regular users often press record on their action cams about 20 seconds before they reach a regular segment, then upload the files directly from their SD card from home.

If your camera angle is very different, or the segment has changed, make a new segment. Other riders and drivers can join that reference instead of forcing unlike footage onto an old one.

What is a segment?

A segment is a named stretch of trail with a reference video and agreed start and end points. Every run on the segment is timed against that same start and end, so the leaderboard compares the same section.

A segment can have a map location, comments, likes, a reference run, out-takes, and user-submitted runs.

If you choose to create a segment, try to make the start and end points distinctive so the AI and other users can easily identify them.

What is frame matching?

Frame matching is the step where you tell camillo which frame in your video matches the segment start, and which frame matches the segment end. For new segments, you set those frames on the reference video. For existing segments, you match your run to the saved reference frames.

This gives the AI aligner a clean starting point without relying on GPS, timestamps, or a manually pressed lap button.

Why does my video need to be longer than the segment?

Extra footage before the start and after the finish helps accuracy. The system treats your start/end selection as a suggestion, widens the window, and uses visual alignment to find the authoritative segment timing.

If a video starts exactly on the segment start or cuts off exactly at the finish, there is less context to prove where the run really began and ended. That can make a result harder to verify, more likely to be flagged, or unsuitable for the leaderboard.

Best practice: include a few seconds before the start and a few seconds after the finish whenever you can.

What is an aligned video?

An aligned video is a rendered comparison. Your run appears beside the segment reference, or beside another selected run, with frames synchronized by trail position.

The export is not just two clips started at the same timestamp. It uses the visual match so that the same part of the trail is shown at the same time, even if the riders accelerated, braked, or took different lines.

How do I request more aligned videos with other videos?

Open the segment page and use the Compare column to select two runs. Click Run compare, choose the label style, then generate the comparison. If that exact comparison already exists, camillo reuses it; otherwise it queues a new aligned video.

To compare with a video that is not listed yet, upload that video to the same segment first. Once it has processed, it can be selected for comparison.

What do the things on the aligned video mean?

  • Left and right videos are the two runs being compared.
  • Names identify the current run, the segment reference, or the selected comparison run.
  • Gap (s) is the time difference at that point in the segment.
  • The optional Relative Gap (s) graph shows where time was gained or lost inside the segment after normalizing the start and finish.
  • The vertical line in the chart marks the current frame.
  • The shaded chart band is alignment uncertainty. Wider bands mean the visual match is less certain there.
  • The green gain bar highlights local gain or loss around the current point.

What do we do with GPS?

When an uploaded video contains camera GPS, camillo tries to extract the track and save a telemetry artifact for that run. GPS can help place segments on the map and mark leaderboard rows as GPS verified. GPS verified runs will not have been affected by user editing and are shown with a tick on leaderboards.

Timing still comes from video alignment. GPS is supporting evidence and location data, not the main timing system.

GPS can reveal sensitive trail locations. Use approximate location or a private segment when the exact location should not be public.

What should I do for trails where GPS location should not be known?

Do not create a public exact-location segment for a sensitive trail. Use one of these options:

  • Create the segment as private.
  • Turn on Hide exact location, which places the public map start randomly within 2km of the real start.
  • Avoid adding a pin or GPX when a public location is not appropriate.
  • Email support@camillo.ai if an existing public segment should be hidden, made approximate, or reviewed.

How do I make a private segment?

When creating a segment, tick Private segment. The segment is only visible to your logged-in account.

If you own an existing segment, open the segment, choose Edit, then tick Private segment and save. Private is different from anonymous: anonymous hides your name, while private limits who can see the segment.