| Testing |
|
|---|---|
| Package |
|
| Powered By |
|
Music theory practice with spaced repetition.
Alto is a free desktop music theory trainer. Read notes on any clef, name intervals, chords and arpeggios, spell scales, learn key signatures, and find keys on a keyboard. Your answers determine when each question comes back for review.
Almost everything is adjustable.
- Notation in the font you like. Eleven music fonts, from the polished look of Finale Maestro, Leland and Bravura to handwritten jazz styles. Every staff in the app follows your choice.
- Light, dark or follow your desktop. The theme switches instantly.
- Practice exactly what you need. Choose the clefs (the grand staff, treble, bass, alto, tenor, soprano, mezzo-soprano or baritone), the range of notes, the key signatures, the note values from the double whole note to the thirty-second note, letter or solfège names, and whether sharps, flats and naturals appear.
- Choose the sound. Pick the instrument that plays your answers.
Choose a spaced repetition algorithm under Settings → Practice.
- ASRS and ARTS use accuracy and response time to choose the next question. If you hesitate over an interval, you may see it again sooner even when you name it correctly.
- SM-2 and FSRS give each question a review date based on your first answer each time you see it. Each exercise shows how many reviews are due and how many new cards are available that day.
Alto saves each answer in a local database under your profile. You can filter accuracy, response time, and practice volume by exercise, see a year of practice on the calendar heatmap, or browse individual answers. For a comparison, follow the same note through all four algorithms in the spaced repetition guide.
Alto is released under the MIT License. There are no accounts and no tracking. Your history is one SQLite file on your computer that you can back up, move or open with any SQLite tool. The bundled music fonts and recordings all come with their licenses, listed in THIRD_PARTY_NOTICES.md.
Linux is Alto's main platform. It is developed and tested there, follows your desktop's light or dark setting, and keeps
its files in the usual places (~/.local/share/Alto and ~/.config/alto). It is a native Qt application, not a web
page in a wrapper. There is also a Windows installer, which is built and checked automatically but has had much less testing than
the Linux version. Alto may run on macOS too, but there is no package for it and it is not tested.
Each release on the Releases page has a Linux download and a Windows installer. They carry their own Python and Qt, so nothing else needs to be installed. See Getting started for how to install, update and uninstall them.
You need Python 3.11 or newer.
git clone https://github.com/altosaurus/alto.git
cd alto
python -m venv .venv
.venv/bin/pip install -e .
.venv/bin/python -m altoThe first time it opens, Alto asks you to create a profile. There is no password.
Guides for every exercise, how the practice scheduling works, the statistics, settings and shortcuts are in
docs/ and published at https://altosaurus.github.io/alto/, with a version for each release and one for the development docs.
.venv/bin/pip install -e ".[dev]"
.venv/bin/pre-commit install # commit checks, push checks, and merged local branch cleanup
.venv/bin/pytest
.venv/bin/ruff check alto testsThe theory, exercises and learning code have no Qt dependency, so they can be tested without a display. See Resources for how the program works, and For developers for commands and recipes such as adding an exercise or a notation font.
MIT. The bundled fonts and recordings keep their authors' licenses; see THIRD_PARTY_NOTICES.md.