Fretboard panels overview

Frettly is designed as a macOS document-based application. Rather than showing a single fretboard that resets the next time the app is opened, Frettly lets you collect many fretboards within each document.

• Remember: all fretboards within the same document use that document’s current instrument, tuning, and handedness.
• New fretboards are added to the bottom of the document. You can reorder them by dragging and dropping a fretboard before or after another, or by using the document’s “Arrange panels” dialog.
• Zoom fretboards within a document using the standard macOS ⌘+ and ⌘- shortcuts.
• If a fretboard extends off-screen horizontally, scroll it left and right with your trackpad or mouse to bring hidden sections into view.
• Clicking anywhere within a fretboard makes it the currently focused fretboard for navigation. The Up and Down arrow keys move focus while bringing the newly focused panel into view.

• Fretboard configuration

  To edit the type, root, or pattern of a fretboard, click the configuration icon to the right of the panel title to open its edit dialog.

  

• Scale chords derivation

  For fretboards with a content type of Scale, the button to the right of the configuration icon opens a dialog showing the diatonic chords in that key.

  

  For each diatonic chord, the triad notes are shown. Each chord can be previewed (using “Pattern play”), added individually to the document, or added as part of a single “Add all” action.

• Fretboard note/interval chips

  The notes in each fretboard’s scale, mode, or chord are shown as chips at the top of the panel:

  

  Each chip shows a note and its interval within the pattern, using the following notations:

  • P1 — Perfect unison (root)
  • m2 — Minor second
  • M2 — Major second
  • m3 — Minor third
  • M3 — Major third
  • P4 — Perfect fourth
  • d5 — Diminished fifth
  • A4 — Augmented fourth
  • P5 — Perfect fifth
  • A5 — Augmented fifth
  • m6 — Minor sixth
  • M6 — Major sixth
  • d7 — Diminished seventh
  • m7 — Minor seventh
  • M7 — Major seventh
  • P8 — Perfect octave
  • m9 — Minor ninth
  • M9 — Major ninth
  • m10 — Minor tenth
  • M10 — Major tenth
  • P11 — Perfect eleventh
  • A11 — Augmented eleventh
  • P12 — Perfect twelfth
  • m13 — Minor thirteenth
  • M13 — Major thirteenth

  Hovering over a chip highlights that note or interval across the fretboard:

  

  Clicking a chip toggles that note or interval between visible and hidden across the fretboard:

  

  Note: hidden notes are not played when using “Pattern play”.

• Fretboard controls - marking

  To the right of the chips is a bank of additional fretboard controls. The first group of three buttons relates to marking notes.

  

  Each note on a fretboard can be marked. Marked notes display a dashed circle around the note. Marking mode is enabled by clicking the first button (the marker pen). When enabled, it turns yellow. Once notes are marked, the button also shows the count of marked notes on that fretboard (some may be off-screen). While marking mode is enabled, clicking a note marks it — the usual play modes do not operate until marking mode is disabled. Once notes are marked, click the marker pen button again, and you are returned to standard fretboard mode, where the document's play mode will determine how the note(s) are played when clicked, and marked notes remain on screen alongside unmarked notes.

  

  The other buttons in the marking group remain disabled until at least one note is marked. The second button clears all marks, and uses a two-step confirmation: the first click arms the action (the button turns red), and the second click — while armed and within five seconds — performs the clear. Otherwise, it returns to an unarmed state.

  The third button is “View marked notes”. It is also disabled until there are marked notes. You may prefer to rely on the dashed outline alone to spot marked notes, or you can use “View marked notes” to hide unmarked notes.

  When might you want to use marked notes and view marked notes only? Perhaps when you want to break down a scale into playable positions along the fretboard, as is commonly done for such as the Pentatonic scales:

  

• Fretboard controls - notepad

  The fourth button is the notepad control. A new fretboard starts with an empty notepad, so the button appears plain. Clicking it toggles the notepad’s visibility. Once the notepad contains text, the button turns yellow to remind you that notes are present. Notepads are saved with their fretboards in the Frettly document.

  

• Fretboard controls - labelling mode

  The fifth button toggles between viewing notes and viewing intervals. By default, fretboards show note labels, and the tooltip shows the corresponding interval. When you switch to interval labels, the tooltip text changes accordingly.

  

• Fretboard controls - delete fretboard

  The sixth button is the delete control. Like “Clear marks”, it uses a two-step confirmation: the first click arms it, and the second click within five seconds deletes the fretboard, its notepad, and all marks.

• Fretboard controls - duplicate fretboard

  The seventh button duplicates the current fretboard, inserting the copy below the original. Only the fretboard’s type, root, and pattern are duplicated — notepad text and marks are not.