Customizing notation in the Soundslice embed

Here are the URL parameters that control notation display in the Soundslice embed.

Notation layout

zoom

Controls the slice’s default zoom level, e.g., zoom=50. Default zoom is 0, and allowed values are integers between -25 and 25. The bigger the number, the bigger the notation. Users can still resize notation via the player’s settings menu.

layout

Sets the layout. By default (if you don’t specify anything), we use Scrollable Vertical. Supported values are:

• layout=2 — Scrollable Horizontal
• layout=5 — Paged

rsb=1

Forces “Respect author’s stave breaks” to be checked (see Stave breaks). Without this, our player’s default behavior is to ignore stave breaks if the player has a narrow width.

hshrink=1

With hshrink=1, the player will automatically reduce notation size such that all the notation fits in the available vertical space, when in Horizontal layout. This has no effect unless notation is in Horizontal layout (see layout=2).

lo=1

Activates lyrics-only mode at time of page load. The slice must have the “Enable lyrics-only shortcut” option set.

Showing/hiding notation slice-wide

You can use URL parameters to toggle default display of bits of notation — standard notation, tablature, chords and lyrics. This first group of parameters lets you toggle all instruments at the same time.

notationless=1

Hides all notation, leaving only a full-screen video view (assuming your slice’s default recording is a video). If your slice has notation despite notationless=1, users will still be able to toggle notation view by clicking the arrow icon at the top-right of the video. If your slice has no notation, you don’t have to use notationless=1 — Soundslice will automatically use its notationless view for the slice.

See also vfs.

show_notation=0

Disables notation for the slice, even if the slice has notation. Users will not have any way of viewing notation; only the video/audio.

collapse_empty=0

Controls whether the player hides empty staves. By default, for slices that have multiple instruments, Soundslice hides staves that contain no music. Use collapse_empty=0 to disable that behavior, thereby always displaying every instrument in every stave, even if it’s empty.

show_staff=0

Controls the default display of standard notation on all instruments. Use show_staff=0 to hide all standard notation. Users can still toggle notation display in the player’s settings menu.

show_tab

Controls the default display of tablature on all instruments. Use show_tab=0 to hide all tablature; use show_tab=2 to show tablature with stems. If this parameter isn’t given, Soundslice will display tablature without stems (default behavior). Users can still toggle tab display in the player’s settings menu. Note that this parameter is unnecessary for slices that don’t have tab.

show_chords

Controls the default display of chords on all instruments. Use show_staff=0 to hide all chord names and diagrams; use show_chords=1 to show only the chord names (not diagrams). If this parameter isn’t given, Soundslice will display names and diagrams. There is intentionally no way to display diagrams without names. Users can still toggle notation display in the player’s settings menu.

show_lyrics=0

Controls the default display of lyrics on all instruments. Use show_lyrics=0 to hide all lyrics. For slices without lyrics, this has no effect. Users can still toggle lyrics display in the player’s settings menu.

show_finger=0

Controls the default display of fingering on all instruments. Use show_finger=0 to hide all fingering. For slices without fingering data, this has no effect. Users can still toggle fingering display in the player’s settings menu.

Showing/hiding notation for certain instruments

If you’d like to toggle default display for only certain instruments, use the following parameters.

Each one works exactly as the above versions, except you should substitute a zero-based instrument number for X. For example, to hide tablature for the first instrument, use show_tab_t0=0.

show_staff_tX

Controls default display of standard notation in instrument X. Same values as show_staff.

show_tab_tX

Controls default display of tablature in instrument X. Same values as show_tab.

show_chords_tX

Controls default display of chords in instrument X. Same values as show_chords.

show_lyrics_tX

Controls default display of lyrics in instrument X. Same values as show_lyrics.