Help

This page explains the user interface and functionality of the application.

Fontsize "zoom"

The application's fontsize can be increased or decreased:

• the Zoom out button decreeases the page's fontsize.
• the Zoom in button increases the page's fontsize.

Note: The current zoom level is saved in the browser's local storage and reapplied upon every page visit.

Note: The buttons to control fontsize are hidden on small screens to preserve navigation bar layout.

Color theme

This application tries to determine your color theme preference. If you have set your operating system or browser to Dark mode, this will be the application's default setting. In the top navigation bar, the active color theme can be toggled:

• the Theme Toggle button actively switches between light and dark modes. This choice is then saved in the browser's local storage.

Home page

The Home-page shows a list of all songs currently available in this application. It shows the song's title, main artist and one or more buttons:

• the Copy button copies the URL of the song's chord sheet to the browser's clipboard.
• the Link button opens the first hyperlink as specified in the song's metadata.
• the YouTube button opens the first hyperlink to YouTube as specified in the song's metadata.

Note: The list can be filtered using the search bar on top. Only the songs of which the title or artist match the entered search query are shown.

Note: The list is sorted alphabetically upon pageload, but there are other options, too:

• the Last update button orders the list on the date of last modification (descending). This way, the most recently added/edited songs are on top.
• the Shuffle button shuffles the list to surprise the user with all the list's different content.
• the Sort A-Z button (re)sorts the list in its original, alphabetical order.

Chord sheet

The following controls are available when viewing a song's chord sheet.

The Back button returns to the Home-page.

Capo

A Capo button shows whether a song's chords are transposed down, in order to be played with a capo. This is common among guitar players to simplify the chords actually being played, without changing the song's sounding key.

For players of non-capo instuments (like bass or keyboard), a click on this button transposes all chords back to the song's sounding key.

Note: The capo button only appears on songs that were authored with the ChordPro {capo:} header directive.

Note: This app also supports manual transposing, see below.

(YouTube) links

When available for a particular song, its first (YouTube-) link is presented as a clickable button in the top right corner of the page.

Scrolling

Three buttons in the top bar allow automatic scrolling with speed control:

• the Scroll button toggles automatic scrolling. When enabled, the button reads Pause and disables the automatic scrolling when clicked.
• the Minus button decreases the automatic scroll factor.
• the Plus button increases the automatic scroll factor.

Note: In between the scroll buttons, the current scroll factor is shown. It defaults to a value of 1.0. On low-DPI devices, the user should select a factor between 0.5 and 2.0. On high-DPI screens like Apple Retina devices, a scroll factor of 5.0 or higher is not uncommon.

Once automatic scrolling is enabled, the page starts scrolling downwards at a default speed. Decreasing and increasing occurs in steps of 0.1.

Note: If the user has previously increased the scroll speed to a specific value, this value is stored locally and reused on subsequent page visits.

Note: Manual scrolling by touch(-pad), mousewheel and keyboard will scroll at normal speed in the desired direction. Then automatic scrolling is resumed at the current speed.

Note: When the screen orientation is changed (e.g. the user rotates the screen or mobile device), automatic scrolling is stopped. It can be resumed by clicking the Scroll button.

Transposing

A song's chords and sheetmusic can be transposed by semitones:

• the Down button transposes the song one semitone down. For example A becomes A♭ and F♯ becomes F.
• the Up button transposes the song one semitone up. For example A becomes A♯ and B♭ becomes B.

Note: In between the transposition buttons, the current amount of transposed semitones is shown.

Modifier preference

The user can choose which chord modifiers to prefer:

• the ♭ radio button transforms all chords to their flat-equivalent. For example A♯ becomes B♭ and C♯ becomes D♭.
• the ♯ radio button transforms all chords to their sharp-equivalent. For example A♭ becomes G♯ and B♭ becomes A♯.

Copy URL

The song's page contains a copy button, just as the Home page:

• the Copy button copies the URL of the song's chord sheet to the browser's clipboard for easy sharing via chat or e-mail.

Note: The button to copy the page's URL is hidden on small screens to preserve navigation bar layout. Please use the browser's Share-feature , instead.

Hide chords

For easy sing-along, all chords can be hidden:

• the Hide chords checkbox hides all rendered chords and shows only the song's lyrics (if any).

Note: The current preference whether chords are hidden is saved in the browser's local storage and reapplied upon every page visit.

Note: When chords are hidden, all chord related controls like transposing and modifier preference are hidden, too.