Skip to content
altosaurusPublic

Repository files navigation

Alto

Testing Tests Coverage Ruff Pyright pre-commit enabled ASV Docs
Package License: MIT Alto release
Powered By Python Qt 6 | PySide6 NumPy FSRS 6 SQLite

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.

Alto's Circle of Fifths exercise, with the list of exercises open on the left

Make it yours

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.

Alto's settings, with a preview of each notation font

Spaced repetition

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's statistics page with accuracy, speed and volume charts

Alto's review heatmap: a year of practice, a square per day

Free and open source

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.

Built for Linux

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.

Download

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.

Get started from the source

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 alto

The first time it opens, Alto asks you to create a profile. There is no password.

Documentation

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.

Development

.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 tests

The 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.

License

MIT. The bundled fonts and recordings keep their authors' licenses; see THIRD_PARTY_NOTICES.md.