Skip to content

Releases

Alto 0.0.1

Choose a tag to compare

@github-actions github-actions released this 16 Nov 05:21
e25e8a9

Added

  • A new exercise, Clef Basics: a blank staff and the name of a clef. Choose the G, C or F clef symbol with three buttons, the mouse
    wheel or a right click, and put it where it makes that clef: the C clef on the second line is the mezzo-soprano clef. It can be tried
    on lines, spaces and three ledger lines each way. Its settings are Question Type, Clef Construction or Clef Identification (a clef is drawn on a staff and you press the
    button with its name), and Clefs, which chooses which clefs are asked for, including the French violin and subbass clefs. The baritone clef is accepted as the F clef on the middle line or the C clef on the top line.
  • A Clef Basics lesson, in ten short steps with small exercises: what a clef does, the G, C and F clef, the line each puts its symbol
    on, and how to tell them apart. The Clef Basics exercise has a reference pane, opened with the book button, with a table of the clefs
    and a button that opens the lesson.
  • The documentation has a version for each release and one for the development version, with a dropdown in the top bar to switch
    between them. A page of an older release says so and links to the latest.
  • The documentation home page has a Download Alto button under the first paragraph, and a download section in place of "Get started". Its
    main button names the visitor's system and goes to the right file, with the other systems listed below it.
  • The documentation has a Release notes page, made from this changelog, under About in the sidebar and linked from the home page.
  • The circle of fifths has a Colours setting with fourteen colour schemes, and a Create your own that saves schemes of your own. It
    applies to the exercise, the lessons and the reference.

Changed

  • The notation-font previews in Settings use the DSCH motif (D, E♭, C, B) in treble clef.

  • Instrument previews play the same DSCH motif as the notation-font previews.

  • Exercise and lesson icons use consistent musical glyphs and follow the theme colour.

  • In Key Signature Construction a number on the fork lights up as the mouse passes over it, the circle can be dragged along the fork, and
    the mouse wheel works over the staff and the Answer button too.

  • The documentation sidebar sorts the pages under headings that open and close, with the developer guide and the API reference as single
    rows that open their pages, long pages have an "On this page" list that follows your reading, and every page ends with links to the
    previous and next pages. The home page leaves checking a download and updating to the Getting started page, which now explains both.

  • The circle of fifths is coloured from cyan through blue to indigo by key signature, instead of every colour of the rainbow.

  • The circle of fifths opens, and redraws when its window is resized, several times faster. Lessons that show it open faster too.

Fixed

  • Instrument previews keep an even rhythm on first playback by rendering the phrase as one audio clip.
  • Changing the theme in the settings no longer sends you back to the exercises home page, or makes the window disappear and grow back
    from a dot. The window stays where it is, showing the exercise, lesson step or page you were on.

Downloads

  • Linux: alto-*-linux-x86_64.tar.gz. Unpack it and run sh install.sh install. sh install.sh uninstall removes it and keeps your data; add --purge to delete that too.
  • Windows: alto-*-windows-x64-setup.exe. Windows may say it protects your PC because the publisher is unknown, as the installer is not signed yet: choose More info, then Run anyway.
  • SHA256SUMS has the checksum of each file, and SHA256SUMS.sig is its signature. A copy of Alto that updates itself checks the signature first.

Alto 0.0.0

Choose a tag to compare

@github-actions github-actions released this 15 Nov 05:21
0e56b11

The first release.

Added

Exercises

  • Eleven exercises in four categories:
    • Notation: Note Identification, Keyboard Identification and Note Construction.
    • Intervals: Interval identification.
    • Scales and keys: Key Signature Identification, Key Signature Construction, Scale spelling, Scale Construction and the Circle of Fifths.
    • Chords: Chord quality and Arpeggio identification.
  • Seven clefs, in every exercise that has a clef setting: treble, bass, alto, tenor, soprano, mezzo-soprano and baritone.
  • Every exercise can be answered from the keyboard alone.
  • Settings for the exercises, remembered between sessions.

Learning

  • Questions you miss, or take a long time over, come back more often; ones you answer quickly and correctly fade into the background.
  • Profiles, each with its own history, kept in one local database file.
  • Lessons: a beginner lesson on the circle of fifths in eight steps, with small unscored exercises, and an Exercises | Lessons switch on the home page.
  • A book button opens an interactive circle of fifths in a pane beside the exercise.

Statistics

  • Charts of accuracy, speed and volume, filterable by exercise and timeframe.
  • A calendar heatmap of the last twelve months of practice.
  • Click a bar, point, exercise or day to see the answers behind it.
  • A database browser for everything stored.

Look and sound

  • 26 colour themes, including light, dark and following the desktop, and a form to make your own.
  • 11 notation styles (music fonts), 12 keyboard looks, and 30 transitions between the exercise and lesson cards, including none.
  • The Salamander Grand Piano as the default piano, and recordings of a marimba, vibraphone, flute, horn and viola, chosen in Settings.
    The recordings and fonts are used under their own licences, listed in THIRD_PARTY_NOTICES.md.

Your data

  • Export backup… and Import backup… in the menu. A backup is one .altobackup file holding every profile, every answer and every
    setting. Importing replaces everything, and a safety copy of what was there is saved first.

Installing and updating

  • scripts/alto-install.sh installs Alto from GitHub into its own environment, adds it to the application menu, updates it and
    removes it. Uninstalling keeps your data unless --purge is given.
  • Check for updates… in the menu: says whether a newer release is available, offers to install it with its progress shown, and
    restarts Alto when you press OK. A packaged copy (the Linux download installed with install.sh, or the Windows installer)
    downloads the release, checks its signature and checksum, and then closes, installs it and opens again. Releases are signed, and
    Alto installs nothing whose signature does not verify.
  • Settings → Updates shows the version you have, and a choice to follow the main branch instead of releases, for the latest
    changes before they are released.
  • A Linux download: a .tar.gz with its own Python and Qt, so nothing else needs installing. sh install.sh install installs it
    for you alone, with an entry in the application menu, and sh install.sh uninstall removes it and keeps your data unless
    --purge is given. Installing a newer download over it updates it.
  • A Windows installer: Alto for one user with no administrator prompt, an entry in the Start menu and in Settings → Apps, and an
    uninstaller that asks whether to also remove your practice history and settings. Running a newer installer updates it. The
    installer is not signed, so Windows may warn about an unknown publisher the first time.
  • Both downloads are built and tested on GitHub when a version is tagged, and published with checksums.
  • alto --version prints the version.
  • ALTO_HOME keeps a copy of Alto apart, with its own history and settings, and scripts/dev.sh runs a clone that way.

Documentation

  • A documentation site, a developer guide, an API reference generated from the docstrings, and ARCHITECTURE.md.

Downloads

  • Linux: alto-*-linux-x86_64.tar.gz. Unpack it and run sh install.sh install. sh install.sh uninstall removes it and keeps your data; add --purge to delete that too.
  • Windows: alto-*-windows-x64-setup.exe. Windows may say it protects your PC because the publisher is unknown, as the installer is not signed yet: choose More info, then Run anyway.
  • SHA256SUMS has the checksum of each file, and SHA256SUMS.sig is its signature. A copy of Alto that updates itself checks the signature first.