All projects

Cadence

A piano editor and practice tool.

Silent recording of loading a chord example, editing a note, undoing the change, and opening sheet music.

Correcting a transcription

Cadence turns piano recordings into editable notes. The piano roll lets you correct pitch and timing, compare playback, loop a passage, and export MIDI. Sessions stay in the browser on the device where they were saved.

The public demo starts with a bundled chord recording and its transcription. It supports editing and playback. Transcribing a new recording requires the local Python backend.

Comparing a take with a reference

The practice report aligns a performance with a MIDI reference. Its dynamic program matches notes one to one and includes separate steps for missed and extra notes. Reusing one played note for several reference notes would make those counts misleading.

Before scoring timing, the alignment removes a constant recording delay and estimates the overall tempo. A consistently slower performance can therefore score well, while a local late entrance still counts as an error. Repeated passages and uneven tempo can confuse the alignment.

Where estimates need review

Audio transcription can miss quiet notes or add notes from resonance. The reference-comparison audio tracker estimates one pitch per attack, so chords can make its report unreliable. Cadence hides scores when its overlap check flags that input. The report measures pitch and timing; it does not judge musical expression.

The notation view assumes 4/4 and rounds note placement to eighth notes. It is useful for practice, but a transcription still needs checking before it becomes a score.

Run the full app

Use Python 3.12 and Node.js 22.12 or later. Clone the repository first:

git clone https://github.com/ebilesh/cadence.git
cd cadence
python3 -m venv .venv

On Windows, use python instead of python3. Activate the environment with source .venv/bin/activate on macOS or Linux, or .venv\Scripts\Activate.ps1 in Windows PowerShell. Then start the backend:

python -m pip install -r backend/requirements.txt
python -m uvicorn main:app --app-dir backend --host 127.0.0.1 --port 8000

In a second terminal, from the repository folder:

cd frontend
npm ci
npm run dev

Open http://127.0.0.1:5173. The first analysis can take longer while numerical functions compile.