# Drivetrain

> Set up tires, chainring, cassette, derailleur and idlers in syn.bike, size the chain, and read the drivetrain checks and chain warnings.

The drivetrain sets antisquat, chain growth and pedal kickback. syn.bike also sizes the chain, draws it with the derailleur through the travel, and checks the setup against the manufacturer's published limits.

## Set Up the Drivetrain

Open the **Layout** tab and expand **Drivetrain Info**.

![The Drivetrain Info section with an idler switched on](https://syn.bike/images/docs/drivetrain-info-light.png)

| Field | What it holds | Default |
|---|---|---|
| **Tire Diameter Rear:** | Rear tire outside diameter in mm, from `50` to `5000` | `750` |
| **Tire Diameter Front:** | Front tire outside diameter in mm, same range | `750` |
| **Chainring Size:** | Chainring teeth, `8` to `100` | `32` |
| **Derailleur:** | The rear derailleur model | `Shimano 12-speed SGS` |
| **Cassette:** | A cassette from the list, or `Custom` | `Shimano 12-speed 10-51` |
| **Cogs:** | The cog list of a `Custom` cassette | |
| **Active Gear:** | The cog the chain is on, see [Active Gear](#active-gear) | Largest cog |
| **Chain Links (automatic):** | Chain length in links, see [Chain Length](#chain-length) | Recommended length |
| **Uses Idler:** | Adds an idler to the upper chain run | Off |
| **Uses Lower Idler:** | Adds a guide pulley to the lower chain run | Off |

Both tire diameters change [antisquat](https://syn.bike/docs/definitions.md#antisquat) and [antirise](https://syn.bike/docs/definitions.md#antirise). The rear diameter also changes chain growth and [pedal kickback](https://syn.bike/docs/definitions.md#pedal-kickback).

### Derailleur

The derailleur sets the rule that sizes the chain, the manufacturer limits the bike is checked against, and the cage drawn in the **Bike** view. The list offers `Shimano 12-speed SGS`, `Shimano 12-speed GS`, `Shimano Saint RD-M820`, `SRAM T-Type`, `SRAM T-Type DH` and `SRAM GX DH 7-speed`.

The derailleur does not change the cassette. A mismatch shows in the **Largest cog** row of [Drivetrain Checks](#drivetrain-checks).

### Cassette

The **Cassette:** list has two groups:

- `12-speed`: Shimano 10-51, 10-45 and 9-45, SRAM Eagle 10-50, SRAM T-Type 10-52.
- `Downhill`: Shimano 10-speed DH 11-25 and 11-36, SRAM T-Type DH 10-24, SRAM PG-720 DH 11-25.

For anything else choose `Custom` and type the tooth counts into **Cogs:**, separated by commas or spaces, for example `52,36,10`. Each count is rounded to a whole number and held between 8 and 100. A single cog is allowed for a single-speed bike, and **Active Gear:** is then hidden.

### Idlers

Switch on **Uses Idler:** for a high-pivot bike, where the upper chain run passes over an idler. Two fields appear:

- **Idler Size:** in teeth, `14` by default.
- **Idler Attached To:** is the member the idler is bolted to: `Frame` or `Link 1` on any bike, `Link 2` or `Link 3` as well on a four-bar, and `Link 4` or `Link 5` on a six-bar. `Link 3` is not offered on slider linkages.

**Uses Lower Idler:** adds a guide pulley on the lower run, between the chainring and the derailleur, with its own **Lower Idler Size:** and **Lower Idler Attached To:**.

Enter each idler's position in its **Idler** or **Lower Idler** row under **Kinematic Points** in the same tab. [Creating Linkages](https://syn.bike/docs/creating-linkages.md) covers editing points.

An idler moves the chain line, so it changes antisquat, chain growth and pedal kickback.

## Chain Length

Left alone, the chain sizes itself. **Chain Links (automatic):** shows the length the derailleur maker's sizing rule recommends for the selected frame size, and updates whenever the geometry or drivetrain changes. The count is in links of 12.7 mm pitch and is always even.

If the chain cannot be routed at all, the field shows `-` and the padlock's tooltip reads **No chain length fits this bike**.

### Fix the Chain Length

1. Click the padlock beside the chain field (**Lock the chain length on every size**). The label changes to **Chain Links (fixed):**.
2. Pick a length from the list. It offers every even length from 8 links shorter to 8 links longer than the recommendation, which is marked, for example `120 - Recommended`.

The **Bike** view, the checks and the warnings now use that length.

- The lock applies to every frame size at once. A length you pick afterward changes only the selected size.
- A fixed chain no longer follows the geometry, so re-check it after moving pivots.
- Click the padlock again (**Unlock for automatically calculated chain length**) to put every size back on its recommendation.
- A chain longer than 126 links is more than one chain out of the box. The checks dialog then adds **This length needs two chains joined together.**

## The Drivetrain in the Bike View

The **Bike** view draws the chainring, cassette, chain, derailleur and cranks at the current gear. They follow the two travel sliders at the bottom of the view (rear on the left, front on the right).

The gear-shaped button at the bottom right (**Show drivetrain settings**) opens the drivetrain menu.

![The Bike view with the drivetrain menu open, showing the Display checkboxes and the Setup rows](https://syn.bike/images/docs/drivetrain-menu-light.png)

The **Display:** checkboxes are saved with your account, so they apply to every bike you open.

| Checkbox | What it draws |
|---|---|
| **Show Chain and Derailleur** | The chain and the derailleur. The sprockets are drawn either way. Turning it off also hides the chain warnings. |
| **Show Cranks** | The crank arms. |
| **Rotate with Kickback** | Turns the cranks backward by the active gear's pedal kickback as the suspension compresses. Available while **Show Cranks** is on. |
| **Show Seatpost** | The dropper post, see [Dropper Posts](https://syn.bike/docs/dropper-posts.md). |
| **Show Brake Rotors** | The brake rotors, see [Outlines](https://syn.bike/docs/outlines.md#show-and-hide-parts). |

Under **Setup:**

- **Frame Size:** picks the size drawn, when the bike has more than one.
- **Active Gear:** picks the cog.
- **Chain Links (auto):** or **Chain Links (fixed):** shows the chain in use. Change it in **Drivetrain Info**.
- **Drivetrain Checks** opens the checks dialog.
- **Dropper Travel:** raises and lowers the dropper while the seatpost is shown.

## Active Gear

The active gear is the cog the chain is drawn on and the cog antisquat, chain growth and pedal kickback are worked out for. Set it with **Active Gear:** in **Drivetrain Info** or in the drivetrain menu. The list names each cog by its teeth and starts on the largest.

The recommended chain length and the drivetrain checks do not depend on it. They cover every gear.

The active gear is a view setting. It is not saved with the bike.

## Drivetrain Checks

The **Drivetrain Checks** row in the drivetrain menu carries a status icon: a check mark when every check passes, a warning triangle when the only problems are warnings, and an error icon when a manufacturer limit is broken. Hover over it for a summary such as **Drivetrain checks: Derailleur fit failed**, or click it for the full table.

![The Drivetrain Checks dialog with one pass, two fails and one warning](https://syn.bike/images/docs/drivetrain-checks-light.png)

Each row gives the measured value, its limit, the document the limit comes from, and a verdict of `Pass`, `Warn` or `Fail` (`N/A` when the value cannot be measured). Top-out is the rear suspension at full extension, and bottom-out is the end of its travel. The rows depend on the derailleur:

| Check | What is measured | Limit |
|---|---|---|
| **Min chainstay** | Bottom bracket to rear axle at top-out | At least 420 mm for Shimano, at least 425 mm for SRAM |
| **Chain growth** | Lengthening of the loop around the chainring and the smallest cog between top-out and bottom-out | At most 54 mm for T-Type, at most 90 mm for T-Type DH. Not checked for Shimano or GX DH. |
| **Largest cog** | The biggest cog on the cassette | At most 51T for SGS and 45T for GS. At most 28T for Saint and 25T for GX DH, where up to 36T and 28T are a `Warn` instead of a `Fail`. T-Type needs exactly 52T and T-Type DH exactly 24T. |
| **Derailleur capacity** | Largest cog minus smallest cog | At most 41T for SGS, 35T for GS and 25T for Saint. Shimano only, and not shown for a single cog. |
| **T-Type chain chart** | Whether SRAM's chain length chart has an entry for this chainstay and chainring | `Inside chart` or `Outside chart`. The chart covers even chainrings from 30T to 48T and top-out chainstays from 415 mm to 505 mm. T-Type only, and not shown on a bike with an idler. |
| **Derailleur fit** | Whether the derailleur can hold the chain in use in every gear through the travel | `Chain fits`, or the worst problem and where it happens |

**Derailleur fit** is syn.bike's own check, not a manufacturer's:

- The value names the worst case, for example `Chain too short, gear 1 bottom-out` or `Chain too long, gear 12 top-out`. Gear 1 is the largest cog.
- Its source reads `syn derailleur model (estimated geometry)`. The derailleur dimensions are estimates, so a failed fit is a `Warn` and never a `Fail`.
- A recommended chain can still draw a fit warning, for example for slack on the smallest cog at top-out.

## Warnings in the Bike View

Problems with the drawn drivetrain appear at the top left of the **Bike** view under **WARNING:**, one line each.

![The Bike view at bottom-out with the warning Chain too short in the 51T and the chain drawn in red](https://syn.bike/images/docs/drivetrain-chain-too-short-light.png)

| Warning | Cause | What to change |
|---|---|---|
| **Chain too short in the 51T** | The chain is too short for the named cog somewhere in the travel. It is drawn in red where it runs out. | Pick a longer chain, or unlock the chain. |
| **Chain too long** | The cage cannot take up the slack, usually on the small cogs near top-out. | Pick a shorter chain. |
| **Upper pulley contacts cassette. Chain possibly too long.** | The derailleur's upper pulley touches the cog. | Pick a shorter chain. |
| **Invalid chain path** | The chain cannot be routed, usually because of where an idler sits or how big it is. The chain length shows `-`. | Move or resize the idler. |
| **Idler overlaps the chainring** | An idler, upper or lower, overlaps the chainring. | Move the idler away from the bottom bracket, or reduce a tooth count. |
| **Lower idler overlaps the idler** | The two idlers overlap. | Move one, or reduce a tooth count. |
| **Lower guide too close to derailleur cage** | The lower idler sits within 50 mm of a derailleur pulley. | Move the lower idler forward, toward the chainring. |
| **Invalid attachment specified for Idler** | The idler is attached to a link this linkage type does not have, for example after changing the linkage type. It is treated as frame-mounted until you fix it. The lower idler's warning ends in **Lower Idler**. | Choose a valid member in **Idler Attached To:**. |

The chain too short warning shows at every travel position and in every gear. **Chain too long** and the upper pulley warning describe only the travel position and gear on screen. The **Derailleur fit** check covers every gear and the whole travel for you.

The chain warnings, **Invalid chain path** and the lower guide warning show only while **Show Chain and Derailleur** is ticked. The others always show.

## Drivetrain in the Charts

In the **Plot** view, two curves depend on the chain: **Antisquat** under **Basic** and **Pedal Kickback** under **Wheel Properties**. [Kinematics Definitions](https://syn.bike/docs/definitions.md) explains [antisquat](https://syn.bike/docs/definitions.md#antisquat), [chain growth](https://syn.bike/docs/definitions.md#chain-growth) and [pedal kickback](https://syn.bike/docs/definitions.md#pedal-kickback).

Chain growth is not plotted. Read it in the metrics panel: **Chain Growth Total** is there by default, and **Chain Growth Active** can be added with [**Info Panel Items:**](https://syn.bike/docs/workspace.md#general-settings) in **Settings**.

Antisquat is plotted for the whole cassette. The shaded band spans every cog, the solid line is the largest cog, the thin line is the smallest cog and the dashed line is the active gear.

![An antisquat chart with a shaded band across the cassette, a solid line for the largest cog and a dashed line for the active gear](https://syn.bike/images/docs/drivetrain-antisquat-sweep-light.png)

To plot the active gear alone, right-click the chart and set **Antisquat Display** to `Active Gear` in place of `Full Sweep`. This is saved with your account.

Pedal kickback and the chain growth rows in the metrics panel follow the active gear only.
