TimperScore – Documentation

Quick Start

Tap the Browse button in thetoolbar. Then tap ‘Invention No. 1’ to bring up the score. Tap anywhere to bring up the top bar and click the pianist icon and start playing! Watch the quick start video to see this in action. But what if your playing is not perfect? Watch this video about tracking to see how how Clavier deals with mistakes or idiosyncratic playing.


Clavier is not just a music score app but also your personal page turner. After importing your PDF score, the program spends 5 to 10 seconds per page extracting musical information to construct a model of the music. When playing with tracking, this model is matched with your playing in real-time so that your progress through the score is visually reflected. As you come to the end of a page, the next page will automatically be shown. Say goodbye to the foot pedal or having to lift your hands.

When using Clavier, most of the time will be spent in the Score mode as the user will typically be working on a particular piece of music. However, before a piece has been selected and during other administrative tasks, the app is in a home view which is indicated by the presence of a bar Home Bar at the top of the screen. As you are reading this help page, the Help mode is active as indicated by Help Button. To select a piece, tap the browse icon Browse Button to see a list of your pieces. Then, tap on any piece to load it and enter Score mode. In Score mode, the top bar disppears as we normally do not want the score to be obstructed. Tapping anywhere in the score will bring back a bar at the top. Tap the home icon Home Button to return to the home view. Now that a score has been loaded, you can always return to the most recent score by tapping Score Button. Other modes give access to managing setlists, adjusting global app settings, maintaining user recordings, mailing, printing, deleting, and other features.

Score Mode

The Score mode is easily identifiable by the presence of a score in the main area. Each page of the score is represented by a blue dot along the bottom of the score. For example, Blue Dots Indicating Pages shows that we are on page 3 of piece with 7 pages. Changing pages can be done by swiping left or right. For longer pieces, jumping directly to a page is possible by tapping on the dot corresponding to that page. A single tap brings up the top bar which can be dismissed by swiping upward. The top bar Score Bar contains the composer and the title of the current score and several action icons. Tapping the home icon returns to the home view where the Browse mode allows another piece to be loaded. The Info icon is used to edit information related to this file. The pencil icon activates the Annotation mode and the pianist icon Track is used to start real-time Tracking with Clavier actively listening to your playing). To the far right is the sound meter Sound Meter which is useful for ensuring that the gain on an external microphone is adjusted appropriately.

Importing Scores

Clavier accepts PDF files using iOS’s native file accept capability. The easiest way to import a PDF file is via email. In the Mail app, open up the email with a PDF attachment. Press and hold on the attachment box until a window pops up as shown to the right. Scroll until you see the Clavier icon with the words ‘Import with Clavier’. The file will then be copied into Clavier using the filename as the initial title. Other fields will be blank until they are filled out under Score Settings. Under Global Settings, there is a feature to automatically deskew the score. If this feature is enabled and a model has been constructed, minor rotation errors in the scanned image will be corrected in the Score view. Track

Scanning Tips

When scanning a music score or any black and white text document, a few simple tips will keep the file size under control while providing maximal clarity. Use a resolution between 300 DPI and 600 DPI. Make sure the paper is well-aligned so that the rotation is kept to a minimum. Enable deskewing if available. Choose a bounding box that leaves just enough margin to avoid any cropping. While the standard A4 target rectangle is often good, try to mostly maintain the original aspect ratio. Finally and most importantly, make sure the scan is monochromatic and not grayscale. On Epson scanning software, this mode is often called “Text”. An indication of “Black and White” can mean grayscale for certain brands as the phrase can refer to black and white photos rather than a true black and white pixel representation. For Canon scanner, choose a Color Mode of “Text Enhanced.”

Using Tracking

A key aspect of Clavier is the ability to track one’s playing by analyzing the real-time audio. By constructing a textual and musical model of the PDF file, Clavier can follow your playing and turn the page for you. When you are ready to play with tracking, tao anywhere in the score to bring up the top bar and then tap the pianist icon in the upper right. The pianist icon will change color from blue to brown. As well, a brown bar will appear to the left of the first line of music. Begin Playing! As you play, the brown bar will advance line by line. When you reach the bottom of the first page, part of the second page will be displayed on top of the first page. This allows a seamless transition as both the bottom portion of the first page and the top portion of the second page are simultaneously visible. After your playing reaches the second page, the brown bar will move back to the top and the first page will shortly disappear. This process will continue until you reach the end of the piece.

At any point, tapping on the screen will stop the tracking and the pianist icon will change back to blue. During practice, it is desirable to start tracking at an arbitrary point rather than from the start. Simply tap the line of music you intend to start on prior to tapping the pianist icon. The blue bar (inactive) will move to that line and tracking will begin at that line as reflected by that blue bar becoming brown in place. Clavier understands repeats and will turn the page back to the start of a repeated section. When entering a repeated section, the brown bar will show a 1 the first time through and later on a 2. The numeric count can become higher in more complex cases involving Da Capo or Da Segno.

Score Settings

Each PDF file is associated with additional information that is used when browsing through the scores. Tapping the Info icon from the Score view will bring up a table with editable fields. It is important to always fill out the Title and Composer field in the top section as that is necessary for reasonable disambiguation when browsing. Newly imported files will have blank or ‘Unknown’ fields while the pre-installed files have their fields already filled out. The remaining fields are useful depending on whether your collection crosses genres, for example. The composer, period, and genre fields have auto-completion to facilitate entry. The second section gives some information about the corresponding PDF file. Finally, the tracking section gives information about the model Clavier extracted by scanning the PDF file. Advanced users can modify the model by clicking Edit. See the section Modeling for more information.


