โ† Back to app

Help & FAQ

Everything you need to get the most out of temperat.io.

Quick Start

1

Open temperat.io

Works on any device with a browser โ€” phone, tablet, or desktop.

2

Allow microphone

Or connect a USB MIDI keyboard for zero-latency polyphonic input.

3

Start playing

Notes, chords, tuning, and key signatures are detected in real time.

Tools

Frequently Asked Questions

General

Audio & Microphone

MIDI Keyboard

Browser Compatibility

BrowserMicMIDIPWA
Chrome (desktop)โœ“ Fullโœ“ Fullโœ“ Full
Chrome (Android)โœ“ Fullโœ“ Fullโœ“ Full
Edgeโœ“ Fullโœ“ Fullโœ“ Full
Safari (macOS)โœ“ Fullโœ— None~ Partial
Safari (iOS)โœ“ Fullโœ— None~ Partial
Firefoxโœ“ Fullโœ— Noneโœ— None
Opera / Braveโœ“ Fullโœ“ Fullโœ“ Full

temperat.io requires a browser with Web Audio API support and HTTPS. All modern browsers meet these requirements.

Troubleshooting

Microphone not detected

  1. Make sure your device has a microphone (or plug in an external one).
  2. Check that no other app or tab is using the mic exclusively.
  3. Click the lock icon (๐Ÿ”’) in your browser's address bar โ†’ Site Settings โ†’ Microphone โ†’ Allow.
  4. On iOS: Settings โ†’ Safari โ†’ Microphone โ†’ Allow.
  5. Reload the page after granting permission.

Audio is choppy or laggy

  1. Close other audio-heavy tabs or apps (video calls, music streaming).
  2. Try Chrome or Edge โ€” they typically have the lowest Web Audio latency.
  3. On mobile, make sure your device isn't in battery saver mode (this throttles audio processing).
  4. If using Bluetooth headphones, switch to wired โ€” Bluetooth adds ~150ms latency.

MIDI keyboard not recognized

  1. Confirm you're using Chrome, Edge, or another Chromium browser (Safari and Firefox don't support Web MIDI).
  2. Plug in the MIDI keyboard before opening temperat.io, or refresh after connecting.
  3. Try a different USB port or cable.
  4. On macOS: open Audio MIDI Setup and verify the device appears there.
  5. On Windows: check Device Manager โ†’ Sound, video and game controllers.

Page won't load or shows a blank screen

  1. Enable JavaScript โ€” temperat.io requires it for audio processing.
  2. Clear your browser cache (the service worker may be stale).
  3. Try an incognito/private window to rule out extensions.
  4. Make sure you're on HTTPS โ€” microphone access requires a secure connection.

Keyboard Shortcuts

KeyPlayTunerPractice
SpaceInsert a restStart / stop listeningStart / stop listening
BackspaceUndo last noteโ€”โ€”
EscapeStop listeningStop listeningStop listening
?Toggle helpToggle helpToggle help

Music Terms Glossary

Cents (ยข)
โ€”
A unit measuring pitch deviation. 100 cents = one semitone. When tuning, aim for ยฑ5ยข or less.
A4 Reference
โ€”
The frequency that defines the pitch of all other notes. Standard concert pitch is A4 = 440 Hz.
Interval
โ€”
The distance between two notes. For example, C to E is a major third (4 semitones).
Scale
โ€”
An ordered set of notes. C major = C D E F G A B. Modes are rotations of scales (Dorian, Mixolydian, etc).
Chord
โ€”
Three or more notes played simultaneously. A C major triad = C E G.
Semitone
โ€”
The smallest interval in Western music โ€” the distance from one key to the very next key on a piano (including black keys).
Inharmonicity
โ€”
Piano strings don't vibrate perfectly โ€” their overtones are slightly sharper than pure math predicts. This is why acoustic pianos need stretch tuning.
Polyphony
โ€”
Playing multiple notes at the same time. MIDI keyboards send each note individually, making polyphonic detection very accurate. Microphone-based detection uses ML to separate overlapping pitches.

Contact & Feedback

Found a bug? Have a feature request? We'd love to hear from you.

hello@temperat.io

Or open an issue on GitHub