Support
Quick answers about getting started, equipment, workouts, the player, sessions, and billing.
How do I start?🔗
The fastest path is Start Now for Free:
- Test compatibility — confirm Chrome or Edge can connect to your equipment at /web-client/compatibility-test.
- Create your account — sign up with Google or email.
- Choose a plan — start the 14-day free trial on the Subscription page.
- Set up preferences — open Settings to pick equipment type, speed units, video follow style, and overlay metrics.
- Start a workout — browse workouts, open a landing page, and click Start Race (or create your own from Create/Edit).
You can try public workout previews without an account, but sessions, custom settings, and full features require a member subscription.
Can I try YouTread before paying?🔗
Yes. Start Now for Free gives full member access for 14 days with no payment required to begin. Cancel before the trial ends and you pay nothing.
After the trial, plans are $10/month or $79.99/year. Promotion codes can be entered during Stripe checkout when available.
Anonymous visitors can also preview select workouts at Public Workouts, but those previews do not save sessions or use your personal settings.
Do I need to check compatibility first?🔗
We strongly recommend it. The compatibility test checks that your browser supports Web Bluetooth and that YouTread can connect to and command your equipment before you subscribe.
During the test you should see brief movement, beeping, or other signs that the machine responded. Reports help YouTread improve device support. Compatibility completion is remembered in your browser so the signup checklist can mark step 1 done.
Use the same browser and computer you plan to use for real workouts — typically Chrome or Edge on Windows, macOS, ChromeOS, or Android.
Do I need a subscription before workouts will run?🔗
Yes, for full member features. Workout access requires an active or trialing subscription after you create an account.
Monthly is $10 after the trial. Annual is $79.99 after the trial. Manage billing anytime on the Subscription page.
Public workout previews are available without a subscription, but they use default equipment assumptions and do not record sessions.
Which equipment works?🔗
Works directly (FTMS over Web Bluetooth): many smart treadmills, indoor bikes, ellipticals, and rowers that expose the FTMS fitness-machine profile.
Works through a bridge: many non-FTMS treadmills, walking pads, bikes, ellipticals, and rowers via the QZ Fitness app acting as a Bluetooth bridge on the same computer.
Foot speed sensors (optional on treadmills): Bluetooth running foot pods such as Stryd, Zwift RunPod, and compatible running speed/cadence sensors can be paired with Use foot speed sensor when starting a workout. Account settings let you prefer foot speed vs treadmill belt speed when both are connected.
Other sensors: heart rate, cycling power, and cadence sensors can be paired through Pair sensor when supported by your browser and device.
YouTread supports treadmill, cycling, elliptical, rowing, and custom equipment profiles in Settings. A treadmill-category workout can often be run on an elliptical or other machine if you select the matching equipment type before starting.
Sometimes my equipment does not respond or change its settings. Why?🔗
There are a few common causes:
- Fewer physical steps than the workout graph shows. On older percent-based workouts, YouTread maps timeline percentages to your equipment's detected or manual min/max range. If the workout shows ten incline transitions but your treadmill only supports six incline positions, several graph steps may map to the same machine setting. That is expected — the workout still follows the intended profile, but the machine cannot express every intermediate value.
- Natural-units workouts (GPX import or live recording). POV and route workouts with GPX or live-recorded telemetry store real speed, incline, power, or resistance values. The player maps those directly to your equipment range. Large timeline changes should usually produce visible machine changes unless the value is outside what your device supports.
- Primary or Secondary set to Manual in the player. On POV workouts, Manual means that axis is not driven by workout telemetry. Use the bias +/− buttons as a remote control for speed, incline, power, or resistance on that axis instead.
- Bluetooth or bridge lag. QZ Fitness or a distant Bluetooth adapter can add delay. Re-pair if commands stop arriving.
A quick incline check: tap the secondary bias +/− buttons in the player and watch whether the machine responds. Enable Detect device range in Settings after pairing so workout values map to your real min/max/step.
What should I configure in account Settings?🔗
Open Settings before your first serious workout. The most important choices:
- Equipment type — treadmill, cycling, elliptical, rowing, or custom FTMS mapping.
- Speed and weight units — km/h or mph; kg or lb (weight feeds the cycling power model).
- Foot speed vs belt speed (treadmill only) — when both a foot pod and smart treadmill are connected.
- Video follow — one stable rate-only engine follows speed or physics-derived cycling speed. It does not seek to correct ordinary drift.
- Pause threshold and sync tuning — when video follow pauses while you are stopped, and how aggressively the player seeks or smooths playback.
- Equipment range — auto-detect FTMS limits or enter manual primary/secondary ranges.
- Player overlay metrics — choose which live stats appear in the workout metrics panel.
- Cycling power model (bikes/ellipticals/rowers) — FTP, weights, aero/rolling presets, virtual gear, auto-shift, and physics mode for POV and route cycling.
- Private structured plans — upload .zwo / .erg interval files for cycling ERG-style workouts.
Each preference has a help tooltip on the Settings page with more detail.
What is Public Workouts preview mode?🔗
Public Workouts lets visitors try selected shared workouts without signing in. It is useful for demos and sharing a link before someone subscribes.
Included: Start Race with default equipment assumptions, route segment selection when a GPX route exists, and public cycling structured plans where offered.
Not included: session recording, your personal settings, favorites, ghost Human Sessions from your history, private structured plans, workout editing, or creator tools. The player shows a note that public mode uses defaults.
Sign up for the free trial to save sessions, customize settings, race Human Sessions, and create workouts.
How do I import a GPX file for accurate telemetry?🔗
GPX or Strava TCX import is for POV YouTube route videos and for building terrain on workouts that need a matched outdoor route. The workout category chosen at creation determines whether primary telemetry is speed (walk/run) or power (cycling and most other equipment types). Once created, that category is locked for the workout.
- Go to Create/Edit and create a new YouTube workout (or open your draft).
- Select the correct
POV_*category before clicking Create. - On the workout landing page, open the Telemetry panel.
- Choose your GPX or Strava TCX file and click Import GPX / Strava TCX.
- Review the generated speed/incline or power/resistance curves in the editor and adjust anything that needs tuning.
- Make the workout public when you are satisfied with the telemetry.
Imported routes store terrain in natural units in the workout file — incline percent on treadmills, grade mapped to resistance or power on bikes. You do not need a separate account preference to scale hills for GPX-backed workouts.
The bottom player graph and workout landing chart show both primary and secondary lines together. Each timestamp stores both values; the player maps them to your equipment profile and detected device range during playback.
If the GPX file includes timestamps, YouTread preserves that timing even when the route is longer than the video. If it does not include timestamps, YouTread spreads the route across the video duration with a 50% default speed baseline before terrain mapping.
For pure 3D route workouts without YouTube, see Route simulation workouts instead.
What are Route Run and Route Cycle simulation workouts?🔗
Route simulations are GPX-only workouts — no YouTube video. You import a route file and race it in a 3D satellite map player with incline or grade driving your equipment.
- On Create/Edit, click Create Route Simulation Workout.
- Upload your GPX, TCX, or XML route, enter a title and description, and pick Route Run Simulation or Route Cycle Simulation.
- Set a target pace (minutes per mile) that defines the workout's baseline effort.
- After creation, review telemetry on the landing page and click Start Race.
Route run simulation uses speed + grade channels. Route cycle simulation uses power + grade. A starter countdown begins the race; your live effort can drive video-free 3D progress along the route.
Route segments, ghost racers, bot racers, and session recording work the same way as other member workouts when telemetry is ready.
How do I record telemetry live for a POV video without a GPX file?🔗
Live recording is for POV YouTube workouts where you do not have a route file but still want natural speed/power and incline/resistance telemetry. You perform the workout once on real equipment while YouTread samples what you actually did.
- Create a new workout and choose a
POV_*category. - On the workout landing page, open the Telemetry panel.
- Click Record telemetry live (owner only, before telemetry exists).
- Pair your treadmill or bike. The player uses fixed 1.0× video — no effort-based video follow during recording.
- Use the primary and secondary bias +/− buttons as a remote control for speed/incline or power/resistance. Equipment mapping controls are hidden during recording.
- Click Pause recording if you need a break; resume when ready. Both video playback and telemetry sampling pause together.
- When finished, click Finish & save telemetry. Partial recordings are allowed with a confirmation.
- Review the generated telemetry in the editor before making the workout public.
Treadmills record speed + incline. Cycles record power + resistance. Use GPX import when you have a matching route file; use live recording when you want the workout to follow the effort profile you actually performed.
How do I use AI Analysis to create telemetry?🔗
AI Analysis is for coach-led videos where the instructor gives spoken cues for speed, incline, resistance, power, intervals, recoveries, or effort changes. It is designed for Coached_* categories when AI processing is enabled on the server.
- Go to Create/Edit and create a new YouTube workout.
- Select the correct coached category during creation.
- On the workout landing page, open the Telemetry panel.
- Click Initiate AI Analysis.
- Wait for the job to finish. The page shows processing status while the analysis is queued or running.
- When telemetry is attached, open the editor and review timing and values.
- Save corrections before making the workout public.
AI works best with clear spoken instructions and structured coaching. It is less accurate for music-only videos, unclear audio, or vague effort cues. Treat the result as a strong first draft.
Coach-led playback always uses fixed 1.0× video; equipment follows the generated telemetry. For POV route videos use GPX import; for full manual control use Manual Telemetry in the editor.
How do I race Human Sessions, bot racers, or my own history?🔗
Racing adds up to 10 competitors total before you start. Mix saved Human Sessions (real people) and Bot Racers (synthetic pacing targets) on supported workouts.
Human Sessions
- Open a workout landing page with ready telemetry.
- In the available sessions section, click Add to race on your sessions or shared sessions from other members.
- Pick one session for a head-to-head race or several for a group benchmark.
- Click Start Race on the workout page (your selections are remembered in the player).
- During playback, compare your progress to ghost markers on the timeline and in the Racers overlay metric.
Human ghosts follow their recorded session timing, not your live speed or playback bias. Only sessions with at least 20% completion can be raced. Partial-route sessions may not appear on the map until you reach their segment.
Bot Racers (POV and route simulation workouts)
The Bot Racers panel on the workout page adds synthetic competitors such as the original route pace (Youtube Athlete) and personality bots with tunable intensity. Bots and Human Sessions share the same 10-racer limit.
Racing is for motivation and comparison — it does not change the workout's telemetry file.
How are workout sessions saved and shared?🔗
Member workouts automatically save a Human Session when you complete at least 20% of the workout. Sessions store your real speed, power, elapsed time, and route progress — not playback-bias adjustments to the live view.
- Sessions appear under Your Sessions on the workout page and in Workout History.
- New sessions are private by default. Toggle Shared Session on a session detail page to let other members race it.
- Making a workout private also makes your shared sessions on that workout private.
- Partial-route sessions save with segment thumbnails when you used route segment selection.
Sessions are not recorded in public preview mode. Sign up for the free trial to save and share sessions.
How do I change speed, incline, or other settings during a workout?🔗
Temporary changes (today's session only)
Use the bias controls in the player panel:
- Primary bias — nudge speed (treadmill) or power (bike).
- Secondary bias — nudge incline (treadmill) or resistance (bike).
- Playback bias — nudge YouTube playback rate on POV workouts with video follow enabled (live view only; see video progress FAQ).
On POV treadmill workouts the player usually starts with Primary: Manual and Secondary: Auto. Manual means YouTread does not command that axis from workout telemetry — use bias buttons as a remote. Auto drives the axis from the workout timeline.
The Controls panel lets you change Primary, Secondary, and Video follows (Off, Auto, My speed, My power) during playback.
Permanent changes (your own copy)
- Open the workout and click Make Customized Copy.
- YouTread creates a private copy you own.
- Open the copy's landing page and click Edit Telemetry.
- Adjust speed, incline, power, resistance, playback speed, or timing in the editor.
- Save the edited copy.
If you own the original workout, you can edit its telemetry directly once it exists. If you do not own it, make a customized copy so the creator's workout stays unchanged.
How do structured cycling plans (ZWO / ERG) work?🔗
On POV Cycling and Route Cycle Simulation workouts you can attach an interval plan that drives target power while the route or video still controls grade and route progress.
- Upload private
.zwo,.erg, or.xmlplans in Settings. - On the workout landing page, choose Free Ride or pick a public or private plan before Start Race.
- Duration modes include fitting the plan to the full route, fitting a segment to the plan, looping the plan until the video ends, or truncating when the video ends.
During play the structured plan sets ERG-style power targets. Terrain from the workout timeline still commands incline/resistance or grade as usual. Public preview mode can use public library plans only.
Why doesn't the video progress the way I expect?🔗
On POV and route-style YouTube workouts, the video can react to your live effort. Most surprises come from video follow (how the player tracks you) and playback bias (a manual nudge on top).
Start with the player Controls panel
- Video follows: Off — video plays at the workout timeline speed (usually about 1.0×). Equipment still follows the workout; the video does not speed up or slow down with you.
- Video follows: Auto — default on most POV workouts. YouTread matches video to your live speed (treadmill) or power (bike). The style comes from your account Video follow setting.
- Primary: Manual on a treadmill POV workout — the belt is not driven by workout speed targets, but video can still follow your effort when video follow is on. Video stays at 1.0× until your live speed clearly differs from the workout target.
- Coach-led workouts and live telemetry recording — video always stays at 1.0×. No effort-based follow or playback bias during recording.
How following works
- The authored video-to-route alignment supplies the camera athlete's local speed.
- Your measured speed, or physics-derived cycling speed, determines the base playback rate.
- Position error makes only a small rate adjustment. It never causes a drift-correction seek.
- Off keeps fixed timeline playback while equipment controls remain independent.
When my treadmill is at max speed the video is still slow. Why?
Video follow compares your speed to the workout target at that moment, not to your treadmill's maximum. If the route is faster than you can run, playback stays below 1.0× even at max belt speed. Bias controls change the belt; playback bias changes only the picture.
If the workout is too fast today, use bias controls, make a customized copy with lower targets, or turn video follow off and watch at normal speed while equipment still follows the workout.
Can Playback Bias make the video jump backward?
No. Playback bias is a temporary visual multiplier. It does not add distance and cannot trigger a seek.
When I decrease Playback Bias the video slows or pauses. Why?
Negative bias reduces visual playback rate. Video follow also pauses when your speed stays at or below your account pause threshold while stopped or walking slowly.
My saved session shows less route progress than I remember. Why?
Saved history records real speed, elapsed time, and distance — not biased playback. Positive playback bias can make the live view look farther along the route than your actual effort. Replayed sessions show only what your recorded speed would have covered. Sessions still save normally; history is authoritative for racing and stats.
Quick checks
- Read the video status line in the Controls panel.
- Confirm Video follows is Off or Auto as intended.
- Review account Video follow style if seeks feel too frequent or catch-up feels sluggish.
- Reset playback bias to 0.00 before judging follow behavior.
What are My Favorites vs My Workouts?🔗
My Favorites — workouts you starred for quick access. Can be yours or another member's shared workout. Use favorites to bookmark workouts you repeat often without needing edit rights.
My Workouts — workouts owned by your account: ones you created, customized copies, and drafts. Use My Workouts to edit metadata, add or fix telemetry, toggle public/private, verify YouTube ownership, request terrain certification, or manage route thumbnails.
Both filters live in the category dropdown on workout list pages. List pages also support search, duration filters, sort by popular/newest, and badges such as Featured, Verified Owners, and Terrain Certified.
A workout cannot be made private if other members already have saved sessions on it — convert or communicate with your riders first.
How do I collect FTMS Bluetooth debug logs for support?🔗
Use these steps when support asks you to capture the Bluetooth FTMS commands YouTread sends to your equipment or to QZ Fitness. Include at least one primary change (usually speed or power) and one secondary change (usually incline or resistance).
- Open YouTread in Chrome or Edge on the computer or Android device you use for workouts.
- Force-refresh the page so the newest JavaScript is loaded. On Windows, press
Ctrl + F5. On macOS, pressCmd + Shift + R. - Open Developer Tools. In Chrome or Edge this is usually the
...menu, thenMore tools, thenDeveloper tools. Select theConsoletab. - Paste this command into the Console and press Enter:
localStorage.youtreadFtmsDebug = "1"; location.reload(); - After the page reloads, start the workout again. You will need to reconnect to your Bluetooth equipment.
- Run long enough to pass through a primary and a secondary setting change. If you use QZ Fitness, watch QZ while the workout runs and note whether it shows the same values.
- In the Console, look for entries beginning with
[YouTread FTMS TX]and[YouTread FTMS RX]. TX means YouTread sent a command. RX means the device or bridge responded. - Copy the relevant Console output, including connection messages and TX/RX entries around the setting changes.
- Email the log to support@youtread.com. Include the workout name, equipment model, browser, operating system, and whether you connect directly or through QZ Fitness.
- When you are done, close the browser and reopen it before your next normal workout session.
Useful entries look like this:
[YouTread FTMS TX] {opcode: "0x02", opcode_name: "setTargetSpeed", raw_hex: "0x02 0x82 0x00"}
[YouTread FTMS RX] {response_opcode: "0x80", request_opcode: "0x02", request_opcode_name: "setTargetSpeed", result_code: "0x01"}
[YouTread FTMS TX] {opcode: "0x03", opcode_name: "setTargetInclination", raw_hex: "0x03 0x00 0x00"}
[YouTread FTMS RX] {response_opcode: "0x80", request_opcode: "0x03", request_opcode_name: "setTargetInclination", result_code: "0x01"}
The most important values are opcode_name, raw_hex, request_opcode_name, and result_code. A response result of 0x01 means the FTMS device or bridge reported success for that command.
Which browsers are supported?🔗
YouTread uses Web Bluetooth, which requires a compatible browser, Bluetooth hardware, and HTTPS.
Compatible: Chrome or Edge on Windows 10/11, Chrome or Edge on macOS, Chrome on ChromeOS, and Chrome/Edge on Android.
Not compatible: iPhone and iPad browsers (including Chrome and Safari), Safari on macOS, Firefox on desktop or mobile, Internet Explorer, and browsers that do not expose Web Bluetooth.
References: MDN Web Bluetooth and Chrome Web Bluetooth.
Where do I manage billing?🔗
Use the Subscription page to start a plan, switch between monthly and annual billing, open the Stripe customer portal, or cancel. You can cancel anytime; access continues through the end of the current billing period or trial.
Account overview and shortcuts to Settings and creator tools are on the Account page.