When a score is displayed, the annotation feature can be activated by tapping the pencil icon in the top bar. If an Apple pencil is used, annotation mode can also be activated by tapping anywhere on the screen with the pencil. A floating palette is presented which can be dragged around via the top bar. After annotation is complete, click the Done button Done. One can zoom in or out of the page with a two finger pinch motion and pan around the page with a two finger pan or scroll motion. The palette has a mode control Draw or Edit that allows one to be in Draw or Edit mode. When drawing, a color and a drawing tool are always selected. If a line drawing tool (such as Line Stamp) and a color (such as Blue Stamp) is selected, one can begin drawing on the score and a linear mark of the selected color will appear. If a stamp (such as 3 Stamp) is selected, begin dragging on the score and the selected symbol will appear and can be moved into place. The symbol will hover above the finger and slightly to one side so that it is visible. Left-handed users can adjust the placement in the Settings mode. If the User Text button User Text Stamp is active, then a text box can be placed similar to other stamps. Once placed, the virtual keyboard will be brought up allowing custom text to be entered. Hitting enter or hiding the keyboard confirms the end of text entry. The adjacent stepper controls the active font size.

Annotations are object-based and can be individually seen and manipulated by selecting the Edit mode. A gray round background appears underneath each annotation and the score itself is dimmed slightly to make the annotations more prominent. Tapping an annotation selects it and changes its background to a light pink. A selected annotation can be moved by dragging near it. Clicing the Erase button above it will delete that annotation. When any annotation is selected, its color can be updated by clicking a different color in the palette. For line drawings, the line width can be adjusted while stamps can be replaced by other stamps. If a user text object is selected, the font size can be adjusted with the stepper. Clicking the User Text button allows the existing text to be updated. Editing an existing annotation can be faster than deleting and recreating it. For example, one can change a piano to a pianissimo mark or changing a mark from blue to an emphatic red.

The Undo button Undo in the top bar of the can undo the last drawing, moving, edit, or erase operation. The Done button exits the Annotation mode and returns to Score mode. Tap More to obtain additional operations. The Erase All menu item erases all annotations on the current page (this can also be undone). The Customize menu item switches the palette to show all available stamps and allows you to select the ones you want to have on the palette. A selected stamp has a light blue background. Once the desired stamps have been added or removed, click Done to exit customization.

Selecting a Score

A list of all scores is shown in Browse Mode when can be entered by tapping More. By default, pieces are grouped by composer and then sorted alphabetically by title. Genre and period information are displayed to the right. The view is scrollable by dragging up or down. You can jump to composers beginning with a particular letter by tapping on the blue letters to the right of the table. A single tap on any row will load that piece and transition to the Score mode. To the upper right of the table is a grouping indicator. By tapping on it, a drop-down list allows one to select alternative sorting. Note that “Show Setlists” is not an ordering and will be explained in the Setlists section.

Managing Scores

In the Manage mode, one or more scores can be selected. If the Delete Scores button is selected, the user will be prompted for confirmation before the PDF file and associated data settings are permanently deleted. Using the Export Scores button, selected scores can also me emailed, printed, copied to iCloud or Google drive, shared via AirDrop, and, in general to other apps that accept PDF files. When the number of scores to be managed is large, bulk operation with an archive is recommended. An archive is a single file that contains multiple PDF files which can be saved in a cloud drive for shared with other users or as a backup.

User Recordings

During tracking, Clavier records your playing and the Recordings mode shows each recording as an entry in the table. Reoordings are grouped by days and each entry includes time stamp information as well as the title and composer. To the right of this informtion is a play/pause button that lets you listen to the video. The slider not only indicates the current position as the recording is played but allows you to seek within the recording by dragging. User recordings may be deleted or exported as in the Manage mode.


A setlist defines a collection of pieces that are practiced or performed together. To define or manage a setlist, go to the Setlist mode by tapping More. THe top portion of the screen displays a list of score as in the Browse mode. The lower left corner lists all the Setlists that have been defined while the lower right portion gives the pieces comprising the selected Setlist. You can create a setlist by tapping the ‘+’ symbol. Tapping on the newly creately setlist will make it active and its name will show up atop the lower right table. You can add pieces to the setlist by tapping on the scores in the upper table. To delete or re-order pieces in the setlist or to rename the setlist, tap Edit and additional controls will appear. Setlists can be deleted by tapping Edit button of the lower left table. After setlists are defined, they can be chosen in the Browse mode by choosing “Show Setlists” under the sorting drop-down list. Tap on the name of the setlist itself to load the entire setlist. When a setlist is loaded into Score mode, an additional icon will show up More. Tapping on it allows quickly switching to other pieces of the setlist.

Global Settings

Settings which affect the behavior of the application across all scores reside on this page. The two most important settings are the background color and the annotation handedness. Changing the background color will significantly affect the visual experience in Score mode as well as affect the color schemes of other screens. Annotation handedness affects the position of a stamp relative to the fingertip. For a right-handed user, the hand would be to the right and below the finger tip so the stamp is placed above and to the left of the touch point. By default, the status bar is not visible as most users prefer to dedicate as much screen real estate to the score as possible. Background processing can be enabled to prepare models and audio information for imported PDF files that have not been processed. We recommend enabling this only for iPad Pro’s. The tracking bar normally is a narrow brown bar along the left side of the page. A wider bar is possible as is highlighting the entire line.

Auto-Detect (Experimental Feature)

When Auto-Detect is activated, the user can immediately start playing any piece that is in the library. Clavier will match against all pieces and try to determine which one is being played. Once a piece has been selected, it will automatically transition to the Score view and continue tracking.