🧪

⚠️ Alpha Status - Proof of Concept

This mod is in early alpha stage and should be considered a proof of concept. While the core pacing logic is functional and tested, the user interface and overlay system are still under active development. Expect frequent updates, breaking changes, and ongoing refinement.

Feedback & bug reports are welcome! Join our Discord community or open an issue on GitHub.

⬇️ Download Latest Release

GitHub releases • Works with Sauce4Zwift • Free & Open Source

See It In Action

Watch this demo to see the mod in action during a real Zwift TT

Requirements

⚙️ Sauce4Zwift

Version 2.0 or later. Get Sauce4Zwift

📊 TT Plan

Generated from this TT Planner and loaded via a plan code

Core Features

📊

Live Pacing Gauge

Real-time gauge showing current power vs target power with W'bal (anaerobic capacity) tracking. Visual indicators for sustainable vs unsustainable efforts.

  • Arc-style power gauge
  • W'bal balance indicator
  • Current vs target comparison
⛰️

Upcoming Interval Info

See the next interval at a glance: target power, expected gradient, distance until start, and duration. Plan your effort ahead.

  • Next interval power target
  • Distance to next segment
  • Expected gradient
🎚️

Pacing Controls

Fine-tune your effort on the fly with power bias and distance offset adjustments. Compensate for drift mid-ride.

  • Power bias adjustment (±30%)
  • Distance offset correction
  • Real-time power smoothing
📈

Performance Metrics

Monitor key stats including average power, cadence, gradient, and estimated finish time. Stay informed throughout your effort.

  • Average power tracking
  • Cadence & gradient display
  • Finish time prediction
🛠️

Plan Management

Load plans via 6-character codes, manage intervals, and reset tracking data. Seamlessly integrate with the web planner.

  • Plan code entry & loading
  • Interval tracking & stats
  • Manual refresh/reset
📺

Compact Dashboard

Multiple display layouts (field leaderboard, interval list, main gauge) that work together seamlessly. Overlay any combination you need.

  • TT Interval Dashboard (main)
  • TT Field Dashboard (rivals)
  • TT Interval List (schedule)

Advanced Features

W' Balance Tracking

Real-time W' (anaerobic capacity) balance calculation. The gauge shows your remaining anaerobic energy as a percentage, helping you avoid blowing up.

W' = anaerobic work capacity above FTP
Depletes when power > FTP
Recovers when power < FTP
Target: Stay above 0% throughout effort

Power Smoothing

Exponential moving average filter to smooth displayed power. Reduces noise from cadence variations and sensor spikes, showing true effort trend.

Available smoothing windows:
• Off (0 seconds)
• Fast (0.5 - 1 second)
• Moderate (1.5 - 3 seconds)
• Smooth (3 - 5 seconds)

Spectate Mode

When watching another rider, the mod automatically detects fan view and pauses metric updates. Useful for group events or team rides.

Multiple Dashboards

Run multiple overlays simultaneously: main gauge, field leaderboard showing rival riders, and interval schedule. Customize your Sauce layout.

Installation

  1. Download the latest release from GitHub
  2. Extract the zwiftgopher-s4z-mods folder to your Sauce mods directory:
    Windows: %APPDATA%\Sauce\mods\
    macOS: ~/Library/Application\ Support/Sauce/mods/
    Linux: ~/.config/Sauce/mods/
  3. Restart Sauce4Zwift
  4. Load the mod: Open Sauce4Zwift settings → Mods tab → Enable "TT Planner Dashboard"

How to Use

Generate a Plan

  1. Go to the TT Planner
  2. Enter your rider info and select a route
  3. Click "Generate Plan"
  4. Click "📤 Share" to get the plan code

Load in the Mod

  1. Start your Zwift event
  2. Open the TT Interval Dashboard overlay
  3. Enter the plan code in the input field
  4. Click "Load" and start riding!

Ready to Optimize Your Time Trial?

Download the mod, generate a plan, and take your TT performance to the next level.

⬇️ Download Latest Release

Questions? Join our Discord community