Player Piano Roll - 3D

Watch the roll scroll down over the tracker bar while the keys, bellows and hammers answer each hole.

Switch to 2D

Presets

Playback

Song on the roll

Choose the music punched into the roll.

Roll and paper

Paper speed, thickness and the take-up spool.

Pneumatic action

Vacuum, volume and orifice set how quickly a note speaks.

Sound

Actions

Camera

Quality

Layers

Model checks

The science

What a player piano does

A reproducing mechanism reads music from a roll of paper punched with holes. The roll runs over the tracker bar, a brass bar with one slot for each of the 88 keys. Where a hole passes a slot, air from the room rushes in; where the paper is solid the slot stays sealed. The air reaches a small pouch (a leather valve) that is held against a vacuum made by foot pedals or an electric pump. Letting air in flips the valve, which collapses a motor pneumatic (a small bellows) that strikes the key or the hammer. The hole position across the roll chooses the note, and the hole length along the roll chooses how long it lasts. The standard 88-note roll has 9 holes to the inch, so the hole pitch is 25.4 / 9 = 2.822 mm.

Paper transport

The take-up spool is turned at a constant angular speed omega by the drive. As paper winds on, its radius grows: the area of paper wound equals the area added to the spool, pi (r^2 - r0^2) = tp s, with paper thickness tp and wound length s. The paper speed is v = omega r, so ds/dt = omega sqrt(r0^2 + tp s / pi). This has the exact solution r(t) = r0 + tp omega t / (2 pi): the radius grows by exactly one paper thickness per revolution, and the music speeds up steadily. Real players compensate with a friction clutch or a governor; the "speed governor" slider blends from a free spindle (0 %) to a constant paper speed (100 %). The tempo lever sets the starting speed v0 in feet per minute.

Pneumatic response

Air speed through an opening follows Bernoulli: c = sqrt(2 dP / rho), with dP the vacuum (1 inch of water = 249 Pa) and rho = 1.2 kg/m3. The mass flow into the pouch volume V is limited by the smaller of the open part of the tracker hole and the bleed orifice: Q = Cd A c. Treating the air in the pouch as a single volume gives a first-order response dp/dt = (1 - p) / tau with tau = V / (Cd A c) (discharge coefficient Cd = 0.7). The hammer strikes when the vented fraction p crosses a threshold th after a delay tau ln(1 / (1 - th)). When the hole closes, the chamber relaxes back through the bleed orifice with its own time constant, and the note ends when p falls below half the threshold. At the paper speed v that delay corresponds to a hole lead v * delay: roll makers punch each hole this far early.

Why notes can be lost

A hole must stay over the slot long enough, (L + slot) / v, for the chamber to reach the threshold, and the gap before the next hole of the same note must be long enough for the chamber to fall below the release level. Short holes, a big pouch, a weak pump or a fast roll lose notes; the counter "struck / dropped" shows it.

Pitch and sound

Equal temperament sets the frequency of key n (MIDI numbers, A4 = 69) to 440 * 2^((n - 69) / 12). The optional sound is a small additive synthesiser (six slightly inharmonic partials) driven by the hammer speed, an illustration of the timbre rather than a recording of a piano.

The three checks

(1) The paper-transport integrator is run for 60 s on its own and compared with the closed-form spool radius. (2) The chamber equation is stepped numerically to the threshold and compared with the closed-form delay. (3) The zero crossings of a synthesised note are counted at 96 kHz and compared with the equal-temperament formula and the ratio 2^(1/12) between neighbouring keys.

Simplifications

The pneumatic is a single lumped volume at constant temperature; real actions have valve travel, leather stiffness, tube lengths and a separate pouch and motor stage. The hammer speed scale is illustrative, the song arrangements are simple educational transcriptions of public-domain tunes, and the paper is treated as perfectly flat and inextensible. Educational physics, not a restoration guide.

What to try
  1. Press "Sound: off" to turn the sound on, then watch the amber keys and the glowing holes: the note starts a few milliseconds after the hole reaches the slot (graph 2).
  2. Choose "Tempo drift" and run it: the paper speed in graph 1 climbs as the take-up spool fills; then choose "Governor on" and the line goes flat.
  3. Lower the pump vacuum to 4 in wc: the strike delay grows and the hammer speed falls, so the notes are late and soft.
  4. Load "Stress test: repeated tiny holes" and watch the dropped-note counter, then try "Stress test fixed" to see a smaller pouch and a wider orifice recover the notes.
  5. Play the full-range arpeggios to see the pitch rise from left to right along the tracker bar: holes further right are higher notes.
Loading Blender model...
Paper speed through the whole roll
Pneumatic response at 5, 10 and 22 in wc
Notes struck in the last 8 seconds
Hole lead needed versus paper speed
Made with 🟠 Blender · Three.